TECHNICAL RESOURCE

시놀로지 컨테이너 네트워크

컨테이너 네트워크 모드와 NAS 포트, 컨테이너 포트를 나눠 연결을 확인하는 방법입니다.

01

bridge와 host가 다른 점

Container Manager는 bridge와 host 네트워크를 안내합니다. bridge는 분리된 네트워크 영역을 사용하고 host는 NAS인 Docker 호스트와 같은 네트워크 영역을 사용합니다. 이 구분은 네트워크 영역에 관한 것입니다. NAS 마운트 폴더의 파일 접근 권한은 별도로 확인합니다. 어떤 서비스가 누구와 통신해야 하는지부터 정합니다.

설치 뒤 기본 host와 bridge가 있으며, 공식 도움말은 사용자 정의 bridge를 이용해 컨테이너 사이의 통신 대상을 관리하고 컨테이너 이름의 자동 DNS 해석을 사용하는 방식을 권장합니다. 같은 네트워크에서의 이름 해석과 NAS 외부에서 들어오는 접속 주소를 혼동하지 않습니다.

02

네트워크 생성과 컨테이너 연결

Network에서 Add로 네트워크를 만들고 Manage로 컨테이너를 연결하거나 연결에서 제외합니다. 컨테이너 생성 화면에서는 하나 이상의 bridge 네트워크 또는 Docker 호스트와 같은 네트워크를 선택할 수 있습니다. 서로 다른 모드를 조건 확인 없이 섞거나 모든 컨테이너를 한 네트워크에 넣는 것을 기본값으로 정하지 않습니다.

DSM 6.2 Docker에도 bridge와 host 구분이 있지만 현재 Container Manager의 생성 절차와 동일한 화면은 아닙니다. 서브넷 사용자 지정 지원은 24.0.2-1542/1543 릴리스에 추가된 기능으로 설명됩니다. 최신 도움말에 있다는 이유만으로 오래된 패키지에도 같은 설정 항목이 있다고 가정하지 않습니다.

03

NAS 포트와 컨테이너 포트 구분

이미지 문서나 Dockerfile에서 앱이 사용하는 컨테이너 포트를 확인합니다. NAS에서 접속을 받을 로컬 포트는 DSM의 다른 서비스가 사용하지 않는 값으로 준비합니다. 컨테이너 쪽 포트와 NAS 쪽 포트의 숫자가 반드시 같아야 한다고 생각하지 말고 실제 연결 설정을 기록합니다.

프로토콜도 함께 확인합니다. TCP로 들어오는 접속과 UDP를 쓰는 서비스는 같은 숫자만 적었다고 동일하게 동작하지 않습니다. host 모드에서는 호스트와 네트워크 영역을 공유하므로 bridge의 포트 매핑 화면을 그대로 전제하지 않고 앱의 실제 수신 포트와 충돌 여부를 확인합니다.

04

포트 변경과 기존 설정의 버전 조건

24.0.2-1535부터 포트와 일부 생성 설정 변경은 기존 컨테이너 직접 수정 대신 Duplicate한 새 구성에서 진행하는 조건입니다. 네트워크의 연결 관리 기능과 컨테이너 포트 설정의 변경 제한을 같은 항목으로 합치지 않습니다. 기존 서비스와 변경할 서비스가 사용할 포트를 먼저 대조합니다.

24.0.2-1543은 TCP/UDP 포트 설정을 가진 컨테이너 복제 문제 수정을 기록합니다. 특정 빌드의 수정 기록은 현재 접속 실패가 반드시 그 결함이라는 뜻은 아닙니다. 현재 DSM 및 패키지 빌드와 오류 상태, 바꾼 설정을 확인한 뒤 적용할 변경 범위를 정합니다.

05

내부 접속과 외부 공개를 나눠 확인

먼저 같은 내부망에서 NAS 주소와 실제 로컬 포트로 필요한 서비스가 열리는지 확인합니다. 컨테이너 실행 상태, 앱 로그와 포트 충돌, DSM 방화벽을 나눠 살펴봅니다. 내부 접속이 확인됐다는 사실만으로 인터넷 접속까지 준비된 것은 아니므로 외부 공개가 필요할 때 공유기와 접근 허용 범위를 따로 정합니다.

접속 실패를 해결하려고 DSM 방화벽을 모두 끄거나 모든 포트를 외부에 열지 않습니다. 브라우저에서 화면이 열리는지와 앱 내부 통신 또는 데이터 저장이 정상인지는 별개입니다. 같은 조건에서 변경 전후를 비교하고, 속도나 보안 격리 수준을 실제 시험 없이 수치로 보장하지 않습니다.

06

공식 자료와 적용 범위

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

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

DSM 7.4 컨테이너 네트워크

DSM 6.2 컨테이너 네트워크

DSM 7.4 컨테이너 생성과 관리

DSM 6.2 컨테이너 생성과 관리

Container Manager 공식 릴리스 기록

관련 용어와 글

TECHNICAL RESOURCES CONTACT

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

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