이 가이드는 GSLT 토큰 문제, SourceMod 로드 실패, VAC 오류, 서버 브라우저 표시 등 Team Fortress 2 전용 서버를 운영할 때 발생할 수 있는 일반적인 문제를 다룹니다. 초기 서버 설정에 대해서는 TF2 서버 설정 가이드를 참조하세요.
GSLT 토큰 문제
증상: 서버 콘솔에 "Invalid or expired GSLT"가 표시되거나 서버가 공개적으로 나열되지 않습니다.
원인 및 해결책:
- 장기간 비활성으로 인해 토큰이 만료됨 — steamcommunity.com/dev/managegameservers에서 재생성하세요.
- 토큰을 소유한 Steam 계정에 VAC 차단이 있음 — 차단되지 않은 새 계정으로 토큰을 생성해야 합니다.
- 토큰이 이미 실행 중인 다른 서버에서 사용 중임 — 각 서버 인스턴스에는 고유한 자체 토큰이 필요합니다.
server.cfg의sv_setsteamaccount줄에 오타나 추가 공백이 있음 — 토큰 문자열과 정확히 일치하는지 확인하세요.- 토큰을 생성할 때 잘못된 App ID를 사용함 — TF2에는 App ID 440이 필요합니다.
SourceMod 로드 실패
증상: 설치 후 sm version이 "Unknown command"를 반환합니다.
원인 및 해결책:
- MetaMod:Source가 설치되지 않았거나 로드되지 않음 — 먼저
meta version이 작동하는지 확인하세요. 작동하지 않으면 MetaMod 설치를 다시 확인하세요. SourceMod는 MetaMod 없이는 작동할 수 없습니다. - 파일이 잘못된 디렉터리에 업로드됨 — SourceMod는 서버 루트나 다른 게임 폴더가 아닌
tf/addons/sourcemod/에 있어야 합니다. - 잘못된 빌드를 다운로드함 — 서버는 Linux에서 실행됩니다. Windows 빌드가 아닌 Linux 빌드를 다운로드했는지 확인하세요.
- 파일 권한 문제 — 업로드된 모든 파일을 읽을 수 있는지 확인하세요. 확실하지 않으면 SFTP를 통해 다시 업로드하세요.
- 로그 확인 —
tf/addons/sourcemod/logs/를 검토하여 무엇이 로드에 실패했는지 나타내는 오류 메시지를 확인하세요.
VAC 문제 / VAC 보안 모드 비활성화
증상: 서버 콘솔에 "VAC secure mode is disabled"가 표시되거나 플레이어에게 VAC가 꺼져 있다는 경고가 표시됩니다.
원인 및 해결책:
- 유효한 GSLT 없음 — VAC에는 유효한
sv_setsteamaccount토큰이 필요합니다. GSLT 지침은 서버 설정 가이드를 참조하세요. - 로드된 플러그인 또는 확장 기능이 플래그됨 — 일부 비공식 바이너리 확장 기능은 VAC를 비활성화시킬 수 있습니다. 원인을 파악하기 위해 최근 설치한 플러그인을 하나씩 제거하세요.
sv_cheats 1이 설정됨 — 치트가 활성화되면 VAC가 자동으로 비활성화됩니다.server.cfg에sv_cheats 0이 있는지 확인하세요.- 위 사항을 해결한 후에도 VAC가 계속 비활성화되어 있으면 (단순한 맵 변경이 아닌) 전체 서버 재시작을 수행하세요.
서버가 브라우저에 표시되지 않음
증상: 서버가 실행 중이지만 Steam 서버 브라우저에 표시되지 않습니다.
원인 및 해결책:
플러그인으로 인한 서버 충돌
증상: 플러그인을 설치하거나 업데이트한 후 서버가 예기치 않게 충돌하거나 재시작됩니다.
원인 및 해결책:
- 충돌 직후
tf/addons/sourcemod/logs/에서 충돌 로그와 오류 메시지를 확인하세요. - 최근 추가한 플러그인의
.smx파일을tf/addons/sourcemod/plugins/disabled/로 이동하여 비활성화하세요. - 모든 플러그인 종속성(예: TF2Attributes, DHooks)이 설치되어 있고 올바른 버전인지 확인하세요.
- 일부 플러그인은 특정 SourceMod API 버전이 필요합니다 — 플러그인의 AlliedModders 스레드에서 호환성을 확인하세요.
- 서버가 시작 시 충돌하면 서버가 중지된 상태에서 GPanel 파일 관리자 또는 SFTP를 사용하여 문제가 되는 플러그인 파일을 이동하세요.
.smx 파일은 서버에서 임의의 명령어를 실행할 수 있습니다. AlliedModders 또는 검증된 GitHub 저장소의 플러그인만 사용하세요.
플레이어가 접속할 수 없음
증상: 플레이어가 시간 초과, 연결 거부 또는 "server not responding" 오류를 받습니다.
원인 및 해결책:
- 서버가 실행되지 않음 — GPanel에서 서버가 온라인 상태이며 충돌 루프에 빠지지 않았는지 확인하세요.
- 잘못된 IP 또는 포트 — GPanel에서 연결 세부 정보를 확인하세요. 서버 IP 및 포트를 찾는 방법 가이드를 참조하세요.
- 비밀번호 불일치 —
server.cfg에sv_password가 설정되어 있으면 플레이어는 접속 시 올바른 비밀번호를 입력해야 합니다. - 서버가 가득 참 — 서버가
maxplayers한도에 도달했는지 확인하세요. - 커스텀 맵 다운로드 시간 초과 — 서버가 FastDL이 구성되지 않은 커스텀 맵을 실행 중인 경우, 느린 연결의 플레이어는 맵 다운로드 중 시간 초과될 수 있습니다. FastDL 구성은 서버 설정 가이드를 참조하세요.
일반 진단 단계
TF2 서버 문제를 해결할 때, 지원 티켓을 열기 전에 유용한 정보를 수집하기 위해 다음 단계를 따르세요:
- GPanel의 서버 콘솔 출력에서 오류 메시지를 확인하세요.
tf/addons/sourcemod/logs/의 로그를 검토하세요(SourceMod가 설치된 경우).- 엔진 수준 오류는
tf/console.log또는 GPanel 콘솔을 확인하세요. - 변경 후 문제가 시작되었다면 변경 사항을 되돌리고 다시 테스트하세요.
- 브라우저 관련 문제를 배제하기 위해 개발자 콘솔에서
connect IP:PORT를 통해 직접 연결을 시도하세요.
관련 문서
- TF2 서버 설정 가이드 — Server.cfg 구성, GSLT 토큰, 맵 로테이션, FastDL, 접속
- TF2 관리자 및 플러그인 설정 — SourceMod/MetaMod 설치, 관리자 계정, 플러그인 관리
- 서버 IP 및 포트를 찾는 방법
- SFTP를 통해 파일을 업로드하는 방법
tf/addons/sourcemod/logs/ 또는 서버 콘솔의 관련 로그 출력을 포함해 주세요.