앱 데이터를 복사한 후 컨테이너 파일 소유자가 바뀌는 이유는 무엇인가요?

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

숫자 UID/GID가 보존되지 않거나 대상 런타임에서 이를 다시 매핑하거나 덮어쓰면 복사 후 컨테이너 파일 소유자가 바뀝니다.

홈 NAS에서는 소유권이 숫자로 저장되는 반면 각 환경은 서로 다른 계정 데이터베이스를 통해 그 숫자를 확인하므로, 같은 파일이 호스트와 컨테이너에서 서로 다른 사용자 이름으로 표시될 수 있습니다. GUI, SMB 공유, 아카이브, root 셸, 마이그레이션 도구 또는 컨테이너 진입점으로 복사할 때도 소유권이 바뀔 수 있습니다. 권한을 앱 데이터 트리 전체에 적용하기 전에 먼저 숫자 기반 ID를 진단하고, 복사 방식, 런타임 사용자 설정, 시작 스크립트, 사용자 네임스페이스, 네트워크 파일 시스템 매핑을 각각 확인하세요.

사용자 이름을 비교하기 전에 숫자 UID와 GID 비교하기

이름만 보지 말고 숫자 기반 소유권으로 원본과 대상을 검사하세요. 호스트와 컨테이너 내부에서 대표 파일 하나와 상위 디렉터리의 UID, GID, 모드, ACL, 확장 속성, 파일 시스템을 기록하세요.

Docker 바인드 마운트는 호스트 파일을 다른 사용자 데이터베이스를 사용하는 프로세스에 노출합니다. Docker 커뮤니티의 권한 관련 논의에서는 안정적인 접근에 사용자 이름만 일치시키는 것이 아니라 숫자 UID/GID를 일치시키는 것이 중요한 이유를 설명합니다.

숫자가 같고 표시되는 이름만 다르다면 소유권 자체는 변경되지 않았을 수 있습니다. 데이터를 재귀적으로 다시 쓰는 대신 문서나 계정 매핑을 수정하세요. 숫자가 다르면 증거를 보존하고 복사 및 런타임 단계로 넘어가세요.

복사 과정에서 소유권이 보존되었는지 또는 다시 설정되었는지 확인하기

정확한 복사 경로를 기록하세요. 호스트 파일 관리자, cp, rsync, tar 아카이브, SMB/NFS 클라이언트, 백업 복원, Docker 복사 명령 또는 임시 마이그레이션 컨테이너 등이 해당합니다. 방법마다 소유자, 그룹, ACL, 확장 속성에 적용되는 기본 설정이 다릅니다.

root로 실행한 복사 명령은 명시적인 아카이브 옵션을 사용하면 숫자 기반 소유권을 보존할 수 있지만, 다른 도구는 복사를 수행하는 계정의 소유자로 모든 대상 파일을 만들 수 있습니다. 최근 컨테이너 마이그레이션 문제는 대상 UID가 애플리케이션의 런타임 사용자와 다를 때 복사한 앱 데이터를 읽을 수 없게 되는 사례를 보여 줍니다.

작은 테스트 디렉터리 하나로 작업을 반복하고 애플리케이션이 시작되기 직전에 소유권을 확인하세요. 그때 이미 숫자가 잘못되어 있다면 복사 방법을 수정하거나 복원 옵션을 확인하세요. 시작 후에만 바뀐다면 복사본은 그대로 두고 컨테이너 엔트리포인트를 살펴보세요.

컨테이너 런타임 사용자와 호스트 스토리지 소유자 일치시키기

실행 중인 컨테이너 내부의 실효 사용자와 바인드 마운트된 app-data 디렉터리의 숫자 소유자를 확인하세요. Compose의 user:, 추가 그룹, 플랫폼별 PUID/PGID 변수, 이미지별 계정 설정도 확인하세요.

컨테이너를 root가 아닌 사용자로 실행해도 다른 숫자 ID가 소유한 호스트 디렉터리에 대한 접근 권한이 자동으로 부여되지는 않습니다. Docker 포럼의 한 사례에서는 디렉터리를 누구나 쓸 수 있게 만드는 대신 컨테이너 사용자와 호스트 권한을 일치시켜 이 경계 문제를 해결합니다.

애플리케이션에 안정적인 소유권 모델을 하나 정해 Compose에 문서화하세요. 공유 접근에 필요한 그룹만 추가하세요. chmod 777은 ID 불일치를 감추고 권한 분리를 약화시키며, 향후 생성되는 파일에 의도한 소유자를 유지하지 못하므로 사용하지 마세요.

시작 시 엔트리포인트가 소유권을 변경하는지 확인

많은 이미지가 잠시 root 권한으로 시작해 누락된 디렉터리를 만들고, 설정된 UID/GID를 적용한 다음, 권한을 낮추기 전에 소유권을 재귀적으로 변경합니다. 이 동작 때문에 올바르게 복사한 파일도 컨테이너를 처음 시작한 후 저절로 바뀐 것처럼 보일 수 있습니다.

컨테이너 런타임과 이미지에서도 소유권을 변경하는 마운트 동작을 제공할 수 있습니다. Podman 이슈에 따르면 :U 옵션은 소스 소유권을 다시 설정할 수 있으며, 엔트리포인트 스크립트도 애플리케이션 시작 시 비슷한 재귀적 변경을 수행할 수 있습니다.

로그를 확인할 수 있도록 컨테이너를 한 번 시작하고 작은 테스트 하위 디렉터리를 모니터링하세요. 엔트리포인트와 이미지 릴리스 노트에서 chown, 사용자 마이그레이션, PUID/PGID, 권한 수정 단계를 확인하세요. 이미지가 안정적인 대안을 지원하는 경우에만 해당 동작을 비활성화하거나 범위를 줄이세요.

rootless Docker, 사용자 네임스페이스, 네트워크 파일 시스템 고려하기

rootless Docker와 사용자 네임스페이스 재매핑은 컨테이너 ID를 다른 호스트 ID 범위로 변환합니다. NFS, CIFS, 일부 NAS 마운트 옵션은 root 권한을 별도로 제한하거나 모든 파일에 설정된 UID와 GID를 강제할 수 있습니다.

rootless Docker 권한 보고서에서 컨테이너 ID가 호스트의 하위 ID 범위에 매핑되어 파일이 예상과 다른 소유권으로 표시된다면, 진단 단서는 일반적인 복사 실패가 아니라 사용자 네임스페이스 소유권 매핑입니다.

데이터 경로가 로컬, NFS, CIFS, FUSE 또는 다른 마운트 파일 시스템인지 확인한 다음 UID/GID, root-squash, ACL 동작을 기록하세요. 호스트와 컨테이너에서 각각 소유권 생성 테스트를 수행하세요. 서버 측 ID 정책을 파악하기 전에는 네트워크 공유에 재귀적으로 chown을 실행하지 마세요.

정확한 애플리케이션 ID로 소유권 복구

애플리케이션을 중지하고 현재 메타데이터를 백업한 다음, 이미지에서 요구하는 정확한 UID, GID, 디렉터리 모드, 파일 모드, ACL, 보안 레이블을 지정하세요. 공유 미디어나 관련 없는 데이터셋은 제외하고 애플리케이션 소유 경로만 수정하세요.

올바른 소유권으로도 쓰기가 허용되지 않을 때는 권한 오류와 읽기 전용 마운트 구분하기에 관한 ZimaSpace 가이드를 다음으로 확인하세요.

컨테이너를 다시 시작하고 실제 서비스 사용자로 테스트 파일 하나를 만들고, 수정하고, 삭제하세요. 그런 다음 컨테이너를 다시 만들고 테스트를 반복하세요. 복사, 시작, 재부팅, 컨테이너 재생성 후에도 소유권이 안정적으로 유지되고, 광범위한 권한 예외 없이 애플리케이션이 읽고 쓸 수 있을 때만 복구가 완료된 것입니다.

지원 및 팁

더 읽어보기

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.