· Colinch NAS · 5 min read

Synology NAS Docker 설치 — Container Manager로 컨테이너 운영하기

Synology DSM 7.2 기준 Container Manager(구 Docker) 설치 방법과 기본 컨테이너 운영 방법을 정리했다. docker-compose 파일로 서비스를 올리는 방법까지 포함.

Synology NAS Docker 컨테이너 운영

Synology NAS에서 Docker를 쓸 수 있다는 게 처음엔 반신반의했다. NAS 박스에서 Nextcloud, Jellyfin, Vaultwarden을 돌린다는 게 가능한가 싶었는데 실제로 잘 된다. DSM 7.2부터는 Docker 앱 이름이 “Container Manager”로 바뀌었다. 설치와 기본 사용법을 정리한다.

환경 정보

항목내용
NAS 모델Synology DS923+
DSM 버전DSM 7.2.2
Container Managerv20.10.x (DSM 패키지 버전)
지원 모델x86_64 아키텍처 NAS (ARM 기반 일부 모델은 미지원)

ARM 기반 NAS(J 시리즈 일부 등)는 Container Manager를 지원하지 않는다. DSM → 패키지 센터에서 Container Manager가 검색되면 지원 모델이다.

Container Manager 설치

DSM → 패키지 센터 → 검색: Container Manager → 설치

설치 완료 후 메인 메뉴에 Container Manager 아이콘이 생긴다.

Docker Hub 이미지를 직접 받거나, docker-compose 파일로 스택을 올릴 수 있다.

기본 개념 — Container Manager UI 구성

  • 컨테이너: 실행 중인 인스턴스. 시작·중지·삭제 가능.
  • 이미지: 컨테이너를 만들기 위한 베이스. Docker Hub에서 다운로드.
  • 레지스트리: Docker Hub 등 이미지 저장소 연결.
  • 프로젝트: docker-compose.yml 기반으로 여러 컨테이너를 묶어 관리.

UI에서 할 수 있지만, 복잡한 설정은 SSH에서 명령어로 직접 하는 게 편하다.

SSH로 Docker 사용하기

Container Manager보다 더 유연하게 쓰려면 SSH를 활성화하고 직접 명령어를 쓴다.

제어판 → 터미널 및 SNMP → SSH 서비스 활성화

# SSH 접속 후 docker 버전 확인
docker --version

# 이미지 검색
docker search nginx

# 이미지 다운로드
docker pull nginx:latest

# 컨테이너 실행
docker run -d -p 8080:80 --name my-nginx nginx

# 실행 중인 컨테이너 확인
docker ps

# 컨테이너 중지
docker stop my-nginx

# 컨테이너 삭제
docker rm my-nginx

docker-compose로 서비스 올리기

단일 컨테이너로 끝나는 서비스는 드물다. 대부분 DB + 앱 + 프록시 조합으로 여러 컨테이너가 함께 실행된다. docker-compose를 쓰면 한 파일로 이 구성을 관리할 수 있다.

예시: Portainer(컨테이너 관리 웹 UI) 설치

# /volume1/docker/portainer/docker-compose.yml
version: '3'
services:
  portainer:
    image: portainer/portainer-ce:latest
    container_name: portainer
    restart: unless-stopped
    ports:
      - "9000:9000"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /volume1/docker/portainer/data:/data
# 파일 위치로 이동 후 실행
cd /volume1/docker/portainer
docker-compose up -d

# 상태 확인
docker-compose ps

# 로그 확인
docker-compose logs -f

http://[NAS IP]:9000으로 접속하면 Portainer 관리 화면이 나온다. Container Manager UI보다 더 상세한 컨테이너 관리가 가능하다.

볼륨 경로 — 이게 중요하다

Synology NAS의 메인 스토리지는 /volume1/이다. 컨테이너에서 데이터를 영구적으로 보관하려면 호스트 경로를 /volume1/ 아래로 마운트해야 한다.

volumes:
  - /volume1/docker/[서비스명]/data:/[컨테이너 내 경로]

컨테이너가 삭제되어도 /volume1/docker/ 아래의 데이터는 남아 있다. 이 경로를 백업 대상에도 포함시켜야 한다.

삽질했던 부분

메모리가 적은 NAS(RAM 4GB 이하)에서 컨테이너를 너무 많이 띄우면 DSM 자체가 느려진다. 처음엔 욕심 부려서 5~6개를 동시에 실행했다가 NAS가 버벅였다. 실제로 필요한 것만 상시 실행하고, 가끔 쓰는 건 필요할 때만 켜는 식으로 운영한다.

컨테이너 시간대(timezone) 설정을 안 하면 로그 시간이 UTC로 찍혀서 나중에 헷갈린다. 환경 변수에 TZ: Asia/Seoul을 꼭 넣는다.

environment:
  - TZ=Asia/Seoul

한 줄 정리

Container Manager 설치하고 /volume1/docker/ 아래에 서비스별 폴더 만들어서 docker-compose로 관리하면 된다.


다음엔 Jellyfin을 NAS에 설치해서 집에서 넷플릭스처럼 영상 스트리밍하는 방법을 다룬다.

참고 링크

Share:
Back to Blog