FiveM Server Docker 镜像

**FiveM Server Docker 镜像**

**fivem-docker** — 一个适用于 FiveM 服务器的灵活 Docker 镜像
这是一个轻量级、可重用的 Docker 镜像，用于运行任何 FiveM 服务器。镜像中没有任何预置内容——您可以在运行时选择所需的版本，并将其指向您的资源文件。

**功能特点：**
– **运行时选择版本**：您可以通过设置 `FXSERVER_VERSION` 来选择版本，该版本可以是构建编号、固定的哈希值或通道（推荐使用 `/latest`、`critical` 或 `optional`）。镜像会在启动时下载并缓存；通过重启即可切换版本。
– **资源与配置管理**：您可以将主机上的资源文件挂载到容器中，或者让容器在启动时从 Git 仓库中拉取资源文件（支持单仓库或分离的资源/配置仓库）。
– **两种启动模式**：
– `txAdmin`（默认模式）：提供 Web 面板；
– **直接模式**（`TXADMIN=0`）：不显示面板，`fxserver` 直接执行 `server.cfg` 文件。
– **Git 自动更新**：`GIT_AUTOPULL=1` 会在每次启动时将生产环境与指定分支同步；`0` 适用于开发人员，以确保他们的本地代码不会被修改。
– **外部数据库支持**：可连接到主机上运行的 MySQL 数据库（地址：`host.docker.internal`）。
– **简单配置**：所有配置都通过环境变量或 `.env` 文件进行设置，包括敏感信息。
– **安全设置**：以非 root 用户身份运行；内置健康检查机制；使用持久化的 `/data` 卷存储缓存数据和 `txAdmin` 状态。

**快速启动命令：**
“`bash
docker run -d
-p 30120:30120/tcp -p 30120:30120/udp -p 47291:47291/tcp
-e FXSERVER_VERSION=recommended
-e LICENSE_KEY=■■■■■■■■■■
-v /path/to/resources:/data/txData/server/resources
-v /path/to/server.cfg:/data/txData/server/server.cfg
-v fivem-data:/data
fivem-docker
“`

**可选方案：**
也可以使用随镜像提供的 `docker-compose` 文件（适用于开发环境和生产环境）。

**仓库信息：**
GitHub：`itsxScrubz/fivem-docker`
**许可证：** MIT 许可证

**注意事项：**
如果您没有 Docker 使用经验，这个镜像可能不适合您。由于文档中已经涵盖了所有配置步骤，因此我不提供额外的技术支持。如果发现任何问题，请在此处或通过 GitHub 问题报告给我，我会尽快修复。目前这个镜像已经可以正常使用，我正在自己的开发框架中对其进行测试。