TECHNICAL RESOURCE

시놀로지 컨테이너 프로젝트

이미지와 컨테이너, 프로젝트의 차이부터 Compose 프로젝트를 생성하고 운영하는 순서를 설명합니다.

01

이미지와 프로젝트의 역할

Container Manager는 NAS에서 컨테이너를 만들고 실행하는 관리 패키지입니다. 이미지는 프로그램 실행에 필요한 기본 파일과 구성을 담고, 컨테이너는 그 이미지를 사용해 실행하는 개별 환경입니다. 프로젝트는 하나 이상의 컨테이너와 연결 설정을 Compose 파일로 묶어 관리합니다.

프로젝트의 docker-compose.yml은 사용할 이미지와 저장 경로, 포트, 환경변수 등을 적는 설정 파일입니다. 프로젝트를 만든다는 사실과 애플리케이션 데이터가 안전하게 보관된다는 사실은 별도입니다. 생성 전에 이미지 제공자가 요구하는 CPU 구조와 저장 경로, 포트 및 환경변수를 확인합니다.

02

DSM과 패키지 빌드 확인

Synology 안내는 DSM 7.2 이상에서 Container Manager, DSM 7.1.1 이하에서 Docker라는 패키지 이름을 사용합니다. Container Manager 20.10.23-1405는 DSM 7.2 이상을 요구하며 Project 화면의 Docker Compose 지원을 명시합니다. 구형 Docker 안내를 현재 화면과 같은 메뉴로 읽지 않습니다.

더 최신 패키지도 DSM 조건이 다릅니다. 24.0.2-1543은 DSM 7.2.1 이상, -1606은 7.3 이상, -1706은 7.4 이상을 요구합니다. 모델 전용 호환 빌드도 있으므로 NAS의 패키지 센터와 공식 지원 범위를 함께 확인합니다. 버전 번호가 더 크다고 모든 장비에 수동 설치하지 않습니다.

03

프로젝트 생성의 실제 입력 항목

Container Manager > Project에서 Create를 누르고 프로젝트 이름과 작업 폴더인 Path를 지정합니다. Source에서는 docker-compose.yml을 올리거나 편집기로 작성합니다. NAS 쪽 저장 폴더와 컨테이너 내부 경로를 구분하고, 이미 다른 서비스가 쓰는 포트와 충돌하지 않는지 확인한 뒤 요약 화면을 검토합니다.

Done으로 마법사를 끝낸 뒤 프로젝트를 바로 실행할지 선택합니다. Web Station 웹 포털은 필요한 경우에만 설정합니다. YAML에 실제 계정 비밀번호나 토큰이 있으면 해당 파일도 보호 대상입니다. 생성 화면을 공유할 때는 저장 경로의 고객명과 계정 및 비밀값을 가립니다.

04

Build와 Start 및 Stop 구분

Build는 프로젝트의 이미지를 준비하고 컨테이너를 아직 시작하지 않는 작업으로 설명됩니다. Start는 이미 준비된 컨테이너를 시작하며 먼저 Build가 필요합니다. Stop은 실행 중인 컨테이너를 중지하고 삭제하지 않으므로 다음에 다시 시작할 수 있습니다. Restart는 프로젝트의 컨테이너를 다시 시작하는 동작입니다.

Project의 Details에서 컨테이너 상태와 자원 사용, YAML Configurations를 확인합니다. 설정을 바꾸고 재배포하는 과정은 실행 중인 서비스에 영향을 줄 수 있으므로 변경 항목과 보존할 데이터를 먼저 정합니다. GUI의 Project는 20.10.23-1405에서 지원이 명시되고, CLI의 docker compose 명령 지원은 24.0.2-1542/1543에 기록돼 있습니다. 두 기능의 도입 시점을 같은 것으로 보지 않습니다.

05

Clean과 Delete 전 데이터 범위 확인

Synology Project 도움말은 Clean을 컨테이너와 네트워크, 볼륨 및 이미지가 제거되는 작업으로 설명하고 Delete는 프로젝트 컨테이너와 데이터 삭제로 설명합니다. 일반 중지만 필요할 때 이 메뉴를 Stop처럼 사용하지 않습니다. YAML과 실제 저장 위치를 확인하고 필요한 자료를 별도로 보존합니다.

Docker의 표준 compose down 문서는 기본 삭제 대상과 --volumes 또는 --rmi 옵션을 구분하고 외부로 선언한 네트워크와 볼륨은 제거하지 않는다고 설명합니다. 이 CLI 설명만으로 Synology GUI의 Clean이 실제로 어떤 옵션을 쓰는지 확정하지 않습니다. 설치 빌드의 GUI 삭제 범위를 확인하지 않은 상태에서 데이터가 남는다고 보장하지 않습니다.

06

공식 자료와 적용 범위

Synology 공식 도움말과 FAQ의 적용 조건을 기준으로 작성했습니다. 모델별 지원과 세부 빌드는 해당 제품 및 DSM 버전에서 확인해야 합니다.

내용 검토 기준일: 2026-10-28

DSM 7.4 Container Manager 개요

DSM 7.4 Container Manager 프로젝트

Container Manager 공식 릴리스 기록

Docker 공식 릴리스 기록

이미지 다운로드 문제와 DSM 적용 범위

Docker 공식 Compose down 기본 삭제 범위

관련 용어와 글

TECHNICAL RESOURCES CONTACT

확인하려는 기술 내용과 사용 환경을 알려주세요

장비와 운영 환경, 확인한 오류나 자료 내용을 알려주시면 필요한 안내와 상담 범위를 확인합니다.