前言

各位早上，中午，下午，晚上好，我是Fivem的难言，对于刚接触 FiveM 开服的新手小白来说，server.cfg 就是服务器的 “总开关”—— 它控制着服务器能否正常启动、玩家能否顺利连接、游戏体验是否流畅，甚至能决定服务器的安全性。很多新手第一次看到满屏的命令，都会觉得头晕眼花、无从下手，不知道每个命令是干什么的、要不要改、改了会有什么影响。

本文专门为新手小白量身打造，全程用通俗的语言，不堆砌专业黑话，把 server.cfg 里的每一条命令、每一个参数，都讲得明明白白：包括命令的作用、默认值、是否需要手动修改、新手容易踩的坑，以及官方默认没有、但新手开服必加的高级配置。不管你是完全不懂代码的纯小白，还是刚入门的新手服主，跟着我这篇文章学，就能轻松搞定 FiveM 服务器配置，再也不用因为配置出错而卡壳。

一、配置文件基础认知（小白必看，先搞懂核心逻辑）

1. 配置文件的位置（找到它才能修改）

很多新手第一步就找不到 server.cfg，这里明确告诉你：

• 存放目录：server-data 文件夹的根目录（和 FXServer.exe 可执行文件在同一个文件夹里）
• 怎么找到：你下载 FiveM 服务器包后，解压出来会有两个核心文件夹（server 和 server-data），打开 server-data，就能看到 server.cfg 文件（后缀是 .cfg，用记事本、Notepad++ 都能打开编辑）

2. 配置文件的加载方式（知道怎么生效）

修改完配置文件后，不是直接保存就有用，需要启动服务器时加载它：

• 启动命令：双击 FXServer.exe 后，服务器会自动加载 server-data 里的 server.cfg（默认加载）
• 手动加载（备用）：如果你的配置文件不在默认位置，或者改了文件名，可以用命令 FXServer.exe +exec 配置文件名.cfg 加载（比如 FXServer.exe +exec myserver.cfg）
• 新手提示：修改配置后，必须重启服务器，修改才能生效，只保存不重启是没用的！

3. 三大核心变量指令（新手不用记，看懂区别就行）

配置文件里经常会看到 set、sets、setr 这三个命令，很多新手不知道它们的区别，其实很简单，用表格就能看明白，不用死记硬背：

指令	作用范围	通俗用途	新手示例
set	仅服务器内部生效（玩家看不到）	定义服务器自己用的 “秘密变量”，比如数据库密码、内部参数	set mysql_password "123456"（数据库密码，玩家看不到）
sets	服务器 + 公共列表可见（玩家能看到）	展示服务器的公开信息，比如服务器名称、描述、标签	sets tags "qbcore,中文,rp"（玩家在服务器列表能看到这些标签）
setr	服务器 + 所有客户端同步（玩家和脚本都能读取）	定义全局通用的变量，比如服务器倍率、活动开关	setr server_rate 1.5（脚本和玩家都能获取这个倍率参数）

4. 配置文件拆分（新手推荐，整洁好维护）

如果你的服务器配置很多，把所有命令都写在 server.cfg 里，会显得很乱，后期修改也麻烦。新手可以把配置拆分成多个文件，比如把资源加载、权限设置单独放一个文件，用 exec 命令导入，这样更整洁：

# 导入资源加载配置（单独放在resources.cfg里）
exec resources.cfg
# 导入权限配置（单独放在permissions.cfg里）
exec permissions.cfg

• 新手提示：拆分后，修改资源或权限时，只需要改对应的 resources.cfg 或 permissions.cfg，不用动主配置文件，不容易出错。

二、基础必备核心配置（必改 / 必加，缺一不可）

这部分是服务器能正常启动、玩家能正常连接的基础，新手必须掌握，每一条都要仔细看，不能漏！

1. 端口监听配置（服务器的 “大门”，必须开对）

# 绑定TCP端口（用于玩家连接、数据传输）
endpoint_add_tcp "0.0.0.0:30120"
# 绑定UDP端口（用于游戏内同步、语音等）
endpoint_add_udp "0.0.0.0:30120"
# 主端口（用于服务器心跳、注册到FiveM列表）
netPort 30120

• 通俗解释：这三条命令是给服务器开 “大门”，玩家就是通过这个 “大门”（端口 30120）连接到你的服务器的。
• 默认值：30120（新手不用改，除非这个端口被其他软件占用）
• 新手必看坑：
  1. 端口必须同时开放 TCP 和 UDP（防火墙要放行这两个端口，不然玩家进不来）
  2. 如果你想同时开多个服务器（比如开一个 RP 服、一个娱乐服），就要改端口，比如第二个服务器用 30121，第三个用 30122，避免端口冲突
  3. 怎么检查端口是否被占用？打开电脑 “任务管理器”→“详细信息”，搜索 “30120”，如果有进程占用，就改端口

2. 许可证密钥配置（服务器的 “身份证”，必须有）

# 填写从Cfx.re Keymaster获取的许可证密钥
sv_licenseKey "你的许可证密钥"

• 通俗解释：这个密钥相当于服务器的 “身份证”，没有它，服务器根本启动不了，就像没有身份证不能坐飞机一样。
• 新手必做：
  1. 怎么获取密钥？打开浏览器，访问 https://keymaster.fivem.net/ ，登录你的 CFX 账号，创建一个新的服务器，就能获取密钥
  2. 复制密钥时，不要复制多余的空格，粘贴到引号里（比如 sv_licenseKey "abc123def456"），否则会提示 “密钥无效”
  3. 每个密钥对应一个服务器，不能多个服务器共用一个密钥

3. 服务器名称配置（玩家看到的 “服务器名字”）

# 服务器在公共列表中显示的名称
sv_hostname "【中文社区】QBCore角色扮演服务器 | 新手友好 | 无挂"

• 通俗解释：这个名称会显示在 FiveM 服务器列表里，玩家就是通过这个名称找到你的服务器的。
• 新手提示：
  1. 名称不要太长（建议不超过 50 个字符），否则会显示不全
  2. 可以加一些关键词（比如 “中文”“新手友好”“QBCore”），方便玩家搜索到你的服务器
  3. 不要加特殊符号（比如 @、#、$），可能会导致名称显示异常

三、服务器列表展示配置（让玩家更容易找到你）

这部分配置不影响服务器启动，但能让你的服务器在公共列表里更显眼，吸引更多玩家加入，新手建议都配置好。

1. 基础展示信息（必加，提升曝光）

# 服务器项目名称（相当于社区标识，可自定义）
sets sv_projectName "FiveM新手社区"
# 服务器简介（简要说明服务器类型、特色，不超过100字符）
sets sv_projectDesc "新手入门必玩 | QBCore框架 | 无挂纯净 | 全程指导"
# 服务器标签（关键词，提高搜索率，用逗号分隔）
sets tags "roleplay,qbcore,中文,新手,无挂,rp"
# 服务器语言（设置为中文，玩家在中文列表里更容易找到）
sets locale "zh-CN"
# 加载服务器图标（显示在服务器列表左侧，必须是96×96像素的PNG图片）
load_server_icon "logo.png"

• 新手详解：
  1. sv_projectDesc：不要写太长，突出核心特色（比如 “新手友好”“无挂”“有教程”），新手玩家更关注这些
  2. tags：关键词越精准越好，比如你是 RP 服，就加 “roleplay”“rp”；是娱乐服，就加 “minigame”“娱乐”；中文服一定要加 “中文”
  3. load_server_icon：图片要放在 server-data 文件夹里，名字必须和命令里的一致（比如命令写 “logo.png”，图片就叫 “logo.png”），尺寸不对会显示异常

2. 可选横幅配置（手动添加，更美观）

这两个配置官方默认没有，新手可以手动添加，让服务器更有辨识度：

# 服务器列表详情页的大图（横幅，建议尺寸1000×250像素，仅支持HTTPS链接）
sets banner_detail "https://cdn.example.com/banner_detail.png"
# 玩家连接服务器时，加载页面显示的图片（建议尺寸800×450像素，仅支持HTTPS链接）
sets banner_connecting "https://cdn.example.com/banner_connecting.png"

• 新手提示：
  1. 图片链接必须是 HTTPS 的（HTTP 链接不支持，会显示不了）
  2. 可以用免费图床（比如阿里云图床、腾讯云图床）上传图片，获取 HTTPS 链接
  3. 图片内容可以放服务器 LOGO、特色玩法介绍，吸引玩家等待加载

3. 服务器隐私与可见性（新手根据需求设置）

# 隐藏玩家IP地址（推荐开启，保护玩家隐私，防止恶意攻击）
sv_endpointPrivacy true
# 设为私有服务器（不在公共列表显示，仅邀请的玩家能连接，新手不推荐）
# sv_master1 ""

• 新手详解：
  1. sv_endpointPrivacy true：一定要开启，不然玩家的 IP 会被其他人看到，可能会被恶意攻击
  2. sv_master1 ""：前面加 “#” 表示注释（命令不生效），如果想做私人服务器（比如只和朋友玩），就删掉 “#”，这样服务器就不会出现在公共列表里

四、玩家人数 & 游戏版本配置（控制服务器规模和兼容性）

这部分配置决定了你的服务器能容纳多少玩家，以及玩家需要什么版本的 GTA5 才能连接，新手容易在这里出错，一定要仔细看。

1. 最大玩家数限制

# 服务器最大可容纳的玩家数量（范围1～2048）
sv_maxclients 64

• 通俗解释：就是你的服务器最多能同时在线多少个玩家，比如设为 64，就最多能有 64 个玩家同时在线。
• 新手必看：
  1. 新手开服，建议先设为 32 或 64（人数太多，服务器负载会变大，容易卡顿）
  2. 32 人以上必须启用 OneSync（后面会讲），否则玩家会出现同步异常（比如看不到其他玩家、实体消失）
  3. 64 人以上建议启用 OneSync Infinity 模式，并且优化服务器配置（比如加内存、优化脚本）
  4. 2048 人需要开通 CFX 的 Platinum 会员（新手不推荐，成本太高）

2. 强制客户端游戏版本（避免玩家版本不匹配）

# 强制所有玩家使用指定版本的GTA5，不匹配则无法连接
sv_enforceGameBuild 3407
# 也可以用版本别名（更直观，新手推荐）
# sv_enforceGameBuild mp2024_02

• 通俗解释：GTA5 会不断更新，不同版本的游戏文件不一样，如果玩家的游戏版本和服务器强制的版本不匹配，就进不来服务器。
• 新手必看：
  1. 为什么要强制版本？比如你的服务器用了某个需要新版本的脚本（比如新载具、新地图），如果玩家版本太低，就会报错、闪退
  2. 常用版本对照表（新手直接用 3407 或 mp2024_02 即可，兼容性最好）：

表格

版本号	版本别名	对应 GTA5 更新内容	新手适配性
2944	mp2023_01	San Andreas Mercenaries（圣安地列斯雇佣兵）	兼容性一般，不推荐新手
3095	mp2023_02	The Chop Shop（改装店）	兼容性较好，部分脚本支持
3258	mp2024_01	Bottom Dollar Bounties（赏金任务）	兼容性好，推荐新手
3407	mp2024_02	Agents of Sabotage（破坏者特工）	最新稳定版，兼容性最好，强烈推荐
3570	mp2025_01	Money Fronts（洗钱前线）	较新，部分脚本可能未适配，不推荐新手

1. 新手建议：直接用 sv_enforceGameBuild 3407，这个版本最稳定，大部分脚本都支持，玩家也容易更新到这个版本

五、OneSync 完整配置解析（新手必懂，解决同步问题）

很多新手开服后，会遇到 “看不到其他玩家”“载具消失”“人物卡顿” 等问题，其实都是因为没配置 OneSync。OneSync 是 FiveM 的网络同步引擎，简单说，就是让所有玩家在同一个服务器里 “看到一样的东西”，没有它，服务器就会混乱。

1. OneSync 基础开启（必加，新手默认开启这个）

# 启用OneSync Infinity模式（推荐新手使用，支持高人数、无限实体）
set onesync on
# 启用OneSync legacy模式（老旧兼容模式，仅用于旧脚本，新手不推荐）
# set onesync legacy

• 新手详解：
  1. set onesync on：这是新手必加的命令，开启后，玩家之间的同步会更流畅，不会出现看不到其他玩家、实体消失的问题
  2. set onesync legacy：只有你的服务器用了很老旧的脚本（比如几年前的脚本），才需要用这个模式，否则会出现同步异常
  3. 注意：开启 OneSync 后，sv_maxclients 才能设为 32 以上，否则同步会出问题

2. 官方默认没有、新手必加的 OneSync 高级参数

这些参数官方默认不会写在 server.cfg 里，但新手开服一定要手动添加，能解决很多同步和性能问题：

# 启用服务器控制的NPC生成（解决新手常见的“NPC消失”问题）
set onesync_population on
# 优化远距离载具渲染（减少服务器负载，避免高人数时卡顿）
set onesync_distanceCullVehicles true
# 强制实体迁移（解决“实体卡主”“玩家瞬移”问题，高人数服必加）
set onesync_forceMigration true
# 启用无限实体ID（支持128+玩家，避免实体ID不够用导致的报错）
set onesync_enableInfinity true

• 新手通俗解释：
  1. onesync_population on：开启后，服务器会统一控制路人 NPC 的生成，不会出现有的玩家能看到 NPC、有的玩家看不到的情况
  2. onesync_distanceCullVehicles true：远处的载具会自动优化渲染，不会占用太多服务器资源，服务器人数多的时候，卡顿会减少
  3. onesync_forceMigration true：比如玩家从 A 区域走到 B 区域，玩家的 “实体” 会自动迁移到对应的服务器节点，不会出现卡主、瞬移的情况

六、资源加载命令全解（新手必学，控制服务器功能）

资源（比如脚本、地图、载具）是服务器的核心功能，比如聊天系统、背包系统、警察职业，都是靠资源实现的。新手必须学会怎么加载、停止、重启资源，不然服务器就只有基础功能，没有特色。

1. 常用资源加载命令（新手记这 5 个就够了）

命令	功能说明（通俗版）	新手示例	注意事项
start 资源名	启动指定的单个资源	start chat（启动聊天系统）	资源名必须和 resources 文件夹里的文件夹名一致，否则启动失败
stop 资源名	停止指定的单个资源	stop chat（停止聊天系统）	停止后，玩家就不能使用这个资源的功能了（比如停止 chat 后，玩家不能聊天）
ensure 资源名	常驻资源，掉线自动重启	ensure qb-core（常驻框架核心）	新手推荐用这个命令加载核心资源（比如框架、数据库），防止资源掉线导致服务器崩溃
restart 资源名	重启指定的单个资源	restart qb-inventory（重启背包系统）	修改资源配置后，用这个命令重启，不用重启整个服务器
refresh	重新扫描 resources 文件夹	refresh	新增资源后，用这个命令扫描，服务器才能识别到新资源，之后再用 start/ensure 启动

2. 新手推荐的资源加载顺序（避免报错）

很多新手加载资源时，随便写顺序，导致脚本报错（比如 “找不到框架”“数据库连接失败”）。资源加载有先后顺序，核心资源要先加载，具体顺序如下（新手直接复制粘贴到配置里即可）：

# 第一步：加载数据库连接器（必须最先加载，否则其他需要数据库的资源会报错）
ensure oxmysql
# 第二步：加载框架核心（QBCore或ESX，二选一，新手推荐QBCore）
ensure qb-core
# ensure es_extended  # 如果用ESX框架，就启用这个，注释掉上面的qb-core
# 第三步：加载基础系统（服务器必备，缺一不可）
ensure mapmanager  # 地图管理
ensure chat  # 聊天系统
ensure spawnmanager  # 出生点管理
ensure sessionmanager  # 会话管理
ensure baseevents  # 基础事件
# 第四步：加载管理工具（服主管理服务器用）
ensure qb-adminmenu  # QBCore管理员菜单
# 第五步：加载游戏玩法资源（根据自己的服务器类型添加）
ensure qb-inventory  # 背包系统
ensure qb-policejob  # 警察职业
ensure qb-ambulancejob  # 医生职业
# 第六步：加载自定义资源（自己添加的脚本、地图）
ensure my-custom-script  # 自己的自定义脚本

• 新手必看坑：
  1. 不要用 ensure *（加载所有资源），虽然方便，但会导致加载顺序混乱，容易报错，正式服绝对不要用
  2. 资源名必须和 resources 文件夹里的文件夹名完全一致（比如文件夹叫 “qb-inventory”，命令就必须写 “ensure qb-inventory”，不能少字母、不能多空格）
  3. 新增资源后，先执行 refresh，再执行 ensure 资源名，否则服务器识别不到

3. 新手常见资源加载错误及解决办法

错误现象	可能原因	解决办法
提示 “resource not found”	资源名写错，或资源文件夹不在 resources 里	检查资源名是否正确，把资源文件夹放到 resources 里
提示 “dependency missing”	依赖资源没加载（比如加载背包系统，没加载框架核心）	先加载依赖资源（比如先加载 qb-core，再加载 qb-inventory）
资源加载成功，但功能用不了	资源配置错误，或没有重启资源	检查资源的配置文件，修改后用 restart 资源名 重启

七、安全防护配置（新手必加，防止服务器被攻击、被作弊）

新手开服最容易忽略安全配置，导致服务器被作弊者攻击、篡改，甚至被封。这部分配置能有效提升服务器安全性，新手一定要全部配置好，不要偷懒。

1. 基础安全配置（必加，零门槛）

# 禁用客户端脚本钩子（防止作弊者注入恶意脚本，必设为0）
sv_scriptHookAllowed 0
# 启用纯净模式（拦截客户端修改的游戏文件，防止作弊）
# 1：阻止部分修改；2：阻止所有修改（新手推荐设为2）
sv_pureLevel 2
# 隐藏玩家IP地址（保护玩家隐私，防止恶意攻击，必设为true）
sv_endpointPrivacy true
# 设置RCon密码（远程管理服务器的密码，防止别人恶意操作）
rcon_password "StrongPassword123456"

• 新手通俗解释：
  1. sv_scriptHookAllowed 0：这个是防作弊的核心，设为 0 后，作弊者就不能在客户端注入恶意脚本（比如透视、穿墙），设为 1 会被作弊者钻空子
  2. sv_pureLevel 2：设为 2 后，玩家不能修改游戏里的任何文件（比如替换载具、修改皮肤），避免作弊者用修改后的文件作弊
  3. rcon_password：这个密码是远程管理服务器的密码，一定要设强密码（比如字母 + 数字 + 符号），不要用 “123456”“admin”，否则别人能轻易远程控制你的服务器

2. 手动添加的进阶安全配置（新手必加，提升防护）

这些配置官方默认没有，新手手动添加，能进一步防止服务器被攻击、被刷：

# 防止HTTP洪水攻击（1：阻止带Via头的恶意请求，新手设为1即可）
sv_requestParanoia 1
# 阻止玩家控制其他玩家的实体（防止恶意篡改他人角色、载具）
sv_filterRequestControl 2
# 阻止特定网络事件（防止作弊者利用网络事件作弊，新手直接复制即可）
block_net_game_event "FIRE_EVENT"
# 禁用网络声音事件（防止作弊者用恶意声音事件骚扰玩家、崩溃服务器）
sv_enableNetworkedSounds false

• 新手提示：这些配置直接复制粘贴到安全配置里即可，不用修改，启用后能有效减少作弊和攻击。

八、ACL 权限系统配置（新手必学，管理服务器权限）

ACL 权限系统是用来管理服务器权限的，比如谁能当管理员、谁能使用管理员命令（比如踢人、封禁）、谁能修改服务器配置。新手学会这个，就能轻松管理自己的服务器，防止别人恶意操作。

1. 基础权限配置（新手直接复制使用）

# 1. 创建管理员组（组名可以自定义，比如group.admin）
add_principal group.admin group.user
# 2. 允许管理员组使用所有命令（比如踢人、封禁、重启资源）
add_ace group.admin command allow
# 3. 禁止管理员组使用“关闭服务器”命令（防止误操作关闭服务器）
add_ace group.admin command.quit deny
# 4. 给指定玩家添加管理员权限（替换成自己的标识符）
add_principal identifier.steam:110000112345678 group.admin

• 新手详解：
  1. group.admin：是管理员组的名称，你可以改成自己喜欢的（比如 group.owner、group.mod），但要保持一致
  2. identifier.steam:110000112345678：是玩家的唯一标识符，每个玩家都有，新手怎么获取？
     • 玩家进入服务器后，服主打开服务器控制台，输入 list，就能看到所有在线玩家的标识符（比如 steam、license 开头的）
     • 复制玩家的标识符，替换上面的 “110000112345678”，就能给这个玩家添加管理员权限
  3. 常用标识符类型：steam（Steam 账号）、license（FiveM 许可证）、fivem（FiveM 账号），新手用 license 标识符最方便，也是社区内最常用的标识符

2. 新手常见权限问题及解决办法

问题现象	可能原因	解决办法
管理员不能使用命令	没有给管理员组添加对应权限，或标识符写错	检查 add_ace group.admin command allow 是否添加，核对标识符是否正确
管理员能关闭服务器	没有禁止管理员使用 command.quit 命令	添加 add_ace group.admin command.quit deny
普通玩家能使用管理员命令	给普通玩家添加了管理员权限，或权限配置错误	检查 add_principal 命令，删除普通玩家的管理员权限

九、数据库 & 第三方对接配置（新手必懂，存储玩家数据）

服务器需要数据库来存储玩家数据（比如等级、金钱、背包、角色信息），如果没有数据库，玩家退出服务器后，数据会全部丢失。新手最常用的是 MySQL 数据库，这里详细讲怎么配置。

1. MySQL 数据库连接配置（必加，新手重点）

# 方法1：txAdmin推荐格式（新手推荐，不容易出错）
set mysql_connection_string "user=root;password=123456;host=127.0.0.1;database=fivemdb"
# 方法2：旧格式（兼容部分老旧脚本）
# set mysql_connection_string "mysql://root:123456@localhost:3306/fivemdb"

• 新手详解（一步步教你改）：
  1. user=root：数据库用户名，新手默认是 root（不用改）
  2. password=123456：数据库密码，替换成你自己的 MySQL 密码（比如你安装 MySQL 时设置的密码）
  3. host=127.0.0.1：数据库地址，新手用本地数据库（127.0.0.1），不用改
  4. database=fivemdb：数据库名称，新手可以自定义（比如 fivem_rp、fivem_server），但要先在 MySQL 里创建这个数据库
• 新手必做步骤：
  1. 安装 MySQL（新手推荐用 XAMPP，自带 MySQL，简单易操作）
  2. 打开 MySQL，创建一个数据库（比如叫 fivemdb）
  3. 把数据库密码、数据库名称，替换到上面的命令里
  4. 加载 oxmysql 资源（前面资源加载里已经加了），否则数据库连接不上

2. 其他第三方对接配置（新手可选）

如果你的服务器需要用到商店、Steam 登录等功能，可以添加以下配置，新手暂时用不到可以先注释（加 #）：

# Tebex商店对接（用于服务器充值、购买道具，需要获取Tebex密钥）
sv_tebexSecret "你的Tebex密钥"
# Steam API对接（用于获取Steam玩家信息，比如Steam昵称、头像）
steam_webApiKey "你的Steam API密钥"

• 新手提示：这些对接需要先注册对应平台（Tebex、Steam 开发者平台），获取密钥，新手暂时不用可以先不配置。

十、默认没有、新手必加的性能优化参数（解决卡顿、报错）

很多新手开服后，会遇到服务器卡顿、CPU 占用过高、模型丢失等问题，其实是没有添加性能优化参数。这些参数官方默认没有，新手手动添加，能大幅提升服务器性能，减少卡顿和报错。

1. 基础性能优化参数（必加）

# 优化状态包序列化（减少服务器负载，提升同步流畅度）
sv_experimentalStateBagsHandler true
# 优化网络事件处理（减少卡顿，避免网络事件堵塞）
sv_experimentalNetGameEventHandler true
# 优化游戏版本切换（减少客户端下载量，避免玩家进服卡顿）
sv_replaceExeToSwitchBuilds false

• 新手通俗解释：这些参数都是优化服务器性能的，直接复制粘贴即可，不用修改，启用后能明显感觉到服务器更流畅。

2. 内存池扩容配置（解决模型丢失、实体上限问题）

新手开服时，经常会遇到 “载具模型丢失”“自定义物体加载失败”“实体报错” 等问题，这是因为服务器的内存池不够用，需要手动扩容：

# 增加纹理存储池大小（解决纹理丢失、模型加载失败，新手设为6000即可）
increase_pool_size "TxdStore" 6000
# 增加动画存储池大小（解决动画报错、动作异常，新手设为20480即可）
increase_pool_size "AnimStore" 20480
# 增加物体实例池大小（解决自定义物体加载失败，新手设为2000即可）
increase_pool_size "Object" 2000
# 增加光源实体池大小（解决灯光异常，新手设为1000即可）
increase_pool_size "LightEntity" 1000

• 新手提示：
  1. 这些参数的数值不要改太大（按上面的数值来），改太大反而会占用更多服务器内存
  2. 如果你的服务器有很多自定义载具、地图，就需要适当增加数值；如果是小服（32 人以下），按上面的数值即可

3. 网络优化参数（高人数服必加，新手小服可选）

如果你的服务器人数较多（64 人以上），可以添加以下网络优化参数，减少卡顿和延迟：

# 最大数据包数（优化网络传输，新手设为1000即可）
net_maxPackets 1000
# 最大数据包大小（优化数据传输效率，新手设为1300即可）
net_maxPacketSize 1300
# 每个IP的最大并发连接数（防止恶意多开，新手设为32即可）
net_tcpConnLimit 32

十一、新手专用 生产版 server.cfg 完整模板（直接复制使用）

很多新手不想自己一点点写配置，这里给大家准备了一份新手专用的生产版模板，直接复制粘贴到 server.cfg 里，修改几个关键参数（比如许可证密钥、数据库密码），就能直接启动服务器，不用再修改其他内容。

# -------------------------- 端口配置（新手不用改）--------------------------
# 绑定TCP/UDP端口，玩家通过这个端口连接服务器
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
netPort 30120
# 每个IP最大并发连接数，防止恶意多开
net_tcpConnLimit 32

# -------------------------- 核心配置（新手必须改）--------------------------
# 填写你的CFX许可证密钥（从Keymaster获取）
sv_licenseKey "你的许可证密钥"
# 服务器名称（在公共列表显示，可自定义）
sv_hostname "【新手友好】QBCore角色扮演服务器 | 无挂纯净 | 全程指导"
# 最大玩家数（新手推荐32或64）
sv_maxclients 64
# 强制游戏版本（新手推荐3407，兼容性最好）
sv_enforceGameBuild 3407
# 优化版本切换，减少客户端卡顿
sv_replaceExeToSwitchBuilds false

# -------------------------- 服务器展示（新手可自定义）--------------------------
# 项目名称（社区标识）
sets sv_projectName "FiveM新手社区"
# 服务器简介（不超过100字符）
sets sv_projectDesc "新手入门必玩 | 无挂纯净 | QBCore框架 | 背包/职业/地图齐全"
# 服务器标签（提高搜索率）
sets tags "roleplay,qbcore,中文,新手,无挂,rp,入门"
# 服务器语言（中文）
sets locale "zh-CN"
# 服务器图标（96×96 PNG，放在server-data文件夹）
load_server_icon "logo.png"
# 服务器横幅（可选，HTTPS链接）
sets banner_detail "https://cdn.example.com/banner_detail.png"
sets banner_connecting "https://cdn.example.com/banner_connecting.png"

# -------------------------- 安全设置（新手不用改）--------------------------
# 隐藏玩家IP，保护隐私
sv_endpointPrivacy true
# 禁用客户端脚本钩子，防作弊
sv_scriptHookAllowed 0
# 最高纯净模式，拦截客户端修改
sv_pureLevel 2
# RCon密码（设为强密码，比如字母+数字+符号）
rcon_password "StrongPassword123456"
# 防止HTTP洪水攻击
sv_requestParanoia 1
# 阻止恶意控制他人实体
sv_filterRequestControl 2

# -------------------------- OneSync配置（新手不用改）--------------------------
# 启用OneSync Infinity模式，解决同步问题
set onesync on
# 服务器控制NPC生成，避免NPC消失
set onesync_population on
# 优化远距离载具渲染，减少卡顿
set onesync_distanceCullVehicles true
# 强制实体迁移，解决卡主问题
set onesync_forceMigration true

# -------------------------- 性能优化（新手不用改）--------------------------
# 优化状态包同步
sv_experimentalStateBagsHandler true
# 优化网络事件处理
sv_experimentalNetGameEventHandler true
# 内存池扩容，解决模型丢失
increase_pool_size "TxdStore" 6000
increase_pool_size "AnimStore" 20480
increase_pool_size "Object" 2000

# -------------------------- 数据库配置（新手必须改）--------------------------
# MySQL连接配置，替换成自己的数据库密码和数据库名称
set mysql_connection_string "user=root;password=你的数据库密码;host=127.0.0.1;database=你的数据库名称"

# -------------------------- 资源加载（新手不用改，按需添加）--------------------------
# 导入资源和权限配置（如果拆分了的话）
# exec resources.cfg
# exec permissions.cfg

# 加载数据库连接器
ensure oxmysql
# 加载QBCore框架核心
ensure qb-core
# 加载基础系统
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure baseevents
# 加载管理员菜单
ensure qb-adminmenu
# 加载游戏玩法资源
ensure qb-inventory
ensure qb-policejob
ensure qb-ambulancejob
# 加载自定义资源（自己添加的脚本）
# ensure my-custom-script

# -------------------------- 权限配置（新手替换自己的标识符）--------------------------
# 创建管理员组
add_principal group.admin group.user
# 允许管理员使用所有命令
add_ace group.admin command allow
# 禁止管理员关闭服务器
add_ace group.admin command.quit deny
# 给指定玩家添加管理员权限（替换成自己的Steam标识符）
add_principal identifier.steam:你的Steam标识符 group.admin

• 新手必改的 3 个地方（其他不用动）：
  1. sv_licenseKey "你的许可证密钥"：替换成你从 Keymaster 获取的密钥
  2. set mysql_connection_string "user=root;password=你的数据库密码;host=127.0.0.1;database=你的数据库名称"：替换成你的 MySQL 密码和数据库名称
  3. add_principal identifier.steam:你的Steam标识符 group.admin：替换成你自己的 Steam 标识符

十二、新手常见配置报错排错（遇到问题不用慌）

新手配置服务器时，很容易遇到各种报错，这里整理了最常见的 5 种报错，告诉大家原因和解决办法，遇到问题直接对照查找，不用再到处问人。

故障现象	可能原因	解决办法
服务器启动失败，提示 “Invalid license key”	许可证密钥错误、为空，或复制时多了空格	重新获取密钥，确保密钥正确，粘贴时没有多余空格
服务器启动成功，但在公共列表里刷不到	缺少 tags、locale 配置，或端口未开放	补全 sets tags、sets locale "zh-CN"，开放 30120 TCP+UDP 端口
玩家能看到服务器，但连接失败，提示 “Connection failed”	端口被占用、防火墙未放行，或游戏版本不匹配	更换端口，放行防火墙端口，让玩家更新游戏版本到 3407
玩家进服后，看不到其他玩家、载具消失	未启用 OneSync，或 OneSync 配置错误	确保 set onesync on，并添加 OneSync 高级参数
服务器卡顿、CPU 占用过高	玩家数过多、脚本冗余，或未添加性能优化参数	降低 sv_maxclients，优化冗余脚本，添加性能优化参数和内存池扩容参数
提示 “MySQL connection failed”	数据库密码错误、数据库未创建，或 oxmysql 未加载	核对数据库密码和名称，创建对应数据库，确保 ensure oxmysql 已加载

十三、新手开服额外注意事项（必看，少走弯路）

1. 修改配置文件时，一定要用记事本、Notepad++ 等纯文本编辑器，不要用 Word（会添加多余格式，导致配置报错）。
2. 所有命令后面的注释（加 #的内容），只是用来解释命令的，不会生效，新手可以保留，方便后期查看。
3. 新手开服，建议先从 32 人小服开始，熟悉配置和脚本后，再逐步增加人数，避免服务器负载过大。
4. 定期备份服务器配置文件和数据库，防止配置出错、数据丢失，备份时直接复制 server.cfg 和数据库文件即可。
5. 不要随意添加来源不明的脚本（资源），很多恶意脚本会导致服务器被攻击、被封，新手建议从官方社区、正规论坛下载资源。
6. 如果遇到解决不了的配置问题，可以去 CFX 中文社区、FiveM 新手群求助，不要盲目修改配置，以免导致服务器崩溃。

总结

对于新手小白来说，server.cfg 配置其实没有那么难，核心就是记住 “基础配置必改、安全配置必加、优化配置必添” 这三个原则。本文从新手的角度，把每个命令、每个参数都讲得通俗易懂，还提供了可直接复制使用的模板和排错方法，只要跟着本文一步步操作，就能轻松搞定 FiveM 服务器配置，顺利开服。

新手不用追求一次性配置完美，先把服务器启动起来，能让玩家正常连接、正常玩，再逐步优化配置、添加特色资源，慢慢提升服务器体验就好。

如果您在服务器配置中遇到任何疑难杂症，可以在评论区发送你遇到的问题，我逛论坛看见了会回复~