V Rising Dedicated Server Docker镜像文档

镜像概述和主要用途

本镜像提供在Docker容器中运行的V Rising专用Linux服务器，基于SteamCMD自动安装和更新服务器程序，旨在简化V Rising服务器的部署、维护和版本管理流程。用户可通过容器化方式快速搭建独立的V Rising游戏服务器，支持数据持久化和灵活配置。

核心功能和特性

• 自动更新机制：容器启动时自动安装/更新至最新的SteamCMD和V Rising服务器程序，重新部署容器即可完成服务器更新。
• 数据持久化：支持挂载主机目录至容器内的/steamcmd/vrising（服务器程序文件）和/app/vrising（配置及存档文件），避免容器重建导致数据丢失。
• 启动模式控制：通过环境变量V_RISING_SERVER_START_MODE控制服务器行为，支持“更新并启动”“仅更新”“仅启动”三种模式。
• RCON集成：支持通过RCON协议发送关闭命令，确保服务器接收停止信号时正常退出。
• 自动更新触发：设置V_RISING_SERVER_UPDATE_MODE为1可启用全自动更新，服务器检测到Steam更新时自动重启并更新。
• 分支选择：通过V_RISING_SERVER_BRANCH环境变量指定服务器分支（默认public，目前游戏暂未提供其他分支）。
• 跨平台兼容：支持Linux Docker环境，Windows Docker需注意文件系统共享配置。

使用场景和适用范围

• 个人/小型团队服务器部署：无需手动配置SteamCMD和服务器环境，通过Docker快速搭建V Rising服务器。
• 长期运行服务器：依赖数据持久化和自动更新功能，减少手动维护成本。
• 版本测试：通过V_RISING_SERVER_BRANCH切换测试分支（若未来游戏提供）。
• Linux环境用户：原生支持Linux容器，兼容主流Docker环境。

使用方法和配置说明

基础使用

数据持久化与初始配置

服务器程序文件和数据（配置、存档）需通过挂载主机目录持久化。首次运行容器会生成默认配置文件，用户可在主机挂载目录中修改配置，或通过环境变量覆盖配置。

Docker Run示例

bash
docker run -d \
  --name vrising-server \
  -p 27015:27015/udp \  # 游戏端口（默认）
  -p 27016:27016/udp \  # 查询端口（默认）
  -p 25575:25575/tcp \  # RCON端口（默认，需启用RCON）
  -v /path/on/host/steamcmd/vrising:/steamcmd/vrising \  # 服务器程序文件
  -v /path/on/host/app/vrising:/app/vrising \  # 配置及存档文件
  didstopia/vrising-server

Docker Compose示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  vrising-server:
    image: didstopia/vrising-server
    container_name: vrising-server
    ports:
      - "27015:27015/udp"   # 游戏端口
      - "27016:27016/udp"   # 查询端口
      - "25575:25575/tcp"   # RCON端口
    volumes:
      - /path/on/host/steamcmd/vrising:/steamcmd/vrising  # 服务器程序持久化
      - /path/on/host/app/vrising:/app/vrising            # 配置及存档持久化
    environment:
      - V_RISING_SERVER_START_MODE=0  # 默认：更新并启动服务器
      - V_RISING_SERVER_RCON_PASSWORD=your_rcon_password  # 配置RCON密码
    restart: unless-stopped

高级配置

环境变量详解

关键配置说明

启动模式控制

通过V_RISING_SERVER_START_MODE调整服务器启动逻辑：

• 0（默认）：启动时先更新服务器程序，再启动服务器。
• 1：仅更新服务器程序，不启动（用于手动触发更新）。
• 2：直接启动服务器，不执行更新（适用于已确认程序最新的场景）。

全自动更新配置

设置V_RISING_SERVER_UPDATE_MODE=1后，服务器会定期检测Steam更新。当检测到新版本时，容器将自动重启并执行更新流程，适用于需要无人值守的长期服务器。

RCON配置

为确保服务器接收停止信号时正常退出（避免数据损坏），需配置RCON：

1. 设置V_RISING_SERVER_RCON_PORT（默认25575）和V_RISING_SERVER_RCON_PASSWORD（自定义密码）。
2. 容器会通过RCON发送shutdown命令，确保服务器优雅关闭。

分支选择

若游戏未来提供测试分支，可通过V_RISING_SERVER_BRANCH=branch_name指定安装，默认使用public正式分支。

Windows Docker注意事项

使用Docker for Windows且启用文件系统直通时，需在Docker GUI中将Git仓库所在盘符添加为共享驱动器，避免挂载目录权限问题。

许可证

详见镜像源码中的LICENSE文件。