Zimbra CE에서 개별 사서함을 백업하고 복원하는 방법

Zimbra 오픈 소스 에디션(CE/FOSS)의 경우, 개별 사서함을 zmmailbox메타데이터와 함께 ZIP 아카이브로 내보낸 다음, 해당 아카이브를 임시 사서함으로 가져와서 실제 계정에 복원하기 전에 유효성을 검사하십시오. 이렇게 하면 사서함별 콘텐츠를 내보내고 복구하는 실용적인 경로를 제공합니다. 이는 특정 시점의 서버 백업과는 다릅니다. Zimbra의 내장 워크 zmbackup플로 zmrestore는 네트워크 에디션 기능으로 문서화되어 있으며, 사서함 내보내기는 LDAP, 서버 구성, 인증서 또는 전체 Zimbra 설치를 백업하지 않습니다.

아래 명령어는 Zimbra에서 제공하는 명령줄 및 REST 내보내기 설명서를 따릅니다. Zimbra 서버에서 zimbra운영 체제 사용자 권한으로 명령어를 실행하고, 실제 사서함 및 백업 경로를 입력하며, 사용 중인 Zimbra 빌드 버전에 맞춰 테스트하십시오. 공식 관리 가이드에서는 ZIP과 TGZ 파일 형식을 구분합니다. 사서함 전체를 내보내려면 ZIP 파일 형식을 사용하고, meta=1TGZ 파일의 기본 내용에는 캘린더와 작업이 제외됩니다.

이 방법이 뒷받침하는 바는 무엇일까요?

zmmailbox선택한 사서함 하나에 대해 Zimbra의 REST 내보내기/가져오기 기능을 호출합니다. ZIP 메타데이터가 활성화된 경우, 아카이브에는 설치된 릴리스에서 지원하는 메일, 폴더, 연락처, 캘린더, 작업 및 기타 사서함 항목이 포함될 수 있습니다. 규정 준수 또는 마이그레이션을 위해 이 기능을 사용하기 전에 해당 Zimbra 관리자 가이드에서 지원 범위 표와 옵션을 확인하십시오.

서버 전체 재해 복구가 목표라면, 메일함 내보내기와 함께 별도로 테스트를 거친 버전별 전체 서버 및 LDAP 백업 계획을 수립해야 합니다. ZIP 파일만으로는 Zimbra 서버를 복구할 수 없습니다.

시작하기 전에

• 설치 및 버전을 확인하려면 다음 명령어를 사용하십시오 zmcontrol -v. 백업 도구를 선택하기 전에 서버가 커뮤니티/FOSS 빌드를 사용하는지 또는 라이선스가 부여된 네트워크 에디션 빌드를 사용하는지 확인하십시오.
• 정확한 사서함 주소를 확인하고 크기를 점검하십시오. gms아래 명령어를 실행하면 사서함 크기가 표시됩니다. 보관용 파일과 백업 파일을 저장할 수 있도록 충분한 공간을 확보하십시오.
• 권한이 제한된 백업 디렉터리를 선택하십시오. 메일 서버의 디스크 오류로 인해 두 백업 사본이 모두 손실되는 것을 방지하기 위해 별도의 파일 시스템이나 백업 호스트를 사용하는 것이 좋습니다.
• 대용량 또는 사용량이 많은 사서함의 경우 활동이 적은 시간대에 내보내기를 예약하세요. 시간 초과 옵션은 일반적인 명령 시간 초과를 적용하지 않도록 -t 0지정하는 것이며 zmmailbox, 내보내기를 원자적으로 수행하거나 중단으로부터 보호하는 기능은 아닙니다.
• 암호화되지 않은 아카이브의 유일한 사본을 누구나 접근할 수 있는 디렉터리에 저장하지 마십시오. 파일 시스템 또는 백업 저장소 계층에서 암호화를 적용하고 파일 읽기 권한을 제한하십시오.

Zimbra CE에서 사서함 하나를 내보내기

1. 빌드 및 사서함 크기를 확인하세요

루트 셸을 열거나 승인된 관리자 세션을 사용한 다음 해당 zimbra계정으로 전환합니다. 버전을 확인하고 내보낼 사서함을 조회합니다. 예를 들면 다음과 같습니다.

su - zimbra
zmcontrol -v
zmmailbox -z -m alice@example.com gms

실제 주소(예: )를 사용하십시오 alice@example.com. 진행하기 전에 올바른 계정인지 확인하십시오. -m인수는 명령이 읽거나 수정할 사서함을 선택합니다.

2. 제한된 목적지를 준비하세요

루트 권한으로 Zimbra 계정 소유의 백업 디렉터리를 생성한 다음 Zimbra 셸로 돌아갑니다. 스토리지 레이아웃에 맞게 경로를 조정하십시오.

install -d -o zimbra -g zimbra -m 700 /srv/zimbra-mailbox-backups
su - zimbra
umask 077

디렉터리 모드는 Zimbra 계정에 대한 액세스를 제한합니다. 일반적인 백업 절차의 일환으로 최종 백업 복사본을 별도의 보호된 시스템 또는 저장소에 보관하십시오. 운영 중인 사서함 저장소 내에 유일한 아카이브 복사본을 만들지 마십시오.

3. 메타데이터와 함께 ZIP 파일로 내보내기

사서함 내보내기를 실행하고 출력을 날짜가 포함된 보관 파일 이름으로 리디렉션하십시오.

/opt/zimbra/bin/zmmailbox -z -m alice@example.com -t 0 gru "?fmt=zip&meta=1" > /srv/zimbra-mailbox-backups/alice-2026-10-07.zip

gru는 의 공식 약어입니다 getRestURL. 따옴표로 묶인 쿼리는 메타데이터가 포함된 ZIP 형식을 요청합니다. -t 0옵션은 명령 시간 초과를 제거하며, Zimbra는 대용량 사서함 내보내기에 이 옵션을 권장합니다. 셸이 앰퍼샌드를 백그라운드 연산자로 처리하지 않도록 쿼리를 따옴표로 묶으십시오.

명령이 프롬프트로 돌아올 때까지 기다린 후 종료 상태를 확인하고 아카이브를 이동하십시오. 사서함 크기가 매우 큰 경우, 짧은 명령 실행만으로 내보내기가 완료되었다고 생각하지 말고 여유 공간과 서버 로그를 확인하십시오. 다른 프로세스가 동일한 이름의 백업을 덮어쓰지 않도록 하십시오.

4. 압축 파일을 테스트하고 파일을 확인합니다.

먼저 내보내기 파일이 존재하고 크기가 0이 아닌지 확인하십시오.

ls -lh /srv/zimbra-mailbox-backups/alice-2026-10-07.zip
unzip -t /srv/zimbra-mailbox-backups/alice-2026-10-07.zip

성공적으로 unzip -t완료되면 ZIP 컨테이너를 구조적 오류 없이 읽을 수 있음을 확인하게 됩니다. 하지만 모든 메시지나 일정 항목이 포함되어 있다는 것을 보장하는 것은 아니므로 복원 테스트를 통해 아카이브를 추가로 검사해야 합니다. 백업 프로세스에서 체크섬을 사용하는 경우 체크섬을 기록하고, 검증에 사용할 백업본과 함께 보관하십시오.

5. 아카이브를 보호하고 복사합니다.

승인된 보안 전송 또는 백업 시스템을 사용하여 파일을 별도의 백업 대상으로 복사하십시오. 파일에는 사서함 식별자, Zimbra 버전 및 내보내기 날짜를 명확하게 표시하여 저장하십시오. 백업 대상에 저장 데이터 암호화 및 액세스 제어를 적용하십시오. ZIP 내보내기 파일 자체는 암호화되어 있지 않을 수 있습니다. 보존 정책에 따라 여러 개의 복구 복사본을 보관하고, 메일 호스트에 남아 있는 파일뿐만 아니라 서버 외부 위치의 복사본을 주기적으로 테스트하십시오.

메일함을 안전하게 복원하세요

6. 임시 복구 사서함을 생성합니다.

실제 사서함으로 가져오기 전에 호환되는 빌드가 실행 중인 테스트 또는 복구 Zimbra 서버에 사용하지 않는 임시 계정을 생성하십시오. 보안이 강화된 암호를 사용하고 액세스를 제한하십시오. 관리 콘솔 또는 일반적인 프로비저닝 프로세스를 통해 계정을 생성할 수 있습니다. 스테이징 사서함을 사용하면 아카이브 내용을 프로덕션 계정과 혼합하지 않고 검사할 수 있습니다.

해당 Zimbra 서버에 아카이브를 복사하고 zimbra사용자가 읽을 수 있는지 확인하십시오. 대상 계정은 호출하기 전에 존재해야 합니다 postRestURL.

7. 복구 사서함으로 가져오기

postRestURL복구 계정을 대상으로 사용 하고 resolve=skip중복 처리를 최소화하는 데 사용하십시오.

/opt/zimbra/bin/zmmailbox -z -m restore-check@example.com -t 0 postRestURL "?fmt=zip&resolve=skip" /srv/zimbra-mailbox-backups/alice-2026-10-07.zip

여기에 restore-check@example.com임시 계정이 있습니다. Zimbra 문서 skip에 따르면 기본 충돌 처리 방식은 중복 항목을 건너뛰는 것입니다. 비어 있는 스테이징 사서함에서는 이를 통해 간단하게 초기 복원 테스트를 수행할 수 있습니다. 가져오기 동작 및 지원되는 항목 유형은 릴리스에 따라 다를 수 있으므로 대상 빌드의 문서를 참조하고 결과를 확인하십시오.

8. 복구 전에 복원된 데이터를 확인하십시오.

Zimbra 웹 클라이언트에서 스테이징 계정을 엽니다. 최근 및 이전 메시지, 폴더 이름, 연락처, 캘린더 항목, 작업 및 이 계정에 중요한 기타 데이터를 확인합니다. 그런 다음 CLI에서 폴더 및 메시지 수를 나열합니다.

/opt/zimbra/bin/zmmailbox -z -m restore-check@example.com gaf
/opt/zimbra/bin/zmmailbox -z -m restore-check@example.com gms

보이는 내용을 의도한 사서함 및 내보내기 날짜와 비교하십시오. 사용자가 내보내기 후에도 계속 작업했거나, 내보내기 기본 설정에서 삭제된 항목이 제외되었거나, 대상 릴리스에서 일부 항목 유형을 다르게 처리하는 경우 개수가 정확히 일치하지 않을 수 있습니다. 중요한 확인 사항은 아카이브가 열리고 예상되는 대표 콘텐츠를 클라이언트에서 사용할 수 있는지 여부입니다.

원래 사서함으로 가져오기

내보낸 파일을 기존 사서함에 병합해야 하는 경우, 명령에서 스테이징 주소를 원래 사서함 주소로 바꾸고 resolve=skip비파괴 병합을 시도하십시오. 이 기능은 중복 항목을 건너뛰고 기존에 없는 항목을 가져오도록 설계되었으며, 사서함을 이전 시점으로 되돌리거나 새 콘텐츠를 삭제하지 않습니다.

resolve=reset실제 운영 계정에서는 이 명령을 함부로 사용하지 마십시오 resolve=replace. Zimbra 문서 재설정은 가져오기 전에 기존 대상 폴더의 내용을 삭제하는 방식으로 진행됩니다. 대상이 사서함 루트인 경우 사서함이 완전히 삭제될 수 있습니다. '교체' 명령은 일치하는 항목을 삭제하고 다시 생성합니다. 먼저 임시 계정에서 정확한 명령을 테스트하고, 실제 운영 환경으로 가져오기 전에 최신 백업을 생성하십시오. 특정 시점으로의 완벽한 롤백이 필요한 경우, 라이선스가 있는 네트워크 에디션 복원 워크플로 또는 시스템 구성에 적합한 서버 수준 복구 절차를 사용하십시오.

일반적인 문제 및 복구 점검

• 내보내기 파일이 비어 있거나 크기가 예상보다 작습니다. 명령의 종료 상태, 사용 가능한 디스크 공간, 사서함 권한 및 Zimbra 사서함 로그를 확인하십시오. 원인을 해결한 후 새 파일 이름으로 내보내기를 다시 실행하십시오.
• 아카이브에 실패했습니다 unzip -t. 가져오기를 하지 마십시오. 새 파일로 다시 내보내고 사용 가능한 저장 공간과 중단된 셸, SSH 또는 백업 전송이 있는지 확인하십시오.
• 캘린더 또는 작업이 누락되었습니다. 내보내기 시 ZIP 형식을 사용했는지 확인하십시오 meta=1. Zimbra의 형식 표는 ZIP 파일과 기본 TGZ 콘텐츠를 구분합니다.
• 가져오기 보고서에서 중복 항목이 발견되거나 최신 데이터가 그대로 남아 있는 경우가 있습니다. 이는 건너뛰기 방식 병합에서 예상되는 현상입니다. 실제 사서함에 재설정을 적용하는 대신 별도의 스테이징 계정을 사용하여 아카이브를 검사하고 특정 복구 항목을 선택하십시오.
• 대용량 사서함에서 명령 시간 초과 오류가 발생할 수 있습니다. 해당 사서함이 존재 하는지 확인 -t 0하고 프로세스가 완료될 때까지 서버를 모니터링하십시오. 상태를 확인하기 전에는 활성 내보내기 또는 가져오기 작업을 종료하지 마십시오.
• 서버 전체 복구가 필요합니다. 사서함 내보내기에는 LDAP, 도메인/계정 프로비저닝, 시스템 구성, 인증서 또는 전체 메시지 저장소의 일관된 복사본이 포함되지 않습니다. 별도의 검증된 전체 서버 백업 계획을 따르십시오.

공식 참고 자료

• Zimbra 제품 설명서 및 최신 릴리스 가이드
• Zimbra 관리자 가이드 출처: zmmailbox 내보내기 형식 및 메타데이터
• Zimbra 기술 센터: zmmailbox 전체 계정 내보내기/가져오기 및 충돌 해결 옵션
• Zimbra REST API 참조: 아카이브 형식 및 zmmailbox 사용법
• Zimbra 기술 센터: zmbackup 에디션 출시 정보
• Zimbra 기술 센터: zmrestore 에디션 출시 정보

참조 및 릴리스 문서는 2026년 10월 7일에 확인되었습니다. 아카이브 형식과 CLI 동작은 변경될 수 있으므로, 프로덕션 사서함에서 복원을 실행하기 전에 설치된 Zimbra 버전에 맞는 문서를 확인하십시오.