Docker 볼륨을 복원하면 모든 파일의 바이트를 그대로 재현할 수 있지만, 백업 형식이나 옵션, 권한 또는 대상 경로의 제약으로 확장 속성이 누락될 수 있습니다.
확장 속성은 일반 파일 내용, 소유권, 모드 비트, 타임스탬프 외부에 저장되는 메타데이터 이름-값 쌍입니다. ACL 데이터, SELinux 레이블, Linux 기능, 애플리케이션 표시 정보 또는 Samba 메타데이터가 여기에 저장될 수 있습니다. 간단한 tar 기반 볼륨 백업은 디렉터리가 완전해 보이도록 복원할 수 있지만, 아카이브에 xattrs가 기록되지 않았거나 복원 프로세스가 보호된 네임스페이스에 쓸 수 없어 애플리케이션이 다르게 작동할 수 있습니다.
복원을 다시 시도하기 전에 소스 속성 목록 작성
대표 파일을 골라 해시, 소유자, 모드, ACL, 모든 확장 속성의 이름과 값을 기록하세요. 복원 후 애플리케이션에서 문제가 발생하는 파일도 포함하세요.
Linux xattr 모델은 user, system, security, trusted 네임스페이스를 구분하며, 각 네임스페이스는 서로 다른 접근 권한과 권한 수준을 요구합니다.
소스에 xattrs가 없다면 복원 과정에서 xattrs가 손실된 것은 아닙니다. 네임스페이스 하나만 사라진다면 아카이브의 파일 콘텐츠 계층보다는 권한, 보안 정책 또는 대상 경로의 지원 여부를 살펴보세요.
Docker 백업 명령이 실제로 아카이브한 항목 확인
백업 컨테이너에 사용된 정확한 이미지, 명령어, 작업 디렉터리, 아카이브 형식, 사용자, 마운트된 소스, 마운트된 백업 대상 경로를 기록하세요.
Docker의 볼륨 백업 예시에서는 헬퍼 컨테이너 안에서 tar를 사용합니다. 하지만 메타데이터 보존 여부는 여전히 선택한 tar 구현과 옵션에 달려 있습니다.
아카이브 파일이 성공적으로 생성되었다는 것은 디렉터리 항목과 페이로드를 읽었다는 뜻일 뿐, 모든 xattr 네임스페이스가 포함되었다는 뜻은 아닙니다. 아카이브를 생성할 때 사용한 것과 동일한 도구로 아카이브를 검사하세요.
아카이브 생성 및 압축 해제 중 확장 속성 활성화
백업 및 복원에 사용된 tar 옵션을 비교하세요. 양방향에서 xattrs가 활성화되었는지, 포함 또는 제외 패턴이 필요한 네임스페이스를 제거하지 않았는지 확인하세요.
GNU tar 문서에 따르면 --xattrs는 확장 속성을 저장하고 복원합니다.
압축 해제 시에만 옵션을 추가하면 저장되지 않은 속성은 복구할 수 없습니다. 프로덕션 백업을 변경하기 전에 테스트용 xattr이 있는 원본 파일로 작은 아카이브를 새로 만들고 검사하세요.
파일 기반 백업에 올바른 Rsync 메타데이터 옵션 사용
볼륨 백업에 Rsync를 사용하는 경우 송신자와 수신자 양쪽의 archive, ACL, xattr, numeric-ID, fake-super 및 권한 옵션을 확인하세요.
공식 Rsync 매뉴얼은 확장 속성 보존을 위한 -X를 설명하고, 권한 있는 메타데이터를 직접 적용할 수 없을 때 fake-super로 저장하는 방법도 안내합니다.
일반적인 -a 아카이브 옵션만으로 모든 ACL 및 xattr 요구 사항이 자동으로 포함되지는 않습니다. 실제 원본 및 대상 파일 시스템에서 정확한 명령을 테스트하세요.
대상 파일 시스템 및 마운트 지원 여부 확인
복원된 볼륨에 테스트용 파일을 직접 만들고 사용자 xattr 하나를 설정하고, 목록을 확인한 다음 제거해 보세요. 호스트를 통해서도, 백업 컨테이너를 통해서도 반복하세요.
호스트와 복원 컨테이너 양쪽에서 속성 목록 유틸리티를 사용해 백업 아카이브와 관계없이 대상이 xattr을 받아들이고 반환하는지 확인하세요.
xattr을 직접 생성하는 데 실패하면 파일 시스템 유형, 마운트 옵션, 네트워크 프로토콜, 볼륨 드라이버, 스토리지 어플라이언스 지원 여부를 확인하세요. 대상에서 표현할 수 없는 메타데이터는 어떤 아카이브 옵션으로도 복원할 수 없습니다.
보안 및 신뢰 네임스페이스 권한 확인
복원 컨테이너 사용자, 권한, 사용자 네임스페이스, 루트리스 모드, SELinux 정책, 볼륨 경로가 호스트에서 바인드 마운트되었는지 기록하세요.
Red Hat 문서에 따르면 파일을 복사하거나 다시 만든 후 SELinux 레이블을 정책에 맞게 복원해야 할 수 있습니다.
백업 컨테이너에 영구적으로 광범위한 호스트 권한을 부여하지 마세요. 제어된 복원 환경을 사용하거나, 먼저 일반 데이터를 복원한 뒤 지원되는 도구로 정책에 따라 관리되는 레이블을 다시 적용하세요.
ACL, 기능, 애플리케이션별 xattr을 구분하세요
POSIX ACL 항목, Linux 파일 기능, SELinux 레이블, 사용자 xattr, Samba 또는 macOS 메타데이터를 각각 따로 비교하세요. 각 항목은 서로 다른 이유로 작동하지 않을 수 있습니다.
Samba의 xattr_tdb 모듈은 기본 파일 시스템과 별도로 xattr을 저장할 수 있습니다.
따라서 파일 단위 볼륨 아카이브는 겉으로 보이는 파일 트리는 보존하지만 별도의 Samba 메타데이터 데이터베이스는 보존하지 못할 수 있습니다. 모든 관련 메타데이터 저장소를 포함하거나 애플리케이션에서 지원하는 절차를 통해 다시 구성하세요.
테스트 파일 하나를 복원하고 애플리케이션을 검증하세요
콘텐츠 해시, ACL, 사용자 xattr, 필수 애플리케이션 메타데이터가 있는 테스트용 소스 파일을 만드세요. 해당 파일을 백업한 다음 임시 볼륨에 복원하세요.
NAS 권한 및 메타데이터 변경에 관한 ZimaSpace 문서에서는 보다 광범위한 마이그레이션 동작을 다룹니다. 이 문서에서는 Docker 볼륨 백업 및 복원에 중점을 둡니다.
제어된 백업 및 복원을 한 번 더 수행한 후 콘텐츠 해시, 필수 xattr 이름과 값, ACL, 보안 레이블, 애플리케이션 동작이 모두 일치하면 문제가 해결된 것입니다.
자주 묻는 질문
확장 속성과 ACL은 같은 것인가요?
아니요. 일부 파일 시스템에서는 ACL이 시스템 xattr을 사용해 구현될 수 있지만, xattr에는 보안 레이블, 기능, 사용자 메타데이터, 애플리케이션별 값도 저장됩니다.
tar는 기본적으로 확장 속성을 보존하나요?
그렇다고 단정하지 마세요. GNU tar는 xattr을 위한 명시적 옵션을 제공하며, 압축을 풀 때 복원하려면 먼저 아카이브를 만들 때 해당 속성을 저장해야 합니다.
root로 실행해도 복원 과정에서 xattr이 손실될 수 있나요?
예. 아카이브에 포함되지 않았거나, 대상 시스템에서 지원하지 않거나, 보안 정책에 의해 거부되거나, 메타데이터가 별도의 애플리케이션 데이터베이스에 저장되어 있을 수 있습니다.
지원 및 팁
더 읽어보기

가족에게 NAS의 성인 동영상을 숨기는 방법
가족용 NAS에서 성인 동영상을 비공개로 보관하세요. 폴더 권한, Plex 및 Jellyfin 라이브러리 액세스 권한, 썸네일, 시청 기록, TV 공유 로그인 및 DLNA를 확인하세요.

Transformers에서 커뮤니티 모델을 불러오기 전에 확인할 사항
Transformers Jinja 샌드박스 업데이트를 활용해 모델의 출처, 채팅 템플릿, 원격 코드, 직렬화된 가중치, 격리된 첫 실행을 검토하세요.

Mirage를 로컬에서 실행: 한 장의 이미지로 OCR 및 객체 감지
Cactus Compute의 소형 로컬 비전 모델을 사용해 보고, 실제 입력으로 OCR 및 객체 추출을 검증하며, 메모리, 언어 및 개인정보 보호의 한계를 파악해 보세요.



