기본 오류 해결
접속 실패, 서버 시작 오류, 메모리와 저장 공간 부족 등 마크 서버의 기본 문제 해결 방법입니다.
먼저 확인해주세요
- 마크 서버 패널에서 해당 서버를 선택합니다.
- 설치가 완료됐는지, Console에서 서버가 실행 중인지 확인합니다.
- 게임에는 패널에 표시된 접속 주소를 입력합니다. 패널 웹 주소나 SFTP 주소가 아닙니다.
- 오류가 나기 직전에 바꾼 버전, 플러그인, 모드, 설정이 있는지 확인합니다.
파일을 수정할 때는 서버를 완전히 중지하고, 월드와 설정을 먼저 내려받아 보관해주세요. 오류가 난다고 재설치하거나 월드를 삭제하지 마세요.
게임에서 접속이 안 돼요
| 오류 또는 증상 | 먼저 확인할 내용 |
|---|---|
연결 시간 초과 / Connection timed out | 접속 주소와 서버 실행 상태를 확인하고 다른 네트워크에서도 시도해주세요. 계속되면 발생 시각과 함께 문의해주세요. |
연결 거부 / Connection refused | 서버가 시작 직후 다시 종료되지 않았는지 Console을 확인해주세요. 포트를 임의로 바꾸지 마세요. |
Unknown host | 도메인 오타를 확인해주세요. 커스텀 도메인이라면 DNS 설정과 적용 상태도 확인해주세요. |
Outdated client / Outdated server | 게임과 서버의 버전을 확인해주세요. 모드 서버는 모드 로더와 모드팩의 요구 버전도 맞아야 합니다. |
Invalid session | 게임과 런처를 종료한 뒤 정식 계정으로 다시 로그인해주세요. 계속되면 인증 서비스 상태 확인이 필요합니다. |
| 화이트리스트 안내 | 허용 목록에 등록된 계정인지 서버 운영자에게 확인해주세요. 오류 해결을 위해 무조건 화이트리스트를 끄지는 마세요. |
Java Edition과 Bedrock Edition의 주소 입력 방식은 다를 수 있습니다. Bedrock은 안내받은 주소와 포트를 사용하고, 모드·플러그인의 호환 여부도 확인해주세요.
Velocity 또는 forwarding 오류가 나요
오류에 Velocity, forwarding, player details가 보이면 공용 접속 경로와 서버 설정을 함께 확인해야 합니다. 먼저 패널의 접속 주소로 연결했는지 확인하고, 오류 문구를 고객센터에 보내주세요. Velocity 공식 접속 오류 안내에도 관련 증상이 정리되어 있습니다.
LightHost의 접속 경로는 개통 과정에서 연결됩니다. 인터넷의 일반 서버 가이드를 보고 online-mode, forwarding 설정이나 공유 비밀키를 임의로 변경하지 마세요. 공유 비밀키를 공개하면 안 됩니다.
서버가 켜지지 않거나 바로 꺼져요
Console의 마지막 줄만 보지 말고, 처음 나타난 오류와 그 앞뒤 내용을 확인해주세요. Files의 logs/latest.log와, 생성된 경우 crash-reports 폴더도 확인할 수 있습니다.
| 오류 | 의미와 조치 |
|---|---|
UnsupportedClassVersionError | 실행 파일 또는 플러그인과 Java 버전이 맞지 않을 수 있습니다. 최근 교체한 파일의 지원 버전을 확인하고 Java 실행 환경 변경은 고객센터에 요청해주세요. |
Unable to access jarfile | 실행할 파일이 없거나 시작 설정의 파일명과 다릅니다. 파일명을 확인하되, Forge는 실행 구조가 다를 수 있으므로 Paper용 시작 명령을 그대로 쓰지 마세요. |
Failed to bind to port | 포트나 바인딩 설정을 확인해야 합니다. 최근 server.properties를 바꿨다면 원본과 비교하고, 할당 포트를 임의 변경하지 말고 문의해주세요. |
| EULA 동의 안내 | Minecraft 이용약관을 읽고 동의하는 경우에만 eula.txt의 동의 상태를 설정한 뒤 다시 시작해주세요. |
오류를 무시하는 실행 옵션이나 무한 재시작보다 원인 확인이 우선입니다. Paper 공식 기본 문제 해결 안내에서 로그, Java 및 실행 파일 오류를 참고할 수 있습니다.
플러그인이나 모드를 넣은 뒤 오류가 나요
- Paper 플러그인은
plugins, Forge 모드는mods폴더를 사용합니다. 서로 그대로 호환되는 것은 아닙니다. - Minecraft 버전, 서버 소프트웨어, 필요한 선행 플러그인·라이브러리를 확인해주세요.
- 모드의
Missing dependencies안내가 나오면 필요한 모드와 버전을 확인해주세요. 클라이언트 전용 모드는 서버에 넣지 마세요. - 변경 전 백업을 확보한 뒤 새로 추가한 파일부터 임시로 분리해 확인해주세요. 모드는 제거 시 월드 데이터에 영향을 줄 수 있으므로 가능하면 월드 복사본에서 테스트해주세요.
필요한 모드와 실행 환경은 각 모드 제작자의 안내를 우선해주세요. Forge 공식 의존성 안내를 참고할 수 있습니다.
메모리 부족으로 종료돼요
OutOfMemoryError나 Java heap space는 Java 메모리 부족 관련 오류입니다. 이것만으로 메모리 누수라고 단정할 수는 없습니다. Java 공식 메모리 오류 안내에 원인별 설명이 있습니다.
패널의 메모리 한도와 사용량을 확인하고, 최근 추가한 모드·플러그인이나 월드 작업을 함께 살펴봐주세요. Java는 힙 외에도 메모리를 사용하므로 -Xmx를 요금제 한도와 같거나 더 크게 임의 설정하지 마세요.
Exit code 137 또는 Killed만 보이는 경우에는 강제 종료 등 다른 원인도 가능합니다. 발생 시각과 Console 내용을 보내주시면 호스트 측 확인이 필요한지 안내해드립니다.
저장 공간이 부족해요
No space left on device가 나오면 패널의 디스크 사용량을 확인해주세요. 월드, 로그, 업로드 파일과 서버 안에 보관한 압축 파일이 공간을 함께 사용합니다.
서버를 중지한 뒤 불필요한 파일을 구분하고, 필요한 자료는 PC로 내려받아 정상적으로 열리는지 확인한 후 정리해주세요. 공간이 가득 찼다면 서버 안에 새 백업 압축 파일을 만드는 것도 실패할 수 있습니다. 월드, playerdata나 용도를 모르는 파일을 먼저 삭제하지 마세요.
파일 전송은 SFTP 연결 가이드를 참고해주세요.
렉이 심하거나 월드가 안 열려요
Can't keep up이 반복되면 발생 시점의 인원, 탐험·청크 생성, 엔티티, 모드·플러그인 작업을 확인해주세요. 한 줄만으로 호스트 장애라고 단정할 수는 없습니다.- 최근 올린 설정과 파일을 하나씩 확인하고, 시야 거리나 시뮬레이션 거리를 변경한다면 백업 후 조금씩 조정해주세요.
- 새 버전에서 열었던 월드를 구버전으로 낮춰 실행하지 마세요. 버전 관련 월드 오류가 나면 강제 로드 옵션 대신 해당 버전과 호환되는 백업 복원을 먼저 검토해주세요.
성능 경고와 월드 버전 오류는 Paper 공식 문제 해결 안내를 참고해주세요.
해결되지 않으면 고객센터로 보내주세요
고객센터에 아래 정보를 보내주시면 확인에 도움이 됩니다.
- 주문 번호 또는 패널의 서버 이름
- Minecraft 버전과 Paper·Forge 등 서버 소프트웨어
- 발생 시각과 게임에 표시된 오류 문구
- Console 오류 앞뒤 내용 또는
logs/latest.log의 관련 부분 - 직전에 변경한 설정, 플러그인·모드와 이미 시도한 조치
비밀번호, API 키, forwarding 비밀키, 개인 연락처나 다른 이용자의 IP가 로그에 있다면 가려주세요. 공개 게시판에 전체 설정 파일을 올리지 마세요.