mephi00/v-rising-wine Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

V Rising服务器Docker镜像（Wine）

镜像概述和主要用途

该Docker镜像用于运行V Rising服务器。由于V Rising服务器目前仅提供Windows可执行文件，因此本镜像通过Wine实现跨平台运行。镜像已发布至Docker Hub，可直接拉取使用：mephi00/v-rising-wine。

核心功能和特性

• 自动更新机制：容器启动时自动更新游戏服务器，无需依赖镜像更新即可获取最新版本
• 灵活配置方式：支持通过环境变量快速配置或提供完整配置文件实现深度自定义
• 持久化存储：服务器数据和配置文件集中存储于/saves目录，便于备份与迁移
• 公开列表支持：通过端口映射可实现在游戏内浏览器和Steam中显示服务器
• 自动初始化：首次启动自动生成游戏世界（耗时约10分钟或更长，取决于系统性能）

使用场景和适用范围

适用于需要搭建V Rising专用服务器的个人或小团体，尤其适合希望简化部署流程、自动维护服务器版本、灵活调整游戏参数的用户。需确保网络环境中正确配置端口转发以支持公开访问。

使用方法和配置说明

容器部署与端口设置

端口映射要求

服务器正常运行需通过UDP协议暴露以下端口：

• 游戏端口：服务器通信端口，Docker映射格式：-p <主机端口>:<容器端口>/udp
• 查询端口：用于服务器列表查询，映射方式同上

关键注意事项：

• 需在路由器设置中公开上述端口
• 为确保服务器在公开列表中正常显示，容器端口与主机端口必须保持一致
• 首次启动时，服务器会先更新游戏文件再初始化世界，全程需10分钟以上，请勿中断

部署示例

推荐使用Docker Compose进行部署，典型配置结构如下（完整示例可参考官方提供的docker-compose.yaml）：

yaml
version: '3'
services:
  vrising-server:
    image: mephi00/v-rising-wine
    ports:
      - "9876:9876/udp"  # 游戏端口
      - "9877:9877/udp"  # 查询端口
    volumes:
      - ./saves:/saves  # 持久化存储
    environment:
      - VR_NAME=MyV RisingServer  # 服务器名称（必填）
      - VR_SAVE_NAME=MyWorld  # 世界保存名称（必填）
      # 其他环境变量配置...

服务器配置

服务器支持通过环境变量或配置文件两种方式进行配置。

使用环境变量配置

ServerHostSettings.json相关变量

ServerGameSettings.json相关变量

使用配置文件配置

如需完全自定义配置，需提供完整配置文件：

• 需将ServerHostSettings.json和ServerGameSettings.json放置于/saves/Settings/目录
• 可通过挂载目录到/saves/Settings或在/saves挂载中包含Settings子目录实现
• 注意：仅提供部分配置文件会导致服务器使用默认设置；混合使用配置文件和环境变量时，修改环境变量不会更新配置，需删除/saves/Settings中的配置文件后生效

数据持久化与管理

保存文件位置

核心数据目录为/saves，建议通过Docker挂载实现持久化：

• 游戏存档文件：/saves/Saves子目录
• 配置文件：/saves/Settings子目录
• 挂载该目录可实现存档备份、服务器迁移，迁移时需确保保存名称与挂载的存档文件一致

管理员与封禁列表管理

• adminlist.txt和banlist.txt文件位于/saves/Settings目录
• 在adminlist.txt中添加SteamID可授予管理员权限
• 在banlist.txt中添加SteamID可封禁对应玩家
• 修改后需重启服务器使配置生效