imperialplugins/unturned

Unturned Docker镜像文档

镜像概述和主要用途

这是一个用于部署64位Linux版Unturned服务器的Docker镜像，支持RocketMod 4、RocketMod 5及原版服务器。镜像可自动下载游戏文件、在每次重启时更新服务器，检测服务器崩溃并自动重启，同时正确处理标准输入输出（stdin/stdout），无需RCON即可直接进行控制台输入输出操作。

核心功能和特性

• 自动部署与更新：首次启动时自动下载Unturned游戏文件，每次容器重启时自动更新服务器至最新版本
• 崩溃检测与恢复：实时监控服务器状态，检测到崩溃后自动重启
• 控制台支持：正确处理stdin/stdout，支持直接通过容器控制台进行输入输出操作
• 多服务器类型：支持RocketMod 4（rm4）、RocketMod 5（rm5）及原版（Vanilla）服务器
• 自定义配置：可通过环境变量自定义steamcmd命令，支持附加Unturned服务器启动参数
• 持久化存储：通过挂载卷实现服务器数据持久化，避免容器重启导致数据丢失

使用场景和适用范围

适用于需要快速部署、管理和维护Unturned服务器的场景，包括：

• 游戏服务器管理员快速搭建Unturned服务器
• 需要自定义服务器插件（通过RocketMod）的玩家群体
• 希望实现服务器自动更新和崩溃恢复的个人或团队
• 通过Docker Compose管理多个Unturned服务器实例的场景

使用方法和配置说明

镜像信息

• 镜像地址：imperialplugins/unturned
• Docker Hub仓库：https://hub.docker.com/r/imperialplugins/unturned

基础使用示例

部署RocketMod 4服务器的基础命令：

bash
docker run -it -v <host_path>:/home/steam/Unturned -p 27015:27015 -p 27016:27016 -e SERVER_TYPE=rm4 --restart unless-stopped --name myserverinstance imperialplugins/unturned

参数说明：

• -v <host_path>:/home/steam/Unturned：挂载宿主机目录到容器内，用于持久化服务器数据（需替换<host_path>为实际路径）
• -p 27015:27015：映射Unturned服务器端口
• -p 27016:27016：映射Steam查询端口
• -e SERVER_TYPE=rm4：指定服务器类型为RocketMod 4
• --restart unless-stopped：除非手动停止，否则容器自动重启
• --name myserverinstance：指定容器名称

自定义服务器参数

可在命令末尾附加Unturned服务器启动参数，例如跳过资产验证：

bash
docker run -it -v <host_path>:/home/steam/Unturned -p 27015:27015 -p 27016:27016 -e SERVER_TYPE=rm4 --restart unless-stopped --name myserverinstance imperialplugins/unturned -SkipAssets

自定义SteamCMD命令

通过STEAM_CMD_ARGS环境变量可在每次重启时运行自定义steamcmd命令，例如下载指定资源库：

bash
docker run -it -v <host_path>:/home/steam/Unturned -p 27015:27015 -p 27016:27016 -e STEAM_CMD_ARGS="+download_depot <somedepot>" -e SERVER_TYPE=rm4 --restart unless-stopped --name myserverinstance imperialplugins/unturned

环境变量说明

构建镜像

若需自行构建镜像，执行以下命令：

bash
docker build . -t unturned

构建完成后，使用自定义镜像启动服务器时，将命令中的imperialplugins/unturned替换为unturned即可。

非Docker使用方法（可选）

安装依赖

bash
sudo apt-get install -y unzip tar curl coreutils lib32gcc1 libgdiplus

设置环境变量

bash
export GAME_INSTALL_DIR=/path/to/Unturned  # 服务器安装目录
export SERVER_NAME=YOUR_SERVER_INSTANCE_NAME  # 服务器实例名称
export GAME_ID=1110390  # 游戏ID，1110390为专用服务器，304930为普通Unturned
export SERVER_TYPE=rm4  # 服务器类型：rm4/rm5/其他（原版）

使用普通Unturned（GAME_ID=304930）时需额外设置Steam账号：

bash
export STEAM_USERNAME=YourUsername  # Steam用户名
export STEAM_PASSWORD=YourPassword  # Steam密码
export STEAM_GUARD_TOKEN=YourSteamGuardToken  # Steam令牌（若启用Steam Guard）

启动服务器

bash
./init.sh  # 安装/更新服务器并启动

可附加Unturned服务器参数：

bash
./init.sh -SkipAssets  # 跳过资产验证启动服务器