theoriginalbrian/phvalheim-server Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

PhValheim Server

!PhValheim

概述

PhValheim是一个Valheim世界和模组管理系统，通过服务器+客户端架构确保服务器和所有玩家的模组配置完全同步。部署带有任何Thunderstore模组组合的世界，每个玩家连接时都会自动获取完全相同的文件，消除"你使用的是哪个版本"的困扰。

问题与解决方案

问题

为Valheim安装模组很容易，但要在服务器和每个玩家之间保持模组完全同步几乎是不可能的。像Thunderstore这样的模组管理器在个人使用时效果很好，但它们无法在团队中协调——最终总会有人的客户端与服务器不同步，导致会话中断。

解决方案

PhValheim是一个两部分系统（服务器+客户端），它将服务器和客户端的模组配置锁定在一起。部署带有任何Thunderstore模组组合的世界，每个玩家连接时都会自动获取完全相同的文件，不再需要"你使用的是哪个版本"的对话。

核心功能和特性

使用场景和适用范围

PhValheim适用于任何希望运行带有模组的Valheim服务器的用户或团队，特别适合：

• 希望简化模组管理的Valheim服务器管理员
• 经常遇到模组版本不一致问题的游戏社区
• 需要轻松管理多个Valheim世界的服务器
• 希望为玩家提供无缝模组同步体验的服务器所有者

使用方法和配置说明

快速开始

Docker Compose（推荐）

yaml
services:
  phvalheim:
    image: theoriginalbrian/phvalheim-server:latest
    container_name: phvalheim
    ports:
      - "8080:8080/tcp"    # 公共UI
      - "8081:8081/tcp"    # 管理UI（请勿公开暴露）
      - "25000-26000:25000-26000/udp"  # 游戏端口
    volumes:
      - /path/to/data:/opt/stateful:Z
      - /path/to/backups:/opt/stateful/backups:Z   # 理想情况下使用单独的磁盘
    restart: unless-stopped

启动容器后，打开[***]——设置向导将引导你完成配置。

Docker CLI

bash
docker create \
  --name phvalheim \
  -p 8080:8080/tcp \
  -p 8081:8081/tcp \
  -p 25000-26000:25000-26000/udp \
  -v /path/to/data:/opt/stateful:Z \
  -v /path/to/backups:/opt/stateful/backups:Z \
  theoriginalbrian/phvalheim-server:latest

docker start phvalheim

Unraid

在Community Apps商店中搜索PhValheim。

配置

所有设置在首次启动后通过管理UI配置，新安装不需要环境变量。

从旧版本升级？ 首次启动时，您现有的环境变量将自动迁移到数据库。一次性迁移通知将确认导入的值。

服务器设置

AI助手（可选）

在服务器设置中配置一个或多个AI提供商，以启用内置的日志分析助手。

卷

端口

PhValheim客户端

服务器只是系统的一半。PhValheim客户端是一个配套Windows应用程序，它注册了自定义的phvalheim:// URL协议。当玩家点击启动链接时：

1. 客户端将远程世界的校验和与本地副本进行比较。
2. 如果过时，它会下载新的有效负载（模组、配置、依赖项）。
3. 它启动Valheim，自动连接到正确的服务器和世界。

客户端文件安装到%appdata%/PhValheim，并将BepInEx引导程序添加到Valheim Steam目录。

客户端仓库： brianmiller/phvalheim-client

架构

高层架构

!PhValheim Architecture

认证与授权

!PhValheim Steam Auth

每个世界的访问由PhValheim数据库控制。Steam ID与每个世界相关联，同时控制Web UI（世界可见性）和游戏服务器允许列表。

反向代理（可选）

TLS终止的NGINX配置示例：

nginx
server {
    listen 80;
    server_name phvalheim.example.com;
    return 301 [***]
}

server {
    listen 443 ssl;
    server_name phvalheim.example.com;

    ssl_certificate     /path/to/fullchain.pem;
    ssl_certificate_key /path/to/privkey.pem;

    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
        proxy_read_timeout 1200s;
        client_max_body_size 0;
    }
}

自定义配置文件夹

注意：模组与稳定性

PhValheim使模组管理变得轻松，但并非所有模组都能很好地协同工作。如果遇到崩溃或意外行为，请先部署一个纯 vanilla 世界（无模组）以排除模组冲突。大多数模组问题发生在Valheim重大更新之后。

加入*** · 报告问题 · PhValheim客户端