NAS 공유용 컨테이너 사용자 및 그룹 매핑 체크리스트

Eva Wong 는 테크니컬 라이터 이자 상주 메이커 로 ZimaSpace에서 활동합니다. 평생 기술을 사랑해 온 그녀는 홈랩과 오픈 소스 소프트웨어에 열정을 품고 있으며, 복잡한 기술 개념을 누구나 이해하기 쉬운 실습 가이드로 풀어내는 데 전문성을 갖추고 있습니다. Eva는 셀프 호스팅이 어렵고 부담스러운 일이 아니라 즐거워야 한다고 믿습니다. 그녀는 튜토리얼을 통해 커뮤니티가 하드웨어 설정의 어려움을 풀어내고, 첫 NAS를 조립하는 것부터 Docker 컨테이너를 능숙하게 다루는 것까지 도전하도록 돕습니다.

안전한 접근 방식은 NAS 내보내기부터 호스트 마운트, 실행 중인 컨테이너 프로세스까지 숫자 ID 매핑을 확인하는 과정을 단일 명령이 아니라 관찰 가능한 일련의 관문으로 다루는 것입니다.

SMB 또는 NFS 기반 NAS 공유를 사용하는 Linux 컨테이너 호스트에서는 컨테이너가 NAS 마운트 경로를 볼 수는 있지만 권한 오류로 읽기 또는 쓰기에 실패할 수 있다는 실질적인 위험이 있습니다. 현재 ID와 복구 지점을 기록하고, 영향이 가장 적은 판별 방법부터 시작하세요. 다른 변수를 변경하기 전에 성공 및 실패 결과를 해석하고, 스토리지가 불안정해지거나 복구 가능한 유일한 복사본이 위험에 노출될 경우 중단하세요. 아래 절차는 기존 워크로드가 성공적으로 실행되거나 증거가 에스컬레이션 기준에 도달한 경우에만 완료됩니다.

실제 컨테이너 프로세스 ID 확인

이미지 문서, Compose의 user 설정, 환경 변수, 엔트리포인트 동작, 실행 중인 애플리케이션 프로세스의 UID, GID 및 보조 그룹을 확인하세요. PUID와 PGID라는 이름의 변수는 이미지별 관례이지 Docker의 보편적인 기능이 아니므로, 해당 이미지가 이를 지원하는지 확인하세요.

컨테이너 PUID 및 PGID 권한 문제 사례에 관한 LinuxServer 커뮤니티 사례는 PUID 및 PGID 값이 올바른 것처럼 보여도 바인드 마운트에 액세스할 수 없는 경우가 있음을 보여줍니다. 이 사례를 실행 중인 프로세스와 마운트를 확인해야 한다는 점을 상기하는 용도로 활용하세요. 모든 이미지가 동일한 초기화 로직을 구현한다는 증거로 삼지는 마세요.

컨테이너 내부와 호스트에서 id로 숫자 값을 기록하세요. 이전에 권한 문제가 발생했다는 이유만으로 애플리케이션이 루트로 실행되는 경우 중단하세요. 루트 액세스는 매핑 결함을 숨기고 서비스가 침해되었을 때 피해를 키웁니다.

NAS에서 호스트 마운트까지 소유권을 추적하세요

NAS에서 대상 디렉터리의 숫자 소유자, 그룹, 모드, ACL, 기본 ACL을 확인하세요. 컨테이너 호스트에서 마운트된 동일한 객체를 확인하고 숫자 값을 비교하세요. 이름은 다르지만 숫자가 같다면 레이블만 다를 뿐입니다. 숫자가 다르다면 권한 부여 경로가 실제로 다른 것입니다.

NFS의 경우 내보내기 옵션, NFS 버전, ID 매핑, 루트 스쿼싱, 클라이언트 마운트 ID를 포함하세요. SMB의 경우 마운트 자격 증명, 서버 측 매핑 ID, uid 또는 gid 표시 옵션, Unix 확장 기능 또는 ACL 변환 사용 여부를 포함하세요.

서버 ACL과 클라이언트 마운트 옵션을 동시에 변경하지 마세요. 숫자로 된 소유자가 확인된 테스트 파일 하나가 있고, 마운트 해제, 재마운트, 재부팅 후에도 호스트에서 안정적인 매핑이 보이면 이 단계는 통과입니다.

바인드 마운트와 추가 그룹 테스트하기

컨테이너의 소스 경로가 네트워크 공유가 마운트되기 전에 만들어진 빈 로컬 디렉터리가 아니라, 예상한 호스트 마운트인지 확인하세요. 런타임 마운트를 검사한 다음, 임시 하위 디렉터리에서 앱 사용자로 목록 표시, 읽기, 생성, 이름 변경, 삭제를 테스트하세요.

Server Fault 사례에서는 소유자와 ACL 항목이 일치하는 것처럼 보여도 NFS ACL 권한 불일치가 발생할 수 있음을 보여줍니다. 따라서 ACL 마스크, 서버 매핑, 실제 적용되는 ID를 모두 확인해야 합니다. 디렉터리와 생성된 파일 모두에서 getfacl 결과를 수집하세요.

그룹 액세스가 필요한 경우 지원되는 추가 숫자 그룹을 추가하고 컨테이너를 다시 만드세요. 프로세스 그룹은 시작 시 고정되기 때문입니다. 앱이 비어 있는 경로를 대상으로 시작한다면 ZimaSpace 가이드 컨테이너 빈 경로 진단을 참고하세요. 이는 ACL 문제가 아니라 마운트 순서 문제입니다.

가장 제한적인 ID 수정 사항을 적용하고 다시 테스트하기

앱에서 지원하는 UID, GID 또는 추가 그룹을 NAS 정책에 맞추는 방법을 우선 고려하세요. 여러 서비스가 함께 작업한다면 공유 그룹과 상속 ACL을 사용하세요. 모든 사용자에게 쓰기 권한을 부여하거나, 관련 없는 데이터셋 전체의 소유권을 재귀적으로 변경하거나, 지름길로 권한이 과도한 컨테이너를 사용하는 것은 피하세요.

컨테이너를 다시 만들고, 매핑 옵션을 변경했다면 공유를 다시 마운트한 다음 동일한 작업을 반복하세요. 마운트 순서와 숫자 ID가 부팅 후에도 유지되는지 확인하려면 호스트를 한 번 재시작하세요. 컨테이너에 불필요한 권한을 부여하지 않고도 새로 만든 파일을 의도된 사용자 클라이언트가 계속 쓸 수 있는지 확인하세요.

앱이 기존 워크로드를 통과하고, 거부된 작업은 계속 거부되며, 재시작 후에도 소유권이 안정적으로 유지되면 체크리스트를 완료하세요. 사용자 네임스페이스, 루트리스 매핑 또는 NAS ID 서비스가 ID를 다시 매핑해 선택한 이미지에서 지원할 수 없는 경우에는 에스컬레이션하세요.

지원 및 팁

더 읽어보기

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.