FiveM 服务器部署与开发完全指南：从零搭建 GTA5 私人服务器

FiveM 服务器部署与开发完全指南：从零搭建 GTA5 私人服务器

作者：Erpan 标签：FiveM GTA5 游戏服务器 Lua FXServer 原文链接：[CSDN 博客]

一、FiveM 简介

1.1 什么是 FiveM？

FiveM 是 GTA5（侠盗猎车手5）的多人联机修改平台，允许玩家创建和加入私人服务器，体验自定义游戏模式。

1.2 FiveM vs 官方线上模式

二、服务器架构详解

2.1 系统架构图

架构说明：

• FXServer：Cfx 核心服务端，处理网络同步和玩家管理
• 资源系统：Lua 脚本实现游戏逻辑（client/server/shared）
• 数据库：MySQL 存储玩家数据、车辆、房产等
• 管理面板：txAdmin 提供 Web 管理界面

2.2 核心组件

FiveM 服务器
├── FXServer (服务端核心)
│ ├── 网络同步引擎
│ ├── 事件处理系统
│ └── 资源管理器
├── Resources/ (资源文件夹)
│ ├── [资源名]/
│ │ ├── fxmanifest.lua (资源配置)
│ │ ├── client.lua (客户端脚本)
│ │ ├── server.lua (服务端脚本)
│ │ └── shared.lua (共享代码)
├── server.cfg (服务器配置)
└── 数据库 (MySQL)

三、服务器部署教程

3.1 准备工作

系统要求：

需要准备的：

• 一台 VPS/云服务器（推荐阿里云、腾讯云、AWS）
• 正版 GTA5（Steam 或 Epic 版）
• Cfx 账号（https://keymaster.fivem.net/）

3.2 Windows 部署

步骤 1：下载 FXServer

# 创建服务器目录
mkdir C:\\FiveM-Server
cd C:\\FiveM-Server

# 下载 FXServer
# 访问 https://runtime.fivem.net/artifacts/fivem/build_server_windows/master/
# 下载最新版本的 server.zip

步骤 2：配置服务器

创建 server.cfg：

# 服务器基础配置
sv_hostname \”我的 FiveM 服务器\”
sv_maxclients 32
sv_licenseKey \”你的Cfx许可证密钥\”

# 服务器描述
sets sv_projectName \”My FiveM Server\”
sets sv_projectDesc \”一个 awesome 的 FiveM 服务器\”

# 游戏模式
sets gametype \”Roleplay\”
sets mapname \”Los Santos\”

# 资源加载
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode

# 添加自定义资源
ensure my-resource

# 数据库配置 (使用 oxmysql)
set mysql_connection_string \”mysql://root:密码@localhost/fivem?charset=utf8mb4\”

# RCON 密码 (用于远程管理)
rcon_password \”你的强密码\”

# 端口号 (默认 30120)
endpoint_add_tcp \”0.0.0.0:30120\”
endpoint_add_udp \”0.0.0.0:30120\”

步骤 3：获取许可证密钥

步骤 4：启动服务器

# 运行 FXServer
.\\FXServer.exe +exec server.cfg

3.3 Linux 部署（推荐）

步骤 1：系统准备

# Ubuntu/Debian
sudo apt update
sudo apt install -y wget git mariadb-server mariadb-client

# CentOS/RHEL
sudo yum update
sudo yum install -y wget git mariadb-server mariadb

步骤 2：下载并安装 FXServer

# 创建目录
mkdir -p ~/fivem-server
cd ~/fivem-server

# 下载最新版本 (替换为最新链接)
wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/FXServer-linux.zip

# 解压
unzip FXServer-linux.zip
rm FXServer-linux.zip

# 创建资源目录
mkdir -p resources/[local]

步骤 3：配置数据库

# 启动 MariaDB
sudo systemctl start mariadb
sudo systemctl enable mariadb

# 安全配置
sudo mysql_secure_installation

# 创建数据库
sudo mysql -u root -p

# 在 MySQL 中执行
CREATE DATABASE fivem CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER \’fivem\’@\’localhost\’ IDENTIFIED BY \’你的密码\’;
GRANT ALL PRIVILEGES ON fivem.* TO \’fivem\’@\’localhost\’;
FLUSH PRIVILEGES;
EXIT;

步骤 4：创建启动脚本

创建 start.sh：

#!/bin/bash
cd ~/fivem-server
./run.sh +exec server.cfg

赋予执行权限：

chmod +x start.sh

步骤 5：使用 systemd 管理（可选）

创建 /etc/systemd/system/fivem.service：

[Unit]
Description=FiveM Server
After=network.target mysql.service

[Service]
Type=simple
User=fivem
WorkingDirectory=/home/fivem/fivem-server
ExecStart=/home/fivem/fivem-server/run.sh +exec server.cfg
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

启用服务：

sudo systemctl daemon-reload
sudo systemctl enable fivem
sudo systemctl start fivem

3.4 安装 txAdmin 管理面板

# 在 server.cfg 中添加
ensure txAdmin

# 首次启动会显示 txAdmin 访问链接
# 例如: http://localhost:40120

访问 txAdmin 面板：

• 本地：http://localhost:40120
• 远程：http://服务器IP:40120

四、资源开发指南

4.1 资源结构

resources/
└── my-resource/ # 资源文件夹
├── fxmanifest.lua # 资源配置文件（必需）
├── client.lua # 客户端脚本
├── server.lua # 服务端脚本
├── shared.lua # 共享代码
├── config.lua # 配置文件
└── html/ # NUI 界面文件
├── index.html
├── style.css
└── script.js

4.2 fxmanifest.lua 配置

fx_version \’cerulean\’
game \’gta5\’

— 资源信息
name \’My Resource\’
author \’Yo