hostfactor/vrising-server

V Rising Linux Docker服务器

镜像概述和主要用途

该Docker镜像提供了一个在Linux环境下运行V Rising专用服务器的便捷解决方案。通过容器化部署，用户可以快速搭建V Rising游戏服务器，支持存档持久化、配置自定义及服务器状态监控等功能，适用于个人、局域网或小型社区游戏服务器场景。

核心功能和特性

• 持久化存储：通过卷挂载确保服务器存档在容器重启后不丢失
• 存档管理：支持使用现有游戏存档，通过环境变量指定存档名称
• 配置自定义：可挂载外部配置文件（ServerGameSettings.json和ServerHostSettings.json）自定义服务器参数
• 灵活参数：支持通过环境变量和命令行参数配置服务器属性
• HTTP API：可选启用HTTP服务器，提供服务器就绪状态检查接口

使用场景和适用范围

• 个人玩家搭建私人V Rising服务器
• 局域网内好友联机游戏
• 小型社区服务器部署
• 需要快速部署和迁移的游戏服务器环境

详细使用方法和配置说明

基本使用

通过以下命令启动服务器，其中/my/folder是本地用于存储存档的空文件夹：

bash
docker run -v /my/folder:/root/saves -p 9876:9876/udp hostfactor/vrising-server

注意：如果不添加-v卷挂载参数，容器退出后服务器存档将丢失。

如需运行特定版本，可指定标签：

bash
docker run -v /my/folder:/root/saves -p 9876:9876/udp hostfactor/vrising-server:0.5.41821

服务器就绪后，将显示以下消息：

Your V Rising server is ready!

此时可在游戏中连接：

1. 点击"在线游戏"(Online Play)
2. 选择游戏模式
3. 点击"显示所有服务器和设置"(Display all Servers & Settings)
4. 选择"直接连接"(Direct Connect)
5. 输入服务器地址127.0.0.1（本地服务器）

使用现有存档

若要使用已有的游戏存档，需找到存档文件夹路径，然后通过以下命令启动：

bash
docker run -e SAVE_NAME=world1 -v /my/save/path:/root/saves -p 9876:9876/udp hostfactor/vrising-server

将world1替换为存档文件夹的名称，/my/save/path替换为本地存档文件夹的绝对路径。

配置服务器

服务器通过ServerGameSettings.json和ServerHostSettings.json文件进行配置。可通过挂载包含这些文件的文件夹来自定义配置：

bash
docker run -v /my/settings/path:/root/vrising/VRisingServer_Data/StreamingAssets/Settings -p 9876:9876/udp hostfactor/vrising-server

其中/my/settings/path是包含配置文件的本地文件夹绝对路径。

自定义命令行参数

服务器支持通过命令行参数进行配置，更多参数可参考https://github.com/StunlockStudios/vrising-dedicated-server-instructions#configuring-the-server%E3%80%82%E7%A4%BA%E4%BE%8B%EF%BC%88LAN%E6%A8%A1%E5%BC%8F%EF%BC%89%EF%BC%9A

bash
docker run -v /my/folder:/root/saves -p 9876:9876/udp hostfactor/vrising-server -lan

环境变量

可通过-e参数设置以下环境变量配置服务器：

HTTP API

设置RENFIELD_SERVER_PORT环境变量可启用HTTP API，用于监控服务器状态：

bash
docker run -v /my/folder:/root/saves -p 9876:9876/udp -p 8080:8080 -e RENFIELD_SERVER_PORT=8080 hostfactor/vrising-server

目前支持的API端点：