NAS Docker 앱 이미지 실행 배포 설정 추가

docs/deploy.md

@@ -233,6 +233,25 @@ docker compose --env-file .env.production up -d --build
 docker compose --env-file .env.production up -d
 ```
 
+### UGREEN NAS Docker 앱 Buildx 우회
+
+UGREEN NAS Docker 앱에서 `Docker Compose requires buildx plugin to be installed` 경고가 뜨면 NAS 앱이 `Dockerfile` 빌드를 직접 수행하지 못하는 상태다. 이때는 로컬에서 앱 이미지를 만든 뒤 NAS Docker 앱에 가져오고, NAS에서는 `build:`가 없는 `docker-compose.nas.yml`로 실행한다.
+
+로컬 Mac에서 NAS용 이미지를 만든다. DXP6800 Pro 같은 Intel NAS 기준은 `linux/amd64`다.
+
+```bash
+docker buildx build --platform linux/amd64 -t sori-studio:latest --load .
+docker save sori-studio:latest -o sori-studio-latest.tar
+```
+
+NAS Docker 앱에서 `sori-studio-latest.tar` 이미지를 가져온 뒤, Compose 생성 화면에는 `docker-compose.nas.yml` 내용을 사용한다. 이 파일은 앱 서비스를 `image: ${SORI_STUDIO_IMAGE:-sori-studio:latest}`로 실행하므로 NAS에서 Buildx 빌드를 시도하지 않는다.
+
+SSH를 쓸 수 있는 NAS에서는 같은 파일로 아래처럼 실행할 수 있다.
+
+```bash
+docker compose -f docker-compose.nas.yml up -d
+```
+
 코드 변경 없이 `.env.production`만 수정했다면 `--build` 없이 `up -d`만으로 충분하다.
 
 ### Google 로그인 설정