로컬(Mac/Windows)에서 개발한 Dockerfile 기반 프로젝트를
Synology NAS Docker(Container Manager)에서 실행하고 싶을 때 따라 하면 되는 전체 과정입니다.

Synology는 ZIP 파일로 빌드하는 기능을 지원하지 않기 때문에,
Dockerfile → Docker Image → NAS 업로드 → 컨테이너 실행 순서로 진행해야 합니다.

🚀 전체 과정 요약

1. 로컬에서 Dockerfile을 사용해 Docker 이미지 빌드
2. 빌드된 이미지를 .tar 로 저장
3. .tar 파일을 NAS에 업로드
4. Synology Container Manager에서 이미지 가져오기
5. 가져온 이미지로 컨테이너 생성
6. 포트/환경변수/볼륨 설정 후 실행

1️⃣ 로컬에서 Docker 이미지 빌드

cd /path/to/project
docker build -t obit-api .
docker images

2️⃣ Docker 이미지를 tar 파일로 저장

docker save -o obit-api.tar obit-api

3️⃣ NAS로 tar 파일 업로드

NAS DSM → File Station → /volume1/docker/obit-api/ 등으로 업로드

4️⃣ Container Manager에서 이미지 가져오기

이미지 → 작업 → 가져오기 → 파일에서 추가 → DSM에서 → obit-api.tar 선택

5️⃣ 새 컨테이너 생성

포트 설정 예시:

• 로컬 포트: 4000
• 컨테이너 포트: 4000

MariaDB 연결 환경변수 예시:

DB_HOST=192.168.0.4
DB_PORT=3333
DB_USER=root
DB_PASSWORD=yourpassword
DB_NAME=obit

6️⃣ 컨테이너 실행 & 테스트

http://NAS-IP:4000/health

결과:

{ "status": "ok" }

ZIP 파일이 안되는 이유

Synology는 .tar 형식의 Docker 이미지 import만 지원합니다.

🎉 정리

📌 보너스: NAS에서 직접 빌드

ssh admin@192.168.0.4
cd /volume1/docker/obit-api
sudo docker build -t obit-api .

필요하시면 HTTPS Reverse Proxy, Jenkins 자동 배포, 전체 아키텍처 구성도도 정리해드립니다.