이 가이드는 일반적인 Counter-Strike 2 서버 문제와 해결 방법을 다룹니다. 초기 서버 설정은 CS2 서버 설정 가이드를 참고하세요. 관리자 명령어 및 경쟁전 구성은 CS2 관리자 설정을 참고하세요.

GSLT / Steam 인증 오류

서버가 서버 브라우저에 표시되고 VAC 보호로 실행되려면 유효한 게임 서버 로그인 토큰(GSLT)이 필요합니다. 아래 표는 가장 일반적인 GSLT 관련 오류를 다룹니다.

오류 / 증상	원인	해결 방법
No account token specified	시작 매개변수에 GSLT가 설정되지 않음	GPanel에서 Startup 탭을 열고 GSLT 필드에 토큰을 붙여넣으세요
GSLT is expired or invalid	토큰이 재생성되거나 취소됨	Steam 게임 서버 관리를 방문하여 토큰을 재생성한 다음 GPanel에서 업데이트하세요
Game server login token banned	토큰과 연결된 계정이 밴을 받음	밴은 토큰별로 영구적입니다. 깨끗한 Steam 계정에서 새 토큰을 생성하세요
서버가 비보안 모드로 시작됨	GSLT가 누락되었거나 Steam 연결이 실패함	토큰이 설정되었는지 확인하고, 할당된 게임 포트(GPanel의 Network 탭 참고)에 도달할 수 있는지 확인한 다음, Steam 핸드셰이크를 위해 60초 동안 기다리세요

서버가 브라우저에 표시되지 않음

• server.cfg에 sv_lan 0이 설정되어 있는지 확인하세요. LAN 모드는 인터넷 브라우저에서 서버를 숨깁니다.
• GSLT가 유효하고 서버 콘솔에 Connection to Steam servers successful이 표시되는지 확인하세요.
• 서버 브라우저 목록은 전파되는 데 최대 5분이 걸릴 수 있습니다. 그동안 즐겨찾기 또는 직접 접속을 사용하세요.
• 일부 ISP와 지역은 Steam의 서버 브라우저 UDP 쿼리에 문제가 있습니다. 포트에 도달할 수 있는 경우 콘솔을 통한 직접 접속은 항상 작동합니다.

VAC / 안티치트 문제

• VAC에는 유효한 GSLT와 sv_cheats 0이 필요합니다.
• sv_cheats 1로 테스트하는 경우 해당 세션에서 VAC가 자동으로 비활성화됩니다. 서버를 재시작하고 공개하기 전에 치트가 꺼져 있는지 확인하세요.
• 서명되지 않았거나 오래된 플러그인을 실행하면 VAC가 서버를 비보안으로 표시할 수 있습니다. 모든 CS2 게임 업데이트 후 MetaMod와 CounterStrikeSharp를 최신 상태로 유지하세요.

시작 시 서버 충돌

• 충돌 직후 GPanel의 Console 탭에서 오류 메시지를 확인하세요.
• 가장 일반적인 원인은 CS2 업데이트 후 오래된 MetaMod 또는 CounterStrikeSharp 빌드입니다. 플러그인 프레임워크를 제거하거나 업데이트한 다음 다시 시도하세요.
• 손상된 게임 파일도 충돌을 일으킬 수 있습니다. GPanel의 Reinstall 옵션을 사용하여 게임 파일을 확인하고 복원하세요.

플레이어가 접속할 수 없음

• 서버가 완전히 시작되었고 콘솔에 Connection to Steam servers successful이 표시되는지 확인하세요.
• 플레이어가 GPanel의 Network 탭의 올바른 IP와 포트를 사용하고 있는지 확인하세요.
• sv_password가 설정된 경우 플레이어는 접속하기 전에 비밀번호를 입력해야 합니다. 직접 공유하거나 비밀번호가 포함된 Steam 접속 링크를 사용하세요:

  steam://connect/YOUR.SERVER.IP:PORT/YourPassword

• 서버와 동일한 LAN에 있는 플레이어는 IP로 직접 접속해야 합니다. Steam 서버 브라우저는 LAN 로컬 서버를 올바르게 표시하지 않을 수 있습니다.

워크샵 맵이 로드되지 않음

• 시작 매개변수에 Steam Web API 키를 설정했는지 확인하세요. steamcommunity.com/dev/apikey에서 받을 수 있습니다.
• 워크샵 맵 ID가 올바른지 확인하세요(Steam Workshop URL의 숫자 ID).
• 콘솔에서 다운로드 오류를 확인하세요. 대용량 워크샵 맵은 첫 로드 시 다운로드하는 데 몇 분이 걸릴 수 있습니다.
• 맵 로드에 실패하면 서버를 재시작해 보세요. 일부 워크샵 다운로드는 완료하려면 깨끗한 재시작이 필요합니다.

MetaMod / CounterStrikeSharp가 로드되지 않음

• gameinfo.gi 파일에 MetaMod 검색 경로 항목이 있는지 확인하세요. Game csgo/addons/metamod 줄이 SearchPaths 블록의 첫 번째 Game 항목 위에 나타나야 합니다.
• GPanel 콘솔에서 meta list를 실행하세요. MetaMod가 목록에 없으면 파일 경로를 다시 확인하세요: game/csgo/addons/metamod/가 존재해야 합니다.
• CounterStrikeSharp의 경우 with-runtime 패키지를 다운로드했는지 확인하세요. .NET 런타임이 없으면 플러그인이 자동으로 로드에 실패합니다.
• 모든 CS2 게임 업데이트 후 MetaMod 및 CounterStrikeSharp 페이지에서 업데이트된 빌드를 확인하세요. 오래된 빌드는 플러그인 실패의 가장 큰 원인입니다.

높은 지연 시간 / 랙

• 서버가 GPanel에서 할당된 RAM을 초과하고 있는지 확인하세요. 많은 플러그인이나 워크샵 맵이 있는 CS2 서버는 상당한 메모리를 사용할 수 있습니다.
• server.cfg의 비율 설정을 검토하세요. 최신 CS2 기본값(sv_maxrate 0, sv_maxupdaterate 128)은 대부분의 설정에 잘 작동합니다.
• 특정 지역의 플레이어가 높은 핑을 경험하는 경우, 문제는 서버 구성이 아니라 네트워크 라우팅입니다. 지리적 거리에 대한 서버 측 해결책은 없습니다.
• 사용하지 않는 플러그인을 비활성화하세요. 로드된 각 플러그인은 틱당 처리 오버헤드를 추가합니다.

관련 문서

• CS2 서버 설정 가이드 — GSLT, server.cfg, 게임 모드, 접속
• CS2 관리자 설정 — RCON, 명령어, 경쟁전 구성
• 서버 IP와 포트를 찾는 방법
• SFTP로 파일 업로드하는 방법