trueosiris/vrising

V Rising 专用服务器 Docker 镜像

镜像概述

Docker化的V Rising专用服务器，基于Ubuntu 22.04和Wine构建，用于便捷部署和运行V Rising游戏服务器。支持持久化数据存储、环境变量配置、日志自动清理及RCON远程管理，简化服务器搭建与维护流程。

核心功能与特性

• 基础环境：基于Ubuntu 22.04操作系统和Wine，确保V Rising服务器稳定运行
• 环境变量配置：支持设置服务器名称、端口、时区、日志保留天数及服务器版本等参数
• 持久化存储：通过卷挂载实现服务器程序文件和游戏世界数据的持久化保存
• 日志管理：自动清理超过30天的日志文件（可自定义保留天数），按启动时间生成带日期的日志
• 版本控制：支持通过环境变量选择服务器版本（如legacy-1.0.x-pc）
• RCON支持：可配置启用RCON功能，实现服务器远程管理
• 端口映射：默认暴露UDP游戏端口9876和查询端口9877，支持自定义端口配置

使用场景与适用范围

适用于需要搭建V Rising私人或公共游戏服务器的用户，尤其适合希望通过Docker简化部署流程、实现数据持久化和灵活配置管理的场景，满足个人玩家或社区管理员的服务器搭建需求。

使用方法与配置说明

环境变量

端口

卷

Docker 命令行部署

bash
docker run -d --name='vrising' \
--net='bridge' \
--restart=unless-stopped \
-e TZ="Europe/Paris" \
-e SERVERNAME="trueosiris-V" \
-v '/path/on/host/server':'/mnt/vrising/server':'rw' \
-v '/path/on/host/persistentdata':'/mnt/vrising/persistentdata':'rw' \
-p 9876:9876/udp \
-p 9877:9877/udp \
'trueosiris/vrising'

替换/path/on/host/server和/path/on/host/persistentdata为宿主机实际路径，用于持久化存储服务器文件和世界数据。

Docker Compose 配置

yaml
services:
  vrising:
    image: trueosiris/vrising
    environment:
      - TZ=Europe/Paris  # 时区设置
      - SERVERNAME=vrising-TrueOsiris  # 服务器名称
      # 可选：WORLDNAME=world1, GAMEPORT=9876, QUERYPORT=9877, LOGDAYS=30, BRANCH=legacy-1.0.x-pc
    volumes:
      - type: bind
        source: /your/host/vrising/server  # 宿主机服务器文件路径
        target: /mnt/vrising/server
        bind:
          create_host_path: true  # 自动创建宿主机路径（如不存在）
      - type: bind
        source: /your/host/vrising/persistentdata  # 宿主机世界数据路径
        target: /mnt/vrising/persistentdata
        bind:
          create_host_path: true
    ports:
      - '9876:9876/udp'  # 游戏端口映射
      - '9877:9877/udp'  # 查询端口映射
    restart: unless-stopped  # 容器退出时自动重启（除非手动停止）
    network_mode: bridge

RCON 配置（可选）

编辑/path/on/host/persistentdata/Settings/ServerHostSettings.json，在QueryPort后添加以下配置：

json
"Rcon": {
  "Enabled": true,
  "Password": "docker",  # 自定义RCON密码
  "Port": 25575          # RCON端口
},

配置后重启服务器，可使用https://github.com/gorcon/rcon-cli%E5%B7%A5%E5%85%B7%E8%BF%9B%E8%A1%8C%E8%BF%9C%E7%A8%8B%E7%AE%A1%E7%90%86%E3%80%82

注意事项

• 配置优先级：容器环境变量 > /persistentdata配置文件 > /server默认配置（后者会在Steam更新时被覆盖）。首次启动时，默认配置文件会复制到/persistentdata/Settings目录。
• 服务器可见性：确保ServerHostSettings.json中"ListOnSteam": true和"ListOnEOS": true以保证在游戏内列表可见。
• 端口映射：非默认端口映射（如-p 12345:6789/udp）会导致服务器无法在列表显示，需通过直接连接加入。
• 密码服务器：设置密码的服务器无法通过Steam加入，需使用游戏内服务器列表搜索加入。
• 启动时间：服务器启动可能需要10分钟，尤其存在现有存档时。
• 版本兼容：1.1版本无法继续1.0版本存档。
• 日志信息：1.1版本日志中01b4:fixme:winsock:...消息属正常现象，无需处理。
• 数据迁移：本地存档迁移需停止容器，覆盖persistentdata目录内容后重启。

已知问题

• 日志出现HTTP status 403错误：尝试使用trueosiris/vrising:display镜像
• 出现wine: Assertion failed错误：尝试使用trueosiris/vrising:winehq镜像（基于最新Wine版本）

相关链接

• https://github.com/StunlockStudios/vrising-dedicated-server-instructions
• https://hub.docker.com/r/trueosiris/vrising
• https://github.com/TrueOsiris/docker-vrising