라이선스 키 오류, 서버 브라우저 가시성, 리소스 실패, 클라이언트 연결, 데이터베이스 문제, 성능 최적화 등 일반적인 RedM 서버 문제에 대한 문제 해결 가이드입니다. 초기 설정 방법은 RedM 서버 설정 가이드를 참조하세요.

라이선스 키 오류

라이선스 키 문제는 새 RedM 서버를 시작할 때 가장 흔한 문제입니다. 일반적인 오류와 해결책은 다음과 같습니다:

"Invalid license key" 또는 "Could not authenticate"

서버가 브라우저에 나타나지 않음

서버가 실행 중이지만 플레이어가 RedM 서버 브라우저에서 찾을 수 없는 경우:

체크리스트

1. 최소 5분 기다리세요. 시작 후 서버가 Cfx.re 마스터 서버 목록에 등록되는 데 시간이 필요합니다. 새 서버는 나타나는 데 몇 분이 걸릴 수 있습니다.
2. 라이선스 키가 유효한지 확인하세요. 작동하는 라이선스 키가 없으면 서버가 목록에 표시되지 않습니다. 서버 콘솔에서 라이선스 관련 오류를 확인하세요.
3. 엔드포인트 구성을 확인하세요. server.cfg의 endpoint_add_tcp와 endpoint_add_udp가 올바른 포트를 사용하는지 확인하세요:

   endpoint_add_tcp "0.0.0.0:30120"
   endpoint_add_udp "0.0.0.0:30120"

   포트는 GPanel에서 할당된 포트와 일치해야 합니다.
4. "sv_master1" 또는 목록 설정을 확인하세요. 서버가 자신을 목록에 표시하지 않도록 실수로 설정하지 않았는지 확인하세요. 구성에 sv_master1 ""가 없어야 합니다(이는 마스터 목록 등록을 비활성화합니다).
5. 서버가 실제로 실행 중인지 확인하세요. GPanel 콘솔을 확인하세요. 서버가 충돌하거나 중지된 경우 브라우저에 나타나지 않습니다.
6. 직접 연결을 시도하세요. 서버가 브라우저에 없더라도 직접 연결은 작동해야 합니다. 플레이어에게 RedM에서 F8을 누르고 다음을 입력하게 하세요:

   connect YOUR_SERVER_IP:PORT

리소스 로딩 실패

리소스 오류는 서버에 새 스크립트나 프레임워크를 추가할 때 흔히 발생합니다. 가장 빈번한 문제는 다음과 같습니다:

"Could not find resource [resource_name]"

• 리소스 폴더가 resources/ 디렉터리에 존재하지 않거나 잘못된 위치에 있습니다.
• 폴더 이름이 ensure에 사용된 이름과 일치하지 않습니다. 리소스 이름은 대소문자를 구분합니다.
• 해결: 리소스 폴더가 존재하는지, 그리고 server.cfg의 이름이 정확히 일치하는지 확인하세요. GPanel 파일 관리자 또는 SFTP를 사용하여 확인하세요.

"Failed to load resource [resource_name]: manifest error"

• 리소스의 fxmanifest.lua 또는 __resource.lua에 구문 오류가 있습니다.
• 매니페스트가 리소스 폴더에 존재하지 않는 파일을 참조합니다.
• 해결: 매니페스트 파일을 열어 오타, 누락된 쉼표, 존재하지 않는 파일에 대한 참조를 확인하세요. 서버 콘솔에서 오류의 구체적인 줄 번호를 확인하세요.

"Error loading script [filename]: [error details]"

• 리소스 내의 Lua, C#, 또는 JavaScript 파일에 구문 또는 런타임 오류가 있습니다.
• 해결: 콘솔의 전체 오류 메시지를 읽으세요. 파일 이름과 줄 번호가 포함됩니다. 일반적인 원인은 다음과 같습니다:
  • 누락된 종속성(먼저 로드되어야 하는 다른 리소스)
  • 현재 RedM 서버 버전과 호환되지 않는 오래된 리소스
  • 리소스 구성 파일의 잘못된 구성 값

리소스 로드 순서 문제

server.cfg의 리소스는 나타나는 순서대로 로드됩니다. 리소스가 다른 리소스에 종속된 경우(예: vorp_inventory는 vorp_core에 종속됨), 종속성이 먼저 나열되어야 합니다:

# Correct order - dependencies first
ensure oxmysql
ensure vorp_core
ensure vorp_inventory
ensure vorp_stores

# Wrong order - will cause errors
# ensure vorp_inventory   <-- depends on vorp_core
# ensure vorp_core        <-- loaded too late

클라이언트 연결 문제

플레이어가 서버에 연결할 수 없는 경우:

"Connection timed out" / "Failed to connect"

"Connection rejected by server"

• 서버 비밀번호: sv_password가 설정된 경우 플레이어는 올바른 비밀번호를 입력해야 합니다.
• 화이트리스트/허용 목록 리소스: 화이트리스트 리소스가 활성화된 경우 플레이어는 연결 전에 승인되어야 합니다.
• 차단: 플레이어가 차단되었을 수 있습니다. 차단 목록이나 데이터베이스에서 식별자를 확인하세요.

연결 시 클라이언트 충돌

• 서버의 리소스가 잘못된 데이터를 보내거나 클라이언트를 충돌시키는 클라이언트 측 스크립트 오류가 있습니다.
• 해결: 최근에 추가한 리소스를 하나씩 비활성화하여 문제가 있는 리소스를 식별하세요. 클라이언트 연결 중 서버 콘솔에서 오류를 확인하세요.
• 플레이어의 RedM 클라이언트가 최신 상태인지 확인하세요.

"Could not download file" 오류

• 서버가 전송 한도를 초과하는 큰 파일(예: 스트리밍 에셋)을 보내려 하거나 연결이 불안정합니다.
• 해결: 스트리밍되는 에셋의 크기를 줄이거나, 지원되는 경우 큰 파일에 CDN/외부 호스팅을 사용하거나, 플레이어에게 연결을 다시 시도하게 하세요.

데이터베이스 문제 (MySQL / oxmysql)

대부분의 RedM 롤플레이 프레임워크는 영구 데이터 저장을 위해 MySQL을 사용합니다. 가장 일반적인 데이터베이스 커넥터는 oxmysql입니다.

연결 실패 오류

oxmysql(또는 다른 MySQL 커넥터)이 연결에 실패하면 다음을 확인하세요:

# Typical oxmysql connection string in server.cfg
set mysql_connection_string "mysql://user:password@host:3306/database_name?charset=utf8mb4"

누락된 테이블 또는 스키마 오류

롤플레이 프레임워크는 작동하기 전에 데이터베이스 테이블을 설정해야 하는 경우가 많습니다:

1. SQL 가져오기 파일(흔히 database.sql, schema.sql 또는 유사한 이름)에 대해 프레임워크의 문서나 GitHub 저장소를 확인하세요.
2. phpMyAdmin 또는 MySQL 클라이언트를 사용하여 SQL 파일을 데이터베이스로 가져오세요.
3. 일부 프레임워크는 최초 시작 시 테이블을 자동으로 생성합니다. 데이터베이스 사용자가 CREATE TABLE 권한을 가지고 있는지 확인하세요.

성능 문제

RedM 서버에 랙, 낮은 틱 레이트, 또는 전반적으로 저조한 성능이 발생하는 경우:

성능 문제 식별

서버 콘솔에서 성능 경고를 확인하세요. RedM 서버는 초당 약 30-64 틱의 틱 레이트를 목표로 합니다. 다음으로 모니터링할 수 있습니다:

• txAdmin 대시보드: txAdmin을 사용할 수 있는 경우 실시간 서버 성능 지표를 표시합니다.
• 서버 콘솔: "slow tick" 또는 "resource hitch" 경고를 주시하세요.
• resmon 명령어: 서버 콘솔(또는 F8 콘솔)에서 resmon 1을 입력하여 리소스별 CPU 시간을 표시하는 리소스 모니터를 활성화하세요.

일반적인 성능 해결책

권장 사례

• 축적된 메모리 및 엔티티 문제를 해결하기 위해 GPanel의 일정 기능 또는 txAdmin을 사용하여 6-12시간마다 자동 재시작을 예약하세요.
• 성능 수정 및 최적화의 이점을 누리기 위해 리소스를 최신 상태로 유지하세요.
• 중복 기능을 피하세요 — 동일한 작업을 하는 두 개의 리소스(예: 두 개의 날씨 시스템)를 실행하지 마세요.
• 메인 서버에 배포하기 전에 스테이징 서버(또는 낮은 플레이어 수)에서 새 리소스를 테스트하세요.
• 문제를 조기에 포착하기 위해 GPanel 또는 txAdmin을 통해 서버 지표를 정기적으로 모니터링하세요.

일반 문제 해결 팁

1. 항상 서버 콘솔 출력을 읽으세요. 거의 모든 오류에는 무엇이 잘못되었고 어디서 발생했는지 알려주는 메시지가 콘솔에 포함되어 있습니다.
2. 구성 변경 후 서버를 재시작하세요. server.cfg에 대한 대부분의 변경은 적용되려면 전체 서버 재시작이 필요합니다.
3. 문제를 분리하려면 리소스를 하나씩 비활성화하세요. server.cfg의 ensure 줄을 #로 주석 처리하세요.
4. 변경하기 전에 작동하는 구성의 백업을 유지하세요. 주요 업데이트 전에 server.cfg와 데이터베이스를 다운로드하세요.
5. FiveM과 RedM 모두에 적용되는 공식 문서는 docs.fivem.net에서 Cfx.re 포럼과 문서를 확인하세요.
6. 서버 버전과의 리소스 호환성을 확인하세요. 이전 버전용으로 제작된 리소스는 현재 RedM 빌드에서 작동하지 않을 수 있습니다.

관련 문서

• RedM 서버 설정 가이드 — 라이선스 키, server.cfg 구성, 리소스 관리, 연결 방법.
• 서버 IP 및 포트 찾는 방법
• SFTP를 통한 파일 업로드 방법
• 새 서버 시작하기

도움이 필요하신가요?

여전히 RedM 서버에 문제가 있나요? 지원 티켓을 열고 서버 콘솔의 오류 메시지를 포함해 주세요. 저희 팀이 문제를 진단하고 해결하는 데 도움을 드리겠습니다.