재구축은 기존 서버에 운영 체제를 처음부터 다시 설치하는 것으로, 디스크를 완전히 지우고 같은 IP 주소를 가진 깨끗한 머신을 제공합니다.
소수의 작업에는 올바른 도구이지만, 그 밖의 모든 일에는 매우 나쁜 도구입니다. 이 가이드는 재구축이 정말 답인 경우, 무엇이 파괴되는지, 사람들이 자주 놓치는 특정한 결과 하나, 그리고 클릭하기 전에 제대로 준비하는 방법을 다룹니다.
재구축이 올바른 선택인 경우
다음과 같은 경우 재구축하세요.
- 운영 체제를 바꾸고 싶을 때. 예를 들어 Ubuntu에서 Debian으로, 또는 한 Ubuntu 릴리스에서 다른 릴리스로 바꿀 때.
- 운영 체제가 부팅되지 않거나, 고치는 것이 새로 시작하는 것보다 오래 걸릴 만큼 망가졌을 때.
- 서버를 완전히 다른 용도로 전환하면서 이전 설정을 하나도 남기고 싶지 않을 때.
- 디스크의 모든 것이 정말로 사라지기를 원할 때.
방금 한 변경을 되돌리려고 재구축하지 마세요. 그것은 스냅샷의 역할이며, 롤백이 더 빠르고 데이터도 유지됩니다. 디스크 공간을 확보하거나, 느린 애플리케이션을 고치거나, 무언가 잘못 구성되었다는 이유로 재구축하지 마세요. 그중 어느 것도 운영 체제를 교체할 필요가 없습니다.
재구축하기 전에 읽어 주세요
재구축은 서버의 모든 것을 영구적으로 파괴합니다. 모든 사이트, 메일함, 데이터베이스, 업로드한 파일, 설치된 패키지, 인증서, cron 작업, 구성 파일이 사라집니다. 되돌릴 수 없으며, 마지막 확인 이후에는 추가 확인 단계가 없습니다. 확인 대화 상자는 이를 분명히 말합니다. "운영 체제를 다시 설치하며 서버의 모든 것이 영구적으로 파괴됩니다. 이 작업은 되돌릴 수 없습니다."
재구축은 서버가 처음 프로비저닝될 때 디스크에 설치되는 KapsuleHost 도구를 지웁니다. 이 도구는 패널이 머신 내부에 접근할 때 사용하는 것입니다. 저희가 자동으로 다시 설치하고 확인합니다. 기존 백업 데이터는 암호화된 외부 저장소에 별도로 보관되므로 재구축의 영향을 받지 않습니다.
그 작업이 진행되는 동안에는 복원, 지금 백업, 실시간 방화벽 및 패치 적용, 브라우저 콘솔이 작동하지 않습니다. 모두 디스크에 설치된 도구에 의존하기 때문입니다. 보통 몇 분 정도 걸립니다. 그동안 서버는 계속 재구축 중으로 표시됩니다. 모든 구성 요소를 머신에서 다시 읽어 존재를 확인하기 전에는 준비 완료로 표시되지 않으므로, 패널이 실제로 관리할 수 없는 서버를 초록색으로 보여 주는 일은 없습니다.
복원하지 못하면 알려 드립니다. 서버는 초록색으로 바뀌지 않고 재구축 중 상태로 남으며, 동시에 저희 운영팀이 호출됩니다. 직접 확인할 필요가 없습니다.
IPv4와 IPv6 주소는 바뀌지 않습니다. 바뀌는 것은 디스크의 내용뿐입니다.
재구축 준비하기
시작하기 전에 이 목록을 차례로 진행하세요. 서버에 소중한 것이 있다면 어느 것도 선택 사항이 아닙니다.
- 스냅샷을 만드세요. 스냅샷은 디스크의 전체 사본입니다. 마음이 바뀌었을 때 현재 머신을 되찾을 수 있는 유일한 방법입니다. 클라우드 서버 스냅샷을 참조하세요.
- 계속 작업에 쓰고 싶은 것은 내보내세요. 데이터베이스, 업로드 파일, 구성을 서버 밖의 다른 곳으로 복사하세요. 내 컴퓨터, 다른 서버, 또는 오브젝트 스토리지입니다. 기존 백업은 재구축 후에도 남아 있고 재구축이 끝나면 패널에서 복원할 수 있지만, 직접 보관한 사본이 작동하는 사이트로 돌아가는 더 빠른 길입니다.
- 설치된 것을 기록해 두세요. 재구축 후에는 스택을 직접 다시 구성해야 합니다. 패키지, 서비스, 가상 호스트, cron 작업 목록이 있으면 몇 시간을 절약할 수 있습니다.
- DNS를 확인하세요. 이 서버를 가리키는 것이 있다면, 재구축과 재구성이 진행되는 동안 빈 머신을 가리키게 됩니다.
- 다시 접속할 수 있는지 확인하세요. 새로 설치된 운영 체제에 어떻게 접속할지 지금 정하고, SSH로 클라우드 서버에 접속하기를 참조하세요.
재구축이 끝나고 도구가 복원될 때까지 몇 분 동안은 브라우저 콘솔을 사용할 수 없으므로, 그것을 유일한 접속 수단으로 삼지 마세요. SSH를 준비해 두세요.
재구축 방법
- KPanel에 로그인합니다.
- 왼쪽 사이드바에서 클라우드 서버를 클릭한 다음 서버를 클릭합니다.
- 페이지 상단의 작업 버튼에서 OS 재구성을 클릭합니다.
- OS 재구성 대화 상자가 "이 서버의 모든 데이터가 손실됩니다. 설치할 OS를 선택하세요:"라는 문구와 드롭다운과 함께 열립니다.
- 원하는 운영 체제를 선택합니다.
- Ubuntu 24.04 LTS, 현재의 장기 지원 릴리스.
- Ubuntu 22.04 LTS, 이전 장기 지원 릴리스.
- Debian 12 (Bookworm), 가볍고 안정적인 Debian.
- 서버 재구성을 클릭합니다.
- "재구축"과 서버 이름이 제목으로 표시된 최종 확인 창이 나타납니다. 내용을 읽은 다음 서버 재구성을 클릭합니다.

OS 재구성은 서버가 실행 중 또는 전원 꺼짐 상태일 때만 사용할 수 있습니다. 아직 프로비저닝 중이거나 이미 재구축 중인 서버는 재구축할 수 없습니다.
다음에 일어나는 일
- 서버 상태가 재구성 중으로 바뀌고 배너가 표시됩니다. "재구성 중: 페이지가 자동으로 업데이트됩니다."
- 디스크의 모든 것이 지워지고 선택한 운영 체제 이미지가 그 자리에 기록됩니다.
- 서버가 새 설치로 재부팅됩니다.
- 페이지가 스스로 새로 고쳐지고 상태가 다시 실행 중으로 돌아갑니다.
그동안 서버는 오프라인입니다. 재구축은 보통 빠르지만 백그라운드 작업이 아니라 서비스 중단으로 여기고, 사용자가 눈치채지 못할 시간에 진행하세요.
재구축 후
이제 기본 운영 체제만 있습니다. 이전에 설치한 것은 아무것도 없습니다.
- 서버에 접속해 셸을 사용할 수 있는지 확인합니다. SSH로 클라우드 서버에 접속하기를 참조하세요.
- 방화벽 규칙을 다시 적용합니다. 재구축으로 이전 규칙이 삭제되었습니다. 클라우드 서버 방화벽 및 보안 관리를 참조하세요.
- 웹 서버, 런타임, 데이터베이스, 애플리케이션 종속성 등 스택을 다시 설치합니다.
- 직접 내보낸 데이터를 복원합니다.
- SSL 인증서를 다시 발급합니다. 이전 인증서는 지워진 디스크에 있었습니다.
일일 백업이 저절로 서버를 다시 이어받을 것이라고 가정하지 마세요. 재구축으로 서버 측 백업 도구가 삭제되었다면 백업은 스스로 재개되지 않습니다. 재구축 후 백업 카드를 확인하고, 백업이 구성되지 않았다고 표시되면 저희에게 문의하세요. 클라우드 서버 백업을 참조하세요.
먼저 고려할 만한 대안
| 원하는 것 | 재구축보다 나은 도구 |
|---|---|
| 방금 한 변경 되돌리기 | 스냅샷 롤백 |
| 삭제된 파일이나 망가진 데이터베이스 복구 | 백업에서 복원 |
| 더 많은 CPU, 메모리, 디스크 | 서버 크기 조정 |
| 다른 프로세서 계열이나 지역 | 새 서버 주문. ARM, Standard, Dedicated vCPU 중에서 선택하기 참조 |
| 테스트용 깨끗한 환경 | 작은 서버를 하나 더 프로비저닝하고 이 서버는 그대로 유지 |
문제 해결
OS 재구성 버튼이 회색으로 비활성화되어 있습니다. 서버가 재구축을 허용하는 상태가 아닙니다. 프로비저닝이나 진행 중인 재구축이 끝날 때까지 기다리세요.
상태가 재구성 중에서 멈춰 있습니다. 페이지는 몇 초마다 상태를 확인하고 스스로 업데이트합니다. 15분이 지나도 바뀌지 않으면 서버 이름을 적어 지원팀에 문의하세요.
재구축 후 접속할 수 없습니다. 새 호스트 키를 가진 완전히 새로운 운영 체제 설치에 접속하는 것이므로, SSH 클라이언트가 이전 지문을 거부합니다. 해당 IP 주소의 오래된 호스트 키 항목을 삭제하고 다시 접속하세요. 인증 자체가 실패하면 저희에게 문의하세요.
실수로 재구축했습니다. 미리 스냅샷을 만들었다면 롤백하세요. 만들지 않았다면 데이터는 사라졌습니다. 확인 문구가 그렇게 작성된 이유가 바로 이것입니다.
재구축이 정말 필요한지 확실하지 않다면, 시작하기 전에 하려는 일을 적어 support@kapsulehost.com으로 이메일을 보내 주세요. 재구축은 플랫폼에서 되돌릴 방법이 없는 몇 안 되는 작업 중 하나입니다.