왜 직접 덮어쓰면 안 되는가

라이브 월드를 업데이트할 때 가장 흔한 사고는 새 파일을 실행 중인 월드 디렉터리에 직접 덮어쓰는 것입니다. 업로드가 도중에 끊기거나, 새 월드의 버전이 호환되지 않거나, 파일이 전송 중 손상되면 서버가 켜지지 않을 수 있는데, 이때는 원래 월드가 이미 덮어써져 복구가 매우 번거로워집니다. 안전한 접근법은 ‘업로드’와 ‘적용’을 철저히 분리하는 것입니다. 먼저 새 월드를 격리 디렉터리에 넣고, 검증과 확인이 모두 끝난 뒤에 라이브 환경을 원자적으로 전환합니다.

안전한 업데이트의 전체 단계

mcworld.app은 전체 관리 권한을 명시적으로 부여받은 뒤, 아래 순서대로 안전하게 배포하며 전 과정에서 터미널을 만질 필요가 없습니다.

  1. 버전과 공간 사전 점검 — 새 월드가 서버 버전과 호환되는지, 디스크가 신·구 두 버전을 동시에 담을 수 있는지 확인합니다.
  2. 스냅샷 생성 및 검증 — 현재 월드에 대한 롤백 지점을 만들고, 그것이 실제로 복원 가능한지 확인합니다.
  3. 격리 디렉터리에 업로드 — 새 월드를 별도로 보관하고, 전환 전까지 기존 월드를 사용할 수 있게 유지합니다.
  4. 무결성 검증 — 해시를 비교하고 구조를 점검하여 전송이 손실 없이 이루어졌는지 확인합니다.
  5. 원자적 전환 — 한 번에 서버를 새 월드로 가리키게 하며, 절반은 새 버전, 절반은 옛 버전인 중간 상태를 남기지 않습니다.
  6. 헬스 체크와 자동 롤백 — 전환 후 정상 기동되는지 확인하고, 어느 단계라도 실패하면 스냅샷으로 자동 롤백합니다.

각 단계의 자세한 배경을 알고 싶다면 심화 튜토리얼 서버 월드 안전 배포를 참고하세요.

제품의 원칙: 추적 가능, 롤백 가능

전체 과정의 원칙은 원본 파일을 절대 덮어쓰지 않는 것입니다. 매번 업데이트할 때마다 업데이트 이전 버전과 해시를 보관하므로 롤백 지점을 항상 추적할 수 있습니다. 먼저 상태만 보고 쓰기는 하지 않으려는 경우 무료 ‘모니터링 전용’을 사용할 수 있으며(자세한 내용은 휴대폰으로 Minecraft 서버 열기 참고), 정식 업데이트 전에는 한 번 월드 백업을 해 두어 안전장치를 마련하기를 권장합니다. 진단은 무료이며 기본적으로 로컬에서 수행되고, 결과에 따라 비용을 지불하며 실패 시 환불됩니다. 가격은 앱 내 표시를 기준으로 합니다.