设置服务器

设置FXServer的分步指南。

FXServer是当前CitizenFX服务器版本的名称。此页面显示了如何运行它。

运行服务端时遇到问题?请访问疑难问题解答,使用 Discord #fxserver-support 频道或在论坛的 Server Discussion 子类别中创建主题。

开始之前

Make sure you have registered a license key on the Cfx.re Keymaster service. You need to have the IP match the IP on which you’re going to first use the key. Afterwards, the key can be used on any IP, but only on one server at a time.

传统安装步骤

Windows

先决条件

  1. Visual C++ Redistributable 2019 或最新版
  2. 确保正确安装Git环境。

安装

  1. 创建一个新目录(比如 D:\FXServer\server),这将用于存放服务端文件。

  2. 构建服务器下载适用于Windows的最新master分支版本。

  3. 将构建解文件解压到先前创建的目录中。
    3.1 使用任何压缩文件工具(例如WinRAR或7-Zip)。

  4. cfx-server-data 克隆到服务端文件夹之外的新文件夹中。例如 D:\FXServer\server-data
    4.1 git clone https://github.com/citizenfx/cfx-server-data.git server-data

  5. server-data 文件夹中创建一个 server.cfg 文件(将下面的示例 server.cfg 文件复制到该文件中)。

  6. https://keymaster.fivem.net 上生成许可证密钥。

  7. 在server.cfg中设置许可证密钥至 sv_licenseKey "licenseKeyGoesHere"

  8. server-data 文件夹中运行服务。在纯Windows命令提示符(cmd.exe)窗口中输入如下命令:

    cd /d D:\FXServer\server-data
    D:\FXServer\server\FXServer.exe +exec server.cfg
    

    (仅在将目录更改为其他驱动器上的某个位置时才需要使用 /d 命令)


Linux

  1. 创建一个新目录(比如 mkdir /home/username/FXServer/server),这将用于存放服务端文件。
  2. 构建服务器下载适用于Linux的最新master分支版本。(复制最新服务器版本的URL并使用 wget <url> 进行下载)。
  3. 将构建解文件压缩到先前创建的目录中,使用 cd /home/username/FXServer/server && tar xf fx.tar.xz 解压缩(你需要 xz 解压缩软件,在Debian / Ubuntu上,这在 xz-utils 软件包中)。
  4. cfx-server-data 克隆到服务端文件夹之外的新文件夹中。
    4.1 例如 git clone https://github.com/citizenfx/cfx-server-data.git /home/username/FXServer/server-data
  5. server-data 文件夹中创建一个 server.cfg 文件(将下面的示例 server.cfg 文件复制到该文件中)。
  6. https://keymaster.fivem.net 上生成许可证密钥。
  7. 在server.cfg中设置许可证密钥至 sv_licenseKey "licenseKeyGoesHere"
  8. server-data 文件夹中运行服务。
    8.1 bash /home/username/FXServer/server/run.sh +exec server.cfg

常见问题

  • 如果提示 resources found,并且提示 Failed to start resource,则你没有 cd 至正确的目录。
  • 如果没有资源开始启动,并且你无法成功连接,那是因为你在启动时没有加 +exec 命令。
  • 如果提示 no license key was specified,总有上面某个情况适用。

server.cfg

下面是一个示例 server.cfg 文件。

# 只有在使用具有多个网络接口的服务器时才更改IP,否则只更改端口。
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# 默认情况下,这些资源将启动。
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure rconlog

# 这允许玩家使用基于scripthook的插件,比如传统的Lambda菜单。
# 将此设置为1以允许scripthook。请注意,这并不能保证玩家不能使用外部插件。
sv_scriptHookAllowed 0

# 取消注释并设置密码以启用RCON。请确保更改密码 - 它应该看起来像 rcon_password "YOURPASSWORD"
#rcon_password ""

# 服务器的标签使用逗号分隔列表。
# 例如:
# - sets tags "drifting, cars, racing"
# 或者:
# - sets tags "roleplay, military, tanks"
sets tags "default"

# 服务器主语言的有效区域设置标识符。
# 比如 "en-US", "fr-CA", "nl-NL", "de-DE", "en-GB", "pt-BR", "zh-CN", "zh-HK"
sets locale "root-AQ" 
# :)请用真实的语言替换上面的 root-AQ :)

# 设置可选的服务器信息和连接横幅图像url。
# 大小无关紧要,任何横幅大小的图像都可以。
#sets banner_detail "https://url.to/image.png"
#sets banner_connecting "https://url.to/image.png"

# 设置服务器的主机名
sv_hostname "FXServer, but unconfigured"

# 嵌套配置
#exec server_internal.cfg

# 加载服务器图标(96x96 PNG文件)
#load_server_icon myLogo.png

# 可用于脚本的转换器
set temp_convar "hey world!"

# Remove the `#` from the below line if you do not want your server to be listed in the server browser.
# Do not edit it if you *do* want your server listed.
#sv_master1 ""

# 添加系统管理员
add_ace group.admin command allow # allow all commands
add_ace group.admin command.quit deny # but don't allow quit
add_principal identifier.fivem:1 group.admin # add the admin to the group

# enable OneSync (required for server-side state awareness)
set onesync on

# Server player slot limit (see https://fivem.net/server-hosting for limits)
sv_maxclients 48

# Steam Web API密钥,如果要使用Steam身份验证 (https://steamcommunity.com/dev/apikey)
# -> replace "" with the key
set steam_webApiKey ""

# 服务器的许可证密钥 (https://keymaster.fivem.net)
sv_licenseKey changeme

之后开始做什么?