[{"data":1,"prerenderedAt":439},["ShallowReactive",2],{"page-ko-\u002Fbuild-linux-docker":3},{"id":4,"title":5,"body":6,"description":16,"draft":431,"extension":432,"hero":433,"meta":434,"navigation":135,"path":435,"seo":436,"stem":437,"tags":433,"updatedAt":433,"__hash__":438},"content_ko\u002Fbuild-linux-docker.md","Linux용 빌드 (Docker 사용)",{"type":7,"value":8,"toc":412},"minimark",[9,13,17,22,27,43,47,52,63,67,78,82,92,96,100,155,159,227,231,234,242,246,280,284,288,320,324,339,343,368,372,383,387,408],[10,11,5],"h1",{"id":12},"linux용-빌드-docker-사용",[14,15,16],"p",{},"Windows, macOS 또는 Linux에서 Docker를 사용하여 Linux 바이너리를 빌드하는 방법",[18,19,21],"h2",{"id":20},"전제-조건","📋 전제 조건",[23,24,26],"h3",{"id":25},"모든-플랫폼-공통","모든 플랫폼 공통",[28,29,30,34,37,40],"ul",{},[31,32,33],"li",{},"Docker Desktop 또는 Docker Engine",[31,35,36],{},"pnpm (v10.2.0 이상)",[31,38,39],{},"8GB 이상의 RAM (16GB 권장)",[31,41,42],{},"20GB 이상의 여유 디스크 공간",[23,44,46],{"id":45},"플랫폼별-요구사항","플랫폼별 요구사항",[48,49,51],"h4",{"id":50},"windows","Windows",[28,53,54,57,60],{},[31,55,56],{},"Windows 10\u002F11 (64비트)",[31,58,59],{},"WSL 2 (권장)",[31,61,62],{},"PowerShell 5.1 이상",[48,64,66],{"id":65},"macos","macOS",[28,68,69,72,75],{},[31,70,71],{},"macOS 10.15 이상",[31,73,74],{},"Bash",[31,76,77],{},"Docker Desktop for Mac",[48,79,81],{"id":80},"linux","Linux",[28,83,84,87,90],{},[31,85,86],{},"64비트 Linux 배포판",[31,88,89],{},"Docker Engine 20.10 이상",[31,91,74],{},[18,93,95],{"id":94},"사용-방법","🚀 사용 방법",[23,97,99],{"id":98},"windows에서-빌드","Windows에서 빌드",[101,102,107],"pre",{"className":103,"code":104,"language":105,"meta":106,"style":106},"language-powershell shiki shiki-themes github-light github-dark","# 프로젝트 루트에서 실행\npnpm run build:tauri:linux-x64    # x86_64 Linux\npnpm run build:tauri:linux-arm64  # ARM64 Linux\n\n# 또는 스크립트를 직접 실행\npwsh .\\scripts\\build-linux-docker.ps1 -Target x64\npwsh .\\scripts\\build-linux-docker.ps1 -Target arm64\n","powershell","",[108,109,110,118,124,130,137,143,149],"code",{"__ignoreMap":106},[111,112,115],"span",{"class":113,"line":114},"line",1,[111,116,117],{},"# 프로젝트 루트에서 실행\n",[111,119,121],{"class":113,"line":120},2,[111,122,123],{},"pnpm run build:tauri:linux-x64    # x86_64 Linux\n",[111,125,127],{"class":113,"line":126},3,[111,128,129],{},"pnpm run build:tauri:linux-arm64  # ARM64 Linux\n",[111,131,133],{"class":113,"line":132},4,[111,134,136],{"emptyLinePlaceholder":135},true,"\n",[111,138,140],{"class":113,"line":139},5,[111,141,142],{},"# 또는 스크립트를 직접 실행\n",[111,144,146],{"class":113,"line":145},6,[111,147,148],{},"pwsh .\\scripts\\build-linux-docker.ps1 -Target x64\n",[111,150,152],{"class":113,"line":151},7,[111,153,154],{},"pwsh .\\scripts\\build-linux-docker.ps1 -Target arm64\n",[23,156,158],{"id":157},"macos-linux에서-빌드","macOS \u002F Linux에서 빌드",[101,160,164],{"className":161,"code":162,"language":163,"meta":106,"style":106},"language-bash shiki shiki-themes github-light github-dark","# 프로젝트 루트에서 실행\nbash scripts\u002Fbuild-linux-docker.sh x64    # x86_64 Linux\nbash scripts\u002Fbuild-linux-docker.sh arm64  # ARM64 Linux\n\n# 또는 app 디렉토리에서\npnpm run build:tauri:linux-docker-x64\npnpm run build:tauri:linux-docker-arm64\n","bash",[108,165,166,171,186,198,202,207,218],{"__ignoreMap":106},[111,167,168],{"class":113,"line":114},[111,169,117],{"class":170},"sJ8bj",[111,172,173,176,180,183],{"class":113,"line":120},[111,174,163],{"class":175},"sScJk",[111,177,179],{"class":178},"sZZnC"," scripts\u002Fbuild-linux-docker.sh",[111,181,182],{"class":178}," x64",[111,184,185],{"class":170},"    # x86_64 Linux\n",[111,187,188,190,192,195],{"class":113,"line":126},[111,189,163],{"class":175},[111,191,179],{"class":178},[111,193,194],{"class":178}," arm64",[111,196,197],{"class":170},"  # ARM64 Linux\n",[111,199,200],{"class":113,"line":132},[111,201,136],{"emptyLinePlaceholder":135},[111,203,204],{"class":113,"line":139},[111,205,206],{"class":170},"# 또는 app 디렉토리에서\n",[111,208,209,212,215],{"class":113,"line":145},[111,210,211],{"class":175},"pnpm",[111,213,214],{"class":178}," run",[111,216,217],{"class":178}," build:tauri:linux-docker-x64\n",[111,219,220,222,224],{"class":113,"line":151},[111,221,211],{"class":175},[111,223,214],{"class":178},[111,225,226],{"class":178}," build:tauri:linux-docker-arm64\n",[18,228,230],{"id":229},"빌드-결과물","📦 빌드 결과물",[14,232,233],{},"빌드 결과물은 다음 디렉토리에 생성됩니다:",[101,235,240],{"className":236,"code":238,"language":239,"meta":106},[237],"language-text","app\u002Fsrc-tauri\u002Ftarget\u002F\n  ├── x86_64-unknown-linux-gnu\u002Frelease\u002Fbundle\u002F\n  │   ├── deb\u002F           # Debian\u002FUbuntu 패키지\n  │   ├── rpm\u002F           # Red Hat\u002FFedora 패키지\n  │   └── appimage\u002F      # AppImage (배포 권장)\n  │\n  └── aarch64-unknown-linux-gnu\u002Frelease\u002Fbundle\u002F\n      ├── deb\u002F\n      ├── rpm\u002F\n      └── appimage\u002F\n","text",[108,241,238],{"__ignoreMap":106},[18,243,245],{"id":244},"️-작동-방식","⚙️ 작동 방식",[247,248,249,266,277],"ol",{},[31,250,251,254,255],{},[108,252,253],{},"Dockerfile.linux-build","에서 Docker 이미지 빌드",[28,256,257,260,263],{},[31,258,259],{},"Rust 1.83 + Debian Bookworm 기반",[31,261,262],{},"Tauri 종속성 설치 (WebKit2GTK, GTK3 등)",[31,264,265],{},"Node.js 22.x 및 pnpm 설치",[31,267,268,269],{},"Docker 컨테이너 내에서 Tauri 빌드 실행",[28,270,271,274],{},[31,272,273],{},"프로젝트 디렉토리 마운트",[31,275,276],{},"지정된 대상 아키텍처로 빌드",[31,278,279],{},"macOS 디렉토리에 결과물 출력",[18,281,283],{"id":282},"문제-해결","🔧 문제 해결",[23,285,287],{"id":286},"docker-이미지-재빌드","Docker 이미지 재빌드",[101,289,291],{"className":161,"code":290,"language":163,"meta":106,"style":106},"docker build -f Dockerfile.linux-build -t dropwebp-linux-builder --no-cache .\n",[108,292,293],{"__ignoreMap":106},[111,294,295,298,301,305,308,311,314,317],{"class":113,"line":114},[111,296,297],{"class":175},"docker",[111,299,300],{"class":178}," build",[111,302,304],{"class":303},"sj4cs"," -f",[111,306,307],{"class":178}," Dockerfile.linux-build",[111,309,310],{"class":303}," -t",[111,312,313],{"class":178}," dropwebp-linux-builder",[111,315,316],{"class":303}," --no-cache",[111,318,319],{"class":178}," .\n",[23,321,323],{"id":322},"docker-이미지-제거","Docker 이미지 제거",[101,325,327],{"className":161,"code":326,"language":163,"meta":106,"style":106},"docker rmi dropwebp-linux-builder\n",[108,328,329],{"__ignoreMap":106},[111,330,331,333,336],{"class":113,"line":114},[111,332,297],{"class":175},[111,334,335],{"class":178}," rmi",[111,337,338],{"class":178}," dropwebp-linux-builder\n",[23,340,342],{"id":341},"빌드-캐시-삭제","빌드 캐시 삭제",[101,344,346],{"className":161,"code":345,"language":163,"meta":106,"style":106},"rm -rf app\u002Fsrc-tauri\u002Ftarget\u002Fx86_64-unknown-linux-gnu\nrm -rf app\u002Fsrc-tauri\u002Ftarget\u002Faarch64-unknown-linux-gnu\n",[108,347,348,359],{"__ignoreMap":106},[111,349,350,353,356],{"class":113,"line":114},[111,351,352],{"class":175},"rm",[111,354,355],{"class":303}," -rf",[111,357,358],{"class":178}," app\u002Fsrc-tauri\u002Ftarget\u002Fx86_64-unknown-linux-gnu\n",[111,360,361,363,365],{"class":113,"line":120},[111,362,352],{"class":175},[111,364,355],{"class":303},[111,366,367],{"class":178}," app\u002Fsrc-tauri\u002Ftarget\u002Faarch64-unknown-linux-gnu\n",[18,369,371],{"id":370},"참고-사항","📝 참고 사항",[28,373,374,377,380],{},[31,375,376],{},"초기 빌드는 Docker 이미지 빌드 및 다운로드로 인해 시간이 오래 걸립니다 (20-30분)",[31,378,379],{},"이후 빌드는 Docker 이미지가 재사용되므로 빠릅니다 (10-15분)",[31,381,382],{},"ARM64 빌드는 x86_64 빌드보다 시간이 더 걸릴 수 있습니다",[18,384,386],{"id":385},"권장-배포-형식","🎯 권장 배포 형식",[28,388,389,396,402],{},[31,390,391,395],{},[392,393,394],"strong",{},"AppImage",": 배포 권장 (모든 Linux 배포판에서 작동)",[31,397,398,401],{},[392,399,400],{},".deb",": Debian\u002FUbuntu 사용자용",[31,403,404,407],{},[392,405,406],{},".rpm",": Red Hat\u002FFedora 사용자용",[409,410,411],"style",{},"html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}",{"title":106,"searchDepth":120,"depth":120,"links":413},[414,418,422,423,424,429,430],{"id":20,"depth":120,"text":21,"children":415},[416,417],{"id":25,"depth":126,"text":26},{"id":45,"depth":126,"text":46},{"id":94,"depth":120,"text":95,"children":419},[420,421],{"id":98,"depth":126,"text":99},{"id":157,"depth":126,"text":158},{"id":229,"depth":120,"text":230},{"id":244,"depth":120,"text":245},{"id":282,"depth":120,"text":283,"children":425},[426,427,428],{"id":286,"depth":126,"text":287},{"id":322,"depth":126,"text":323},{"id":341,"depth":126,"text":342},{"id":370,"depth":120,"text":371},{"id":385,"depth":120,"text":386},false,"md",null,{},"\u002Fbuild-linux-docker",{"title":5,"description":16},"build-linux-docker","VZhblYItuo0MDXeDkGya2k1WN-7A3vHjzShKEcQYbiE",1780198564309]