# 서버 문제 해결

Source: https://support.kapsulehost.com/ko-kr/cloud-servers-troubleshooting

이 가이드에서는 가장 흔한 서버 문제와 각각의 해결 방법을 다룹니다. 로그인할 수 없거나, 서버가 응답하지 않거나, 사이트에 접속할 수 없거나, 디스크가 가득 찼거나, KPanel에 낯선 메시지가 표시되는 경우입니다.

## 먼저 확인할 사항

1. KPanel에서 서버를 열고 페이지 상단의 상태를 확인합니다. **실행 중**, **중지됨**, **설정 중**, **재구성 중**, **조치 필요**, **삭제 중**, **삭제됨** 중 하나입니다.
2. **활동** 탭을 열어 서버에 최근 어떤 변경이 있었는지, 누가 언제 했는지 확인합니다.
3. **개요** 탭의 그래프에서 지난 1시간 또는 하루 동안의 CPU, 메모리, 디스크, 네트워크를 확인합니다.

대부분의 문제는 이 세 가지로 원인을 알 수 있습니다.

## SSH로 로그인할 수 없습니다

출시 시점에는 브라우저 콘솔이 없으므로 SSH로 접속합니다.

- **"Permission denied (publickey)".** SSH 클라이언트가 서버에 있는 키를 제시하지 않고 있습니다. 주문할 때 추가한 키로 `ssh -i ~/.ssh/id_ed25519 root@<ip>`를 사용하세요. 주문 후 **SSH 키** 페이지에서 추가한 키는 이 서버에 들어 있지 않습니다.
- **키나 비밀번호를 잃어버렸습니다.** 서버가 지원하는 경우 **복구 모드** 탭을 열고 **루트 비밀번호 재설정**을 클릭하세요. 또는 복구 모드를 사용해 키를 다시 추가하세요. [복구 모드](https://support.kapsulehost.com/ko-kr/cloud-servers-rescue)를 참고하세요.
- **연결 시간이 초과됩니다.** **방화벽** 탭에서 포트 22의 SSH가 여전히 허용되어 있는지 확인한 다음 **규칙 적용**을 클릭하세요. [서버 방화벽](https://support.kapsulehost.com/ko-kr/cloud-servers-firewall)을 참고하세요.
- **지문이 바뀌었다는 경고.** 재구축 후에는 정상적인 현상입니다. `ssh-keygen -R <ip>`로 이전 항목을 삭제하고 다시 연결하세요.

[SSH로 서버에 연결하기](https://support.kapsulehost.com/ko-kr/cloud-servers-ssh-connect)를 참고하세요.

## 서버가 응답하지 않습니다

1. 서버 페이지 상단의 **재부팅**을 클릭합니다. 2분 정도 기다립니다.
2. 그래도 응답하지 않으면 **전원 끄기**를 클릭한 다음 **시작**을 클릭합니다.
3. Metal 서버에서는 **하드웨어** 탭의 **하드 리셋**을 사용합니다.
4. 그래도 시작되지 않으면 [복구 모드](https://support.kapsulehost.com/ko-kr/cloud-servers-rescue)를 켜고 디스크와 로그를 확인합니다.

[전원 켜기, 끄기, 다시 시작](https://support.kapsulehost.com/ko-kr/cloud-servers-power)을 참고하세요.

## 웹사이트나 앱에 접속할 수 없습니다

- 서버가 **실행 중**인지 확인합니다.
- **방화벽** 탭에서 해당 포트가 허용되어 있는지 확인합니다. 예를 들어 웹사이트라면 80과 443입니다. **웹** 템플릿이 이 포트를 설정합니다.
- 서버 안에서 프로그램이 실행 중인지 확인합니다. 예: `systemctl status nginx`.
- 도메인의 DNS가 서버의 IP 주소를 가리키는지 확인합니다.

## 디스크가 가득 찼습니다

디스크가 가득 차면 프로그램과 데이터베이스가 작동을 멈출 수 있습니다.

- `df -h`와 `du -sh /var/* | sort -h`로 공간을 차지하는 항목을 찾습니다.
- 더 이상 필요 없는 오래된 로그, 캐시, 백업을 정리합니다.
- [블록 볼륨](https://support.kapsulehost.com/ko-kr/cloud-servers-storage)을 추가하거나 디스크가 더 큰 크기로 [크기를 조정](https://support.kapsulehost.com/ko-kr/cloud-servers-resize)합니다.

스토리지 코어 서버에는 디스크 사용량을 보여 주고 80%부터 경고하는 **스토리지** 탭이 있습니다.

## 서버가 시작되지 않습니다

**"결제가 중지된 동안에는 이 서버를 시작할 수 없습니다. 결제를 확인한 후 다시 시도하세요."** **결제**를 열고 미납 청구서를 결제한 다음 서버를 시작하세요.

**"크레딧 확인이 실행되도록 GPU 패널에서 이 서버를 시작하세요."** 시간제 GPU 서버에서는 **GPU** 탭의 **서버 시작**을 사용하세요. [시간제 GPU와 크레딧](https://support.kapsulehost.com/ko-kr/cloud-servers-gpu)을 참고하세요.

**"이 서버를 시작할 크레딧이 부족합니다."** 크레딧을 추가한 후 다시 시도하세요.

## 표시될 수 있는 메시지

| 메시지 | 해야 할 일 |
|---|---|
| "서버가 다른 변경을 처리하는 중입니다. 1분 후에 다시 시도하세요." | 현재 변경이 끝날 때까지 기다리세요. |
| "요청이 너무 많습니다. 1분 기다린 후 다시 시도하세요." | 1분 기다린 다음 한 번만 시도하세요. |
| "서버가 아직 설정 중입니다." | 상태가 **실행 중**으로 표시될 때까지 기다리세요. |
| "본인임을 확인한 후 다시 시도하세요." | 다시 클릭하고 로그인 확인을 완료하세요. |
| "내 역할은 이 서버를 볼 수 있지만 변경할 수는 없습니다." | 소유자 및 관리자 역할만 서버를 변경할 수 있습니다. 계정 소유자에게 요청하세요. |
| "지금은 이 서버에서 이 작업을 사용할 수 없습니다." | 서버가 아직 이 작업을 할 수 없습니다. 나중에 다시 시도하거나 저희에게 문의하세요. |
| "변경이 예상보다 오래 걸리고 있습니다. 몇 분 후에 다시 확인하세요." | 변경이 아직 진행 중입니다. 나중에 페이지를 새로고침하세요. |

## 탭이나 버튼이 보이지 않습니다

탭이나 버튼은 해당 서버가 실제로 그 작업을 할 수 있을 때만 표시됩니다. **복구 모드**, **볼륨** 또는 다른 탭이 보이지 않는다면 서버가 그 기능을 제공하지 않는 것입니다. 오류가 아닙니다. **결제** 역할에는 서버 섹션이 아예 표시되지 않습니다.

## 서버에 조치 필요가 표시됩니다

구축 중 등에 문제가 발생했습니다. 저희 팀에 알림이 전달됩니다. 표시가 사라지지 않으면 **지원**에서 서버 이름을 적어 티켓을 여세요.

## 그래도 해결되지 않는다면

KPanel에서 Kora에게 물어보거나, **지원**에서 서버 이름, 하던 작업, 표시된 메시지를 적어 티켓을 여세요. 시스템 관리자가 없다면 [관리형 서버와 비관리형 서버](https://support.kapsulehost.com/ko-kr/cloud-servers-managed-vs-unmanaged)를 참고하세요.

## 관련 문서

- [SSH로 서버에 연결하기](https://support.kapsulehost.com/ko-kr/cloud-servers-ssh-connect)
- [복구 모드](https://support.kapsulehost.com/ko-kr/cloud-servers-rescue)
- [서버 방화벽](https://support.kapsulehost.com/ko-kr/cloud-servers-firewall)
- [전원 켜기, 끄기, 다시 시작](https://support.kapsulehost.com/ko-kr/cloud-servers-power)
- [블록 볼륨](https://support.kapsulehost.com/ko-kr/cloud-servers-storage)