시작 실패, 연결 문제, 모드 오류, 월드 손상을 포함한 일반적인 Terraria 전용 서버 문제에 대한 해결 방법입니다. 서버 구성의 기본 사항은 Terraria 서버 설정 가이드를 참조하십시오.
서버는 시작되지만 월드가 로드되지 않음
serverconfig.txt의 world 경로가 대소문자를 포함하여 saves/Worlds/ 디렉터리의 파일 이름과 정확히 일치하는지 확인하십시오. Linux 서버에서는 경로가 대소문자를 구분합니다.
# Correct — matches actual filename
world=/home/container/saves/Worlds/MyWorld.wld
# Wrong — case mismatch will fail
world=/home/container/saves/Worlds/myworld.wld
파일이 전혀 존재하지 않고 새 월드가 자동으로 생성되기를 원한다면, serverconfig.txt의 autocreate 값을 1(소형), 2(중형) 또는 3(대형)으로 설정하십시오.
접속 불가 — 연결 거부 또는 시간 초과
GPanel에서 서버가 실행 중인지, 그리고 연결 세부 정보 페이지에 표시된 올바른 IP와 포트를 사용하고 있는지 확인하십시오. 확실하지 않은 경우 서버 IP 및 포트를 찾는 방법을 참조하십시오.
그 외 확인할 사항:
- 서버가 완전히 시작되었는지 확인하십시오 — 접속을 시도하기 전에 콘솔 로그에서 "Listening on port..." 메시지를 확인하십시오.
- 최근에
serverconfig.txt의 포트를 변경했다면 되돌리십시오. 패널이 포트를 자동으로 할당하므로, 변경하면 불일치가 발생할 수 있습니다. - 로컬 방화벽이나 백신 프로그램이 Terraria의 아웃바운드 연결을 차단하고 있지 않은지 확인하십시오.
비밀번호 입력창이 나타나지 않음 / 잘못된 비밀번호 오류
serverconfig.txt에 비밀번호를 설정한 경우, 값 주변에 추가 공백이 없는지 확인하십시오. 해당 줄은 따옴표나 끝부분 공백 없이 정확히 password=yourpassword로 작성되어야 합니다.
# Correct
password=mysecretpass
# Wrong — extra spaces will be included in the password
password= mysecretpass
password=mysecretpass tModLoader 서버에서 모드가 로드되지 않음
.tmod파일이mods/디렉터리 안의 하위 디렉터리가 아니라mods/디렉터리에 직접 있는지 확인하십시오.- 서버의 tModLoader 버전이 모드가 빌드된 tModLoader 버전과 일치하는지 확인하십시오. 오래된 모드는 최신 tModLoader 버전에서 로드되지 않습니다.
- 시작 중 tModLoader의 특정 오류 메시지를 확인하려면 GPanel의 서버 콘솔 로그를 검토하십시오.
전체 모드 설치 지침은 Terraria 모드 설치 (tModLoader)를 참조하십시오.
난이도 설정이 적용되지 않음 (tModLoader)
tModLoader 서버에서는 serverconfig.txt의 difficulty 줄이 # 문자로 시작해서는 안 됩니다. #difficulty=0과 같이 주석 처리된 줄은 tModLoader에서 무시되므로, 값에 관계없이 난이도가 일반으로 기본 설정될 수 있습니다.
# This is IGNORED by tModLoader:
#difficulty=0
# This is applied correctly:
difficulty=0
difficulty 설정은 autocreate를 통해 새 월드가 생성될 때만 적용됩니다. 기존 월드 파일의 난이도는 변경할 수 없습니다.
바닐라와 tModLoader 간 전환 후 월드 손상
바닐라 세션과 tModLoader 세션에는 항상 별도의 월드 파일을 사용하십시오. tModLoader 월드를 바닐라에서 로드하여 손상된 경우, 가장 안전한 복구 방법은 백업에서 복원하는 것입니다.
시작 시 서버 충돌
잘못된 형식의 serverconfig.txt 또는 누락된 월드 파일이 시작 충돌의 가장 일반적인 원인입니다. 진단 단계:
- GPanel에서 콘솔 로그를 열고 첫 번째 오류 줄을 찾으십시오.
serverconfig.txt의 모든 경로와 값을 다시 확인하십시오.- 최근에 모드를 설치했다면,
mods/디렉터리에서 모드를 제거하여 모드 없이 서버가 시작되는지 확인하십시오. - 모드 없이 깨끗한 구성으로도 충돌이 지속되면 지원 티켓을 여십시오.
관련 문서
- Terraria 서버 설정 가이드 — 서버 구성, 월드 설정 및 접속
- Terraria 모드 설치 (tModLoader) — 모드 설치 및 관리
- 서버 IP 및 포트를 찾는 방법
- SFTP로 파일을 업로드하는 방법
