NAS 경로와 컨테이너 경로 구분
이 글의 폴더 마운트는 NAS에 있는 폴더나 파일을 컨테이너 내부의 특정 경로에서 사용하도록 연결하는 설정입니다. 같은 이름의 폴더가 보여도 NAS 경로와 컨테이너 내부 경로는 역할이 다릅니다. 애플리케이션이 어느 내부 경로에 설정이나 데이터를 쓰는지 이미지 제공자의 문서부터 확인합니다.
Docker의 bind mount는 호스트의 파일이나 디렉터리를 컨테이너로 연결하는 방식입니다. 새 이미지를 받거나 컨테이너를 복제하는 것과 NAS 폴더의 내용을 복사하는 작업을 혼동하지 않습니다. 기존 내부 폴더 위에 마운트하면 원래 파일이 가려져 보일 수 있으므로 보이지 않는다는 이유만으로 삭제됐다고 판단하지 않습니다.
permission denied가 난 경로 확인
로그에서 접근이 거부된 경로와 읽기 또는 쓰기 작업을 확인합니다. Synology의 권한 오류 안내는 DSM 7.2 이상을 적용 대상으로 합니다. Container Manager > Container에서 대상을 선택하고 Details의 Settings > Volume Settings에서 연결된 NAS 폴더와 컨테이너 경로, Read-Only 또는 Read/Write를 대조합니다.
마운트 설정에서 쓰기를 허용했다고 File Station의 실제 파일 권한까지 자동으로 허용되는 것은 아닙니다. 반대로 NAS 계정에 쓰기 권한이 있어도 컨테이너 마운트가 읽기 전용이면 그 연결을 통한 쓰기를 기대할 수 없습니다. 어느 쪽 제한인지 구분한 뒤 필요한 범위만 수정합니다.
File Station 권한과 실행 사용자 확인
File Station에서 실제 연결한 하위 폴더나 파일의 권한을 확인합니다. 컨테이너가 사용하는 계정은 이미지 설정에 따라 root 또는 다른 사용자일 수 있어 DSM에 로그인한 관리자의 권한과 같다고 가정하지 않습니다. 이미지마다 필요한 실행 사용자와 권한 조건도 다릅니다.
공식 문제 해결 문서는 마운트 유형에 맞춰 Everyone의 읽기 또는 읽기 및 쓰기 권한을 설명합니다. 동시에 보안을 위해 이 허용을 공유 폴더 전체가 아니라 연결한 하위 폴더나 파일에 한정하라고 명시합니다. 모든 NAS 폴더를 한꺼번에 Everyone 읽기 및 쓰기로 바꾸는 절차로 적용하지 않습니다.
기존 컨테이너 설정을 바꿀 때
Container Manager 24.0.2-1535부터는 생성 뒤 포트, 볼륨, 환경변수와 링크 설정을 수정할 수 없으며 Duplicate로 새 컨테이너를 만들면서 바꾸도록 릴리스가 설명합니다. 구형 Docker의 Advanced settings 화면과 같은 위치에서 모든 값을 바로 바꿀 수 있다고 안내하지 않습니다.
원본 컨테이너의 이미지와 마운트, 환경변수 및 연결 설정을 기록한 뒤 변경할 새 구성을 검토합니다. Duplicate는 설정 재사용을 돕는 기능이며 필요한 데이터까지 모두 백업됐다고 보장하는 근거로 쓰지 않습니다. 기존 폴더를 연결할 때 새 컨테이너와 원래 컨테이너가 동시에 같은 업무 데이터를 수정하지 않는지도 확인합니다.
권한 수정 뒤의 확인 범위
필요한 폴더에 대해 읽기, 파일 생성과 변경 등 실제 앱에 필요한 작업을 구분해 확인합니다. 읽기만 필요한 자료는 쓰기 마운트를 먼저 추가하지 않습니다. Docker 문서는 bind mount의 기본 쓰기 접근이 호스트 파일의 변경과 삭제에도 영향을 줄 수 있다고 설명하므로 연결 범위를 필요한 위치로 한정합니다.
권한 문제라는 이유로 Execute container using high privilege를 기본 해결책으로 켜지 않습니다. 이 옵션은 컨테이너 실행 권한과 관련되며 폴더 매핑과 앱별 실행 사용자 조건을 대신 확인해 주지 않습니다. 로그의 오류가 없어졌는지와 앱이 올바른 경로에 자료를 남기는지 각각 확인합니다.
공식 자료와 적용 범위
Synology 공식 도움말과 FAQ의 적용 조건을 기준으로 작성했습니다. 모델별 지원과 세부 빌드는 해당 제품 및 DSM 버전에서 확인해야 합니다.
내용 검토 기준일: 2026-10-28