热门搜索:

lloesche/valheim-server

lloesche

Valheim专用游戏服务器Docker镜像，支持自动更新、世界备份，以及BepInEx和ValheimPlus模组

213 次收藏下载次数: 0状态：社区镜像维护者：lloesche仓库类型：镜像最近更新：1 个月前

镜像标签列表与下载命令

lloesche/valheim-server Docker镜像

!https://raw.githubusercontent.com/lloesche/valheim-server-docker/main/misc/Logo_valheim.png "Valheim"

Docker容器化的Valheim服务器（支持BepInEx和ValheimPlus）
项目托管于https://github.com/lloesche/valheim-server-docker

基本Docker使用方法
环境变量
- 日志过滤器
  - 日志过滤器事件钩子
    - ***日志过滤器事件钩子示例
- 事件钩子
  - 事件钩子示例
    - 安装额外软件包
    - 将备份复制到其他位置
    - ***通知
- 通过环境变量配置模组
系统要求
部署
- 使用Docker和systemd部署
- 使用docker-compose部署
- 部署到Kubernetes
- 部署到AWS ECS
- 部署到Nomad
更新
备份
- 手动备份
查找服务器
- 游戏内
  - 通过主机名/IP直接加入
- Steam服务器浏览器
- Steam服务器收藏夹与局域网游戏
管理员命令
- 启用管理员控制台
Supervisor
- Supervisor API
状态Web服务器
模组
- BepInExPack Valheim
  - 配置
- ValheimPlus
  - 更新
  - 配置
    - 禁用服务器密码
在Portainer中更改启动命令
群晖帮助
- 首次安装
- 将容器镜像更新到最新版本
  - 下载新容器镜像后出错
QNAP NAS帮助
- 创建容器
- 更新镜像
- QNAP ZFS问题
OpenMediaVault帮助
- 权限被拒绝错误
许可证
***免责声明

基本Docker使用方法

Docker镜像名称为lloesche/valheim-server。

需将服务器配置目录挂载到Docker容器内的/config目录。

如果在Windows系统上已有存档世界，可从例如C:\Users\Lukas\AppData\LocalLow\IronGate\Valheim\worlds复制到$HOME/valheim-server/config/worlds，并将$HOME/valheim-server/config目录挂载到容器内的/config目录运行镜像。容器目录/opt/valheim包含已下载的服务器，可选择挂载此目录以避免每次启动时重新下载服务器。

bash
$ mkdir -p $HOME/valheim-server/config/worlds $HOME/valheim-server/data
# 复制现有世界
$ docker run -d \
    --name valheim-server \
    --cap-add=sys_nice \
    --stop-timeout 120 \
    -p 2456-2457:2456-2457/udp \
    -v $HOME/valheim-server/config:/config \
    -v $HOME/valheim-server/data:/opt/valheim \
    -e SERVER_NAME="我的服务器" \
    -e WORLD_NAME="Neotopia" \
    -e SERVER_PASS="secret" \
    lloesche/valheim-server

警告：SERVER_PASS必须至少5个字符，否则valheim_server.x86_64将无法启动！

首次启动需要几分钟时间，具体取决于互联网连接速度，因为容器会从Steam下载Valheim专用服务器（约1GB）。

不要忘记修改WORLD_NAME以匹配你的世界名称！对于现有世界，这是worlds/文件夹中不带.db/.fwl扩展名的文件名。

如果要通过互联网与朋友一起玩且处于NAT之后，请确保UDP端口2456-2457已转发到容器主机，并确保在任何防火墙中这些端口可公开访问。

更多信息请参见查找服务器部分。

仅局域网游戏请参见Steam服务器收藏夹与局域网游戏部分。

更多部署选项请参见部署部分。

向容器授予CAP_SYS_NICE权限是可选的，它允许Valheim使用的Steam库为自身分配更多CPU周期。没有此权限，启动日志中会显示Warning: failed to set thread priority消息。

环境变量

所有变量名称和值均区分大小写！

名称	默认值	用途
`SERVER_NAME`	`My Server`	服务器在服务器浏览器中显示的名称
`SERVER_PORT`	`2456`	服务器监听的UDP起始端口
`WORLD_NAME`	`Dedicated`	世界名称（不带.db/.fwl文件扩展名）
`SERVER_PASS`	`secret`	登录服务器的密码 - 至少5个字符！
`SERVER_PUBLIC`	`true`	服务器是否在服务器浏览器中列出（`true`是，`false`否）
`SERVER_ARGS`		额外的Valheim服务器命令行参数
`ADMINLIST_IDS`		管理员SteamID的空格分隔列表，会覆盖现有adminlist.txt条目！
`BANNEDLIST_IDS`		被封禁SteamID的空格分隔列表，会覆盖现有bannedlist.txt条目！
`PERMITTEDLIST_IDS`		白名单SteamID的空格分隔列表，会覆盖现有permittedlist.txt条目！
`UPDATE_CRON`	`/15 * * *`	更新检查的Cron计划（若设为空字符串或使用旧版`UPDATE_INTERVAL`则禁用）
`UPDATE_IF_IDLE`	`true`	仅当服务器空闲（无玩家连接）时才运行更新检查（`true`或`false`）
`RESTART_CRON`	`0 5 * * *`	服务器重启的Cron计划（若设为空字符串则禁用）
`RESTART_IF_IDLE`	`true`	仅当服务器空闲时才运行每日重启（`true`或`false`）
`TZ`	`Etc/UTC`	容器时区（参考时区数据库列表）
`BACKUPS`	`true`	是否创建定期备份（`true`或`false`）
`BACKUPS_CRON`	`0 * * * *`	世界备份的Cron计划（若设为空字符串或使用旧版`BACKUPS_INTERVAL`则禁用）
`BACKUPS_DIRECTORY`	`/config/backups`	备份目录路径
`BACKUPS_MAX_AGE`	`3`	旧备份自动删除的天数
`BACKUPS_MAX_COUNT`	`0`	保留的最大备份数，0表示无限制
`BACKUPS_IF_IDLE`	`true`	即使长时间无玩家连接也进行备份
`BACKUPS_IDLE_GRACE_PERIOD`	`3600`	当`BACKUPS_IF_IDLE=false`时，最后一个玩家断开连接后的宽限期（秒），在此期间仍会创建备份
`PERMISSIONS_UMASK`	`022`	备份、配置文件和目录的Umask权限
`STEAMCMD_ARGS`	`validate`	额外的steamcmd命令行参数
`VALHEIM_PLUS`	`false`	是否加载https://github.com/valheimPlus/ValheimPlus%E6%A8%A1%E7%BB%84%EF%BC%88%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E5%9C%A8%60/config/valheimplus%60%EF%BC%8C%E9%A2%9D%E5%A4%96%E6%8F%92%E4%BB%B6%E5%9C%A8%60/config/valheimplus/plugins%60%EF%BC%89%EF%BC%8C%E4%B8%8D%E8%83%BD%E4%B8%8E%60BEPINEX%60%E5%90%8C%E6%97%B6%E4%BD%BF%E7%94%A8%E3%80%82
`BEPINEX`	`false`	是否加载BepInExPack Valheim模组（配置文件在`/config/bepinex`，插件在`/config/bepinex/plugins`），不能与`VALHEIM_PLUS`同时使用。
`SUPERVISOR_HTTP`	`false`	启用supervisor的HTTP服务器
`SUPERVISOR_HTTP_PORT`	`9001`	设置supervisor的HTTP服务器端口
`SUPERVISOR_HTTP_USER`	`admin`	supervisor HTTP服务器用户名
`SUPERVISOR_HTTP_PASS`		supervisor HTTP服务器密码
`STATUS_HTTP`	`false`	启用状态HTTP服务器，仅对公共服务器（`SERVER_PUBLIC=true`）有用
`STATUS_HTTP_PORT`	`80`	状态HTTP服务器TCP端口
`STATUS_HTTP_CONF`	`/config/httpd.conf`	busybox httpd配置文件路径
`STATUS_HTTP_HTDOCS`	`/opt/valheim/htdocs`	状态httpd的htdocs路径，`status.json`在此生成
`SYSLOG_REMOTE_HOST`		发送日志的远程syslog主机或IP
`SYSLOG_REMOTE_PORT`	`514`	远程syslog UDP端口
`SYSLOG_REMOTE_AND_LOCAL`	`true`	发送日志到远程syslog服务器时是否同时本地记录
`PUID`	`0`	运行valheim-server的UID
`PGID`	`0`	运行valheim-server的GID

有一些未文档化的环境变量，若配置错误可能导致问题，可在defaults中找到。

日志过滤器

Valheim服务器默认日志包含大量噪音，这些环境变量允许用户移除不需要的日志行。

前缀	默认值	用途
`VALHEIM_LOG_FILTER_EMPTY`	`true`	过滤空日志行
`VALHEIM_LOG_FILTER_UTF8`	`true`	过滤无效UTF-8字符
`VALHEIM_LOG_FILTER_MATCH`		过滤完全匹配的日志行
`VALHEIM_LOG_FILTER_STARTSWITH`	`(Filename:`	过滤以指定字符串开头的日志行
`VALHEIM_LOG_FILTER_ENDSWITH`		过滤以指定字符串结尾的日志行
`VALHEIM_LOG_FILTER_CONTAINS`		过滤包含指定字符串的日志行
`VALHEIM_LOG_FILTER_REGEXP`		过滤匹配正则表达式的日志行

默认过滤器移除以下内容：

空日志行
仅包含单个空格的日志行
重复出现的(Filename: ./Runtime/Export/Debug/Debug.bindings.h Line: 35)行
因数据包处理超时导致的Assertion Failed警告日志行（参见https://github.com/lloesche/valheim-server-docker/discussions/104%EF%BC%89
启用ValheimPlus时，以Fallback handler could not load library开头的行

日志过滤器事件钩子

如果存在与日志过滤器同名的ON_前缀环境变量，当日志过滤器匹配时，不会移除日志行，而是执行该变量内容，并将日志行通过标准输入传递给命令。

前缀	用途
`ON_VALHEIM_LOG_FILTER_MATCH`	当日志行完全匹配时运行命令钩子
`ON_VALHEIM_LOG_FILTER_STARTSWITH`	当日志行以指定字符串开头时运行命令钩子
`ON_VALHEIM_LOG_FILTER_ENDSWITH`	当日志行以指定字符串结尾时运行命令钩子
`ON_VALHEIM_LOG_FILTER_CONTAINS`	当日志行包含指定字符串时运行命令钩子
`ON_VALHEIM_LOG_FILTER_REGEXP`	当日志行匹配正则表达式时运行命令钩子

除VALHEIM_LOG_FILTER_EMPTY和VALHEIM_LOG_FILTER_UTF8外，所有环境变量都是前缀，可定义多个匹配条件，例如：

-e VALHEIM_LOG_FILTER_STARTSWITH=foo \
-e VALHEIM_LOG_FILTER_STARTSWITH_BAR=bar \
-e VALHEIM_LOG_FILTER_STARTSWITH_SOMETHING_ELSE="some other filter"
-e VALHEIM_LOG_FILTER_CONTAINS_Connected="Got character ZDOID from"
-e ON_VALHEIM_LOG_FILTER_CONTAINS_Connected="cat >> /tmp/character_login"

***日志过滤器事件钩子示例

当玩家生成时发送***消息：

-e DISCORD_WEBHOOK="https://discord.com/api/webhooks/8171522530..." \
-e VALHEIM_LOG_FILTER_CONTAINS_Spawned="Got character ZDOID from" \
-e ON_VALHEIM_LOG_FILTER_CONTAINS_Spawned='{ read l; l=${l//*ZDOID from /}; l=${l// :*/}; msg="玩家 $l 进入世界"; curl -sfSL -X POST -H "Content-Type: application/json" -d "{\"username\":\"Valheim\",\"content\":\"$msg\"}" "$DISCORD_WEBHOOK"; }'

关于在环境变量和compose文件中的正确引用方式，参见下面的***通知。

如果运行ValheimPlus且此过滤器触发两次，请检查https://github.com/valheimPlus/ValheimPlus/issues/318%EF%BC%8C%E5%8E%9F%E5%9B%A0%E6%98%AF%60BepInEx.cfg%60%E9%85%8D%E7%BD%AE%E9%94%99%E8%AF%AF%E5%AF%BC%E8%87%B4%E6%97%A5%E5%BF%97%E8%A1%8C%E9%87%8D%E5%A4%8D%E3%80%82

事件钩子

以下环境变量可用于在特定事件发生时执行命令。

名称	默认值	用途
`PRE_SUPERVISOR_HOOK`		在supervisord运行前执行的命令，启动会阻塞直到命令返回。
`PRE_BOOTSTRAP_HOOK`		在引导前执行的命令，启动会阻塞直到命令返回。
`POST_BOOTSTRAP_HOOK`		在引导后、服务器或任何服务启动前执行的命令，可用于安装额外软件包或执行系统设置，启动会阻塞直到命令返回。
`PRE_BACKUP_HOOK`		在创建备份前执行的命令，`@BACKUP_FILE@`会替换为备份ZIP文件的完整路径，备份会阻塞直到命令返回。
`POST_BACKUP_HOOK`		在创建备份后执行的命令，`@BACKUP_FILE@`会替换为备份ZIP文件的完整路径，备份会阻塞直到命令返回，详见将备份复制到其他位置。
`PRE_UPDATE_CHECK_HOOK`		在执行更新检查前执行的命令，当前更新会阻塞直到命令返回。
`POST_UPDATE_CHECK_HOOK`		在执行更新检查后执行的命令，后续更新会阻塞直到命令返回。
`PRE_START_HOOK`		在valheim-updater首次启动服务器前执行的命令，当前启动会阻塞直到命令返回。
`POST_START_HOOK`		在valheim-updater首次启动服务器后执行的命令，后续重启和更新检查会阻塞直到命令返回。
`PRE_RESTART_HOOK`		在valheim-updater执行服务器重启前执行的命令，当前重启会阻塞直到命令返回。
`PRE_SERVER_LISTENING_HOOK`		在服务器运行后、能够接受连接前执行的命令，检查连接状态的循环会阻塞直到命令返回。
`POST_SERVER_LISTENING_HOOK`		在服务器

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问标签列表页面。

轩辕镜像加速拉取命令点我查看更多 valheim-server 镜像标签

docker pull docker.xuanyuan.run/lloesche/valheim-server:<标签>

使用方法：

DockerHub 原生拉取命令

docker pull lloesche/valheim-server:<标签>

轩辕镜像配置手册

探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式

Docker 配置

登录仓库拉取

通过 Docker 登录认证访问私有仓库

专属域名拉取

无需登录使用专属域名

K8s Containerd

Kubernetes 集群配置 Containerd

K3s

K3s 轻量级 Kubernetes 镜像加速

Dev Containers

VS Code Dev Containers 配置

Podman

Podman 容器引擎配置

Singularity/Apptainer

HPC 科学计算容器配置

其他仓库配置

ghcr、Quay、nvcr 等镜像仓库

Harbor 镜像源配置

Harbor Proxy Repository 对接专属域名

Portainer 镜像源配置

Portainer Registries 加速拉取

Nexus 镜像源配置

Nexus3 Docker Proxy 内网缓存

系统配置

Linux

在 Linux 系统配置镜像服务

Windows/Mac

在 Docker Desktop 配置镜像

MacOS OrbStack

MacOS OrbStack 容器配置

Docker Compose

Docker Compose 项目配置

NAS 设备

群晖

Synology 群晖 NAS 配置

飞牛

飞牛 fnOS 系统配置镜像

绿联

绿联 NAS 系统配置镜像

威联通

QNAP 威联通 NAS 配置

极空间

极空间 NAS 系统配置服务

网络设备

爱快路由

爱快 iKuai 路由系统配置

宝塔面板

在宝塔面板一键配置镜像

需要其他帮助？请查看我们的常见问题Docker 镜像访问常见问题解答或提交工单

镜像拉取常见问题

使用与功能问题

配置了专属域名后，docker search 为什么会报错？

docker search 限制

Docker Hub 上有的镜像，为什么在轩辕镜像网站搜不到？

站内搜不到镜像

机器不能直连外网时，怎么用 docker save / load 迁镜像？

离线 save/load

docker pull 拉插件报错（plugin v1+json）怎么办？

插件要用 plugin install

WSL 里 Docker 拉镜像特别慢，怎么排查和优化？

WSL 拉取慢

轩辕镜像安全吗？如何用 digest 校验镜像没被篡改？

安全与 digest

第一次用轩辕镜像拉 Docker 镜像，要怎么登录和配置？

新手拉取配置

轩辕镜像合规吗？轩辕镜像的合规是怎么做的？

镜像合规机制

错误码与失败问题

docker pull 提示 manifest unknown 怎么办？

manifest unknown

docker pull 提示 no matching manifest 怎么办？

no matching manifest（架构）

镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？

invalid tar header（解压）

Docker pull 时 HTTPS / TLS 证书验证失败怎么办？

TLS 证书失败

Docker pull 时 DNS 解析超时或连不上仓库怎么办？

DNS 超时

docker 无法连接轩辕镜像域名怎么办？

域名连通性排查

Docker 拉取出现 410 Gone 怎么办？

410 Gone 排查

出现 402 或「流量用尽」提示怎么办？

402 与流量用尽

Docker 拉取提示 UNAUTHORIZED（401）怎么办？

401 认证失败

遇到 429 Too Many Requests（请求太频繁）怎么办？

429 限流

docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？

D-Bus 凭证提示

为什么会出现「单层超过 20GB」或 413，无法加速拉取？

413 与超大单层

账号 / 计费 / 权限

轩辕镜像免费版和专业版有什么区别？

免费版与专业版区别

轩辕镜像支持哪些 Docker 镜像仓库？

支持的镜像仓库

镜像拉取失败还会不会扣流量？

失败是否计费

麒麟 V10 / 统信 UOS 提示 KYSEC 权限不够怎么办？

KYSEC 拦截脚本

如何在轩辕镜像申请开具发票？

申请开票

怎么修改轩辕镜像的网站登录和仓库登录密码？

修改登录密码

如何注销轩辕镜像账户？要注意什么？

注销账户

配置与原理类

写了 registry-mirrors，为什么还是走官方或仍然报错？

mirrors 不生效

怎么用 docker tag 去掉镜像名里的轩辕域名前缀？

去掉域名前缀

如何拉取指定 CPU 架构的镜像（如 ARM64、AMD64）？

指定架构拉取

用轩辕镜像拉镜像时快时慢，常见原因有哪些？

拉取速度原因

为什么拉取镜像的 :latest 标签，拿到的往往不是「最新」镜像？

latest 与「最新」

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"

热门搜索:

lloesche/valheim-server

lloesche

Valheim专用游戏服务器Docker镜像，支持自动更新、世界备份，以及BepInEx和ValheimPlus模组

213 次收藏下载次数: 0状态：社区镜像维护者：lloesche仓库类型：镜像最近更新：1 个月前

镜像标签列表与下载命令

lloesche/valheim-server Docker镜像

!https://raw.githubusercontent.com/lloesche/valheim-server-docker/main/misc/Logo_valheim.png "Valheim"

Docker容器化的Valheim服务器（支持BepInEx和ValheimPlus）
项目托管于https://github.com/lloesche/valheim-server-docker

基本Docker使用方法
环境变量
- 日志过滤器
  - 日志过滤器事件钩子
    - ***日志过滤器事件钩子示例
- 事件钩子
  - 事件钩子示例
    - 安装额外软件包
    - 将备份复制到其他位置
    - ***通知
- 通过环境变量配置模组
系统要求
部署
- 使用Docker和systemd部署
- 使用docker-compose部署
- 部署到Kubernetes
- 部署到AWS ECS
- 部署到Nomad
更新
备份
- 手动备份
查找服务器
- 游戏内
  - 通过主机名/IP直接加入
- Steam服务器浏览器
- Steam服务器收藏夹与局域网游戏
管理员命令
- 启用管理员控制台
Supervisor
- Supervisor API
状态Web服务器
模组
- BepInExPack Valheim
  - 配置
- ValheimPlus
  - 更新
  - 配置
    - 禁用服务器密码
在Portainer中更改启动命令
群晖帮助
- 首次安装
- 将容器镜像更新到最新版本
  - 下载新容器镜像后出错
QNAP NAS帮助
- 创建容器
- 更新镜像
- QNAP ZFS问题
OpenMediaVault帮助
- 权限被拒绝错误
许可证
***免责声明

基本Docker使用方法

Docker镜像名称为lloesche/valheim-server。

需将服务器配置目录挂载到Docker容器内的/config目录。

bash
$ mkdir -p $HOME/valheim-server/config/worlds $HOME/valheim-server/data
# 复制现有世界
$ docker run -d \
    --name valheim-server \
    --cap-add=sys_nice \
    --stop-timeout 120 \
    -p 2456-2457:2456-2457/udp \
    -v $HOME/valheim-server/config:/config \
    -v $HOME/valheim-server/data:/opt/valheim \
    -e SERVER_NAME="我的服务器" \
    -e WORLD_NAME="Neotopia" \
    -e SERVER_PASS="secret" \
    lloesche/valheim-server

警告：SERVER_PASS必须至少5个字符，否则valheim_server.x86_64将无法启动！

首次启动需要几分钟时间，具体取决于互联网连接速度，因为容器会从Steam下载Valheim专用服务器（约1GB）。

不要忘记修改WORLD_NAME以匹配你的世界名称！对于现有世界，这是worlds/文件夹中不带.db/.fwl扩展名的文件名。

如果要通过互联网与朋友一起玩且处于NAT之后，请确保UDP端口2456-2457已转发到容器主机，并确保在任何防火墙中这些端口可公开访问。

更多信息请参见查找服务器部分。

仅局域网游戏请参见Steam服务器收藏夹与局域网游戏部分。

更多部署选项请参见部署部分。

环境变量

所有变量名称和值均区分大小写！

名称	默认值	用途
`SERVER_NAME`	`My Server`	服务器在服务器浏览器中显示的名称
`SERVER_PORT`	`2456`	服务器监听的UDP起始端口
`WORLD_NAME`	`Dedicated`	世界名称（不带.db/.fwl文件扩展名）
`SERVER_PASS`	`secret`	登录服务器的密码 - 至少5个字符！
`SERVER_PUBLIC`	`true`	服务器是否在服务器浏览器中列出（`true`是，`false`否）
`SERVER_ARGS`		额外的Valheim服务器命令行参数
`ADMINLIST_IDS`		管理员SteamID的空格分隔列表，会覆盖现有adminlist.txt条目！
`BANNEDLIST_IDS`		被封禁SteamID的空格分隔列表，会覆盖现有bannedlist.txt条目！
`PERMITTEDLIST_IDS`		白名单SteamID的空格分隔列表，会覆盖现有permittedlist.txt条目！
`UPDATE_CRON`	`/15 * * *`	更新检查的Cron计划（若设为空字符串或使用旧版`UPDATE_INTERVAL`则禁用）
`UPDATE_IF_IDLE`	`true`	仅当服务器空闲（无玩家连接）时才运行更新检查（`true`或`false`）
`RESTART_CRON`	`0 5 * * *`	服务器重启的Cron计划（若设为空字符串则禁用）
`RESTART_IF_IDLE`	`true`	仅当服务器空闲时才运行每日重启（`true`或`false`）
`TZ`	`Etc/UTC`	容器时区（参考时区数据库列表）
`BACKUPS`	`true`	是否创建定期备份（`true`或`false`）
`BACKUPS_CRON`	`0 * * * *`	世界备份的Cron计划（若设为空字符串或使用旧版`BACKUPS_INTERVAL`则禁用）
`BACKUPS_DIRECTORY`	`/config/backups`	备份目录路径
`BACKUPS_MAX_AGE`	`3`	旧备份自动删除的天数
`BACKUPS_MAX_COUNT`	`0`	保留的最大备份数，0表示无限制
`BACKUPS_IF_IDLE`	`true`	即使长时间无玩家连接也进行备份
`BACKUPS_IDLE_GRACE_PERIOD`	`3600`	当`BACKUPS_IF_IDLE=false`时，最后一个玩家断开连接后的宽限期（秒），在此期间仍会创建备份
`PERMISSIONS_UMASK`	`022`	备份、配置文件和目录的Umask权限
`STEAMCMD_ARGS`	`validate`	额外的steamcmd命令行参数
`VALHEIM_PLUS`	`false`	是否加载https://github.com/valheimPlus/ValheimPlus%E6%A8%A1%E7%BB%84%EF%BC%88%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E5%9C%A8%60/config/valheimplus%60%EF%BC%8C%E9%A2%9D%E5%A4%96%E6%8F%92%E4%BB%B6%E5%9C%A8%60/config/valheimplus/plugins%60%EF%BC%89%EF%BC%8C%E4%B8%8D%E8%83%BD%E4%B8%8E%60BEPINEX%60%E5%90%8C%E6%97%B6%E4%BD%BF%E7%94%A8%E3%80%82
`BEPINEX`	`false`	是否加载BepInExPack Valheim模组（配置文件在`/config/bepinex`，插件在`/config/bepinex/plugins`），不能与`VALHEIM_PLUS`同时使用。
`SUPERVISOR_HTTP`	`false`	启用supervisor的HTTP服务器
`SUPERVISOR_HTTP_PORT`	`9001`	设置supervisor的HTTP服务器端口
`SUPERVISOR_HTTP_USER`	`admin`	supervisor HTTP服务器用户名
`SUPERVISOR_HTTP_PASS`		supervisor HTTP服务器密码
`STATUS_HTTP`	`false`	启用状态HTTP服务器，仅对公共服务器（`SERVER_PUBLIC=true`）有用
`STATUS_HTTP_PORT`	`80`	状态HTTP服务器TCP端口
`STATUS_HTTP_CONF`	`/config/httpd.conf`	busybox httpd配置文件路径
`STATUS_HTTP_HTDOCS`	`/opt/valheim/htdocs`	状态httpd的htdocs路径，`status.json`在此生成
`SYSLOG_REMOTE_HOST`		发送日志的远程syslog主机或IP
`SYSLOG_REMOTE_PORT`	`514`	远程syslog UDP端口
`SYSLOG_REMOTE_AND_LOCAL`	`true`	发送日志到远程syslog服务器时是否同时本地记录
`PUID`	`0`	运行valheim-server的UID
`PGID`	`0`	运行valheim-server的GID

有一些未文档化的环境变量，若配置错误可能导致问题，可在defaults中找到。

日志过滤器

Valheim服务器默认日志包含大量噪音，这些环境变量允许用户移除不需要的日志行。

前缀	默认值	用途
`VALHEIM_LOG_FILTER_EMPTY`	`true`	过滤空日志行
`VALHEIM_LOG_FILTER_UTF8`	`true`	过滤无效UTF-8字符
`VALHEIM_LOG_FILTER_MATCH`		过滤完全匹配的日志行
`VALHEIM_LOG_FILTER_STARTSWITH`	`(Filename:`	过滤以指定字符串开头的日志行
`VALHEIM_LOG_FILTER_ENDSWITH`		过滤以指定字符串结尾的日志行
`VALHEIM_LOG_FILTER_CONTAINS`		过滤包含指定字符串的日志行
`VALHEIM_LOG_FILTER_REGEXP`		过滤匹配正则表达式的日志行

默认过滤器移除以下内容：

空日志行
仅包含单个空格的日志行
重复出现的(Filename: ./Runtime/Export/Debug/Debug.bindings.h Line: 35)行
因数据包处理超时导致的Assertion Failed警告日志行（参见https://github.com/lloesche/valheim-server-docker/discussions/104%EF%BC%89
启用ValheimPlus时，以Fallback handler could not load library开头的行

日志过滤器事件钩子

如果存在与日志过滤器同名的ON_前缀环境变量，当日志过滤器匹配时，不会移除日志行，而是执行该变量内容，并将日志行通过标准输入传递给命令。

前缀	用途
`ON_VALHEIM_LOG_FILTER_MATCH`	当日志行完全匹配时运行命令钩子
`ON_VALHEIM_LOG_FILTER_STARTSWITH`	当日志行以指定字符串开头时运行命令钩子
`ON_VALHEIM_LOG_FILTER_ENDSWITH`	当日志行以指定字符串结尾时运行命令钩子
`ON_VALHEIM_LOG_FILTER_CONTAINS`	当日志行包含指定字符串时运行命令钩子
`ON_VALHEIM_LOG_FILTER_REGEXP`	当日志行匹配正则表达式时运行命令钩子

除VALHEIM_LOG_FILTER_EMPTY和VALHEIM_LOG_FILTER_UTF8外，所有环境变量都是前缀，可定义多个匹配条件，例如：

-e VALHEIM_LOG_FILTER_STARTSWITH=foo \
-e VALHEIM_LOG_FILTER_STARTSWITH_BAR=bar \
-e VALHEIM_LOG_FILTER_STARTSWITH_SOMETHING_ELSE="some other filter"
-e VALHEIM_LOG_FILTER_CONTAINS_Connected="Got character ZDOID from"
-e ON_VALHEIM_LOG_FILTER_CONTAINS_Connected="cat >> /tmp/character_login"

***日志过滤器事件钩子示例

当玩家生成时发送***消息：

-e DISCORD_WEBHOOK="https://discord.com/api/webhooks/8171522530..." \
-e VALHEIM_LOG_FILTER_CONTAINS_Spawned="Got character ZDOID from" \
-e ON_VALHEIM_LOG_FILTER_CONTAINS_Spawned='{ read l; l=${l//*ZDOID from /}; l=${l// :*/}; msg="玩家 $l 进入世界"; curl -sfSL -X POST -H "Content-Type: application/json" -d "{\"username\":\"Valheim\",\"content\":\"$msg\"}" "$DISCORD_WEBHOOK"; }'

关于在环境变量和compose文件中的正确引用方式，参见下面的***通知。

事件钩子

以下环境变量可用于在特定事件发生时执行命令。

名称	默认值	用途
`PRE_SUPERVISOR_HOOK`		在supervisord运行前执行的命令，启动会阻塞直到命令返回。
`PRE_BOOTSTRAP_HOOK`		在引导前执行的命令，启动会阻塞直到命令返回。
`POST_BOOTSTRAP_HOOK`		在引导后、服务器或任何服务启动前执行的命令，可用于安装额外软件包或执行系统设置，启动会阻塞直到命令返回。
`PRE_BACKUP_HOOK`		在创建备份前执行的命令，`@BACKUP_FILE@`会替换为备份ZIP文件的完整路径，备份会阻塞直到命令返回。
`POST_BACKUP_HOOK`		在创建备份后执行的命令，`@BACKUP_FILE@`会替换为备份ZIP文件的完整路径，备份会阻塞直到命令返回，详见将备份复制到其他位置。
`PRE_UPDATE_CHECK_HOOK`		在执行更新检查前执行的命令，当前更新会阻塞直到命令返回。
`POST_UPDATE_CHECK_HOOK`		在执行更新检查后执行的命令，后续更新会阻塞直到命令返回。
`PRE_START_HOOK`		在valheim-updater首次启动服务器前执行的命令，当前启动会阻塞直到命令返回。
`POST_START_HOOK`		在valheim-updater首次启动服务器后执行的命令，后续重启和更新检查会阻塞直到命令返回。
`PRE_RESTART_HOOK`		在valheim-updater执行服务器重启前执行的命令，当前重启会阻塞直到命令返回。
`PRE_SERVER_LISTENING_HOOK`		在服务器运行后、能够接受连接前执行的命令，检查连接状态的循环会阻塞直到命令返回。
`POST_SERVER_LISTENING_HOOK`		在服务器

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问标签列表页面。

轩辕镜像加速拉取命令点我查看更多 valheim-server 镜像标签

docker pull docker.xuanyuan.run/lloesche/valheim-server:<标签>

使用方法：

DockerHub 原生拉取命令

docker pull lloesche/valheim-server:<标签>

轩辕镜像配置手册

探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式

Docker 配置

登录仓库拉取

通过 Docker 登录认证访问私有仓库

专属域名拉取

无需登录使用专属域名

K8s Containerd

Kubernetes 集群配置 Containerd

K3s

K3s 轻量级 Kubernetes 镜像加速

Dev Containers

VS Code Dev Containers 配置

Podman

Podman 容器引擎配置

Singularity/Apptainer

HPC 科学计算容器配置

其他仓库配置

ghcr、Quay、nvcr 等镜像仓库

Harbor 镜像源配置

Harbor Proxy Repository 对接专属域名

Portainer 镜像源配置

Portainer Registries 加速拉取

Nexus 镜像源配置

Nexus3 Docker Proxy 内网缓存

系统配置

Linux

在 Linux 系统配置镜像服务

Windows/Mac

在 Docker Desktop 配置镜像

MacOS OrbStack

MacOS OrbStack 容器配置

Docker Compose

Docker Compose 项目配置

NAS 设备

群晖

Synology 群晖 NAS 配置

飞牛

飞牛 fnOS 系统配置镜像

绿联

绿联 NAS 系统配置镜像

威联通

QNAP 威联通 NAS 配置

极空间

极空间 NAS 系统配置服务

网络设备

爱快路由

爱快 iKuai 路由系统配置

宝塔面板

在宝塔面板一键配置镜像

需要其他帮助？请查看我们的常见问题Docker 镜像访问常见问题解答或提交工单

镜像拉取常见问题

使用与功能问题

配置了专属域名后，docker search 为什么会报错？

docker search 限制

Docker Hub 上有的镜像，为什么在轩辕镜像网站搜不到？

站内搜不到镜像

机器不能直连外网时，怎么用 docker save / load 迁镜像？

离线 save/load

docker pull 拉插件报错（plugin v1+json）怎么办？

插件要用 plugin install

WSL 里 Docker 拉镜像特别慢，怎么排查和优化？

WSL 拉取慢

轩辕镜像安全吗？如何用 digest 校验镜像没被篡改？

安全与 digest

第一次用轩辕镜像拉 Docker 镜像，要怎么登录和配置？

新手拉取配置

轩辕镜像合规吗？轩辕镜像的合规是怎么做的？

镜像合规机制

错误码与失败问题

docker pull 提示 manifest unknown 怎么办？

manifest unknown

docker pull 提示 no matching manifest 怎么办？

no matching manifest（架构）

镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？

invalid tar header（解压）

Docker pull 时 HTTPS / TLS 证书验证失败怎么办？

TLS 证书失败

Docker pull 时 DNS 解析超时或连不上仓库怎么办？

DNS 超时

docker 无法连接轩辕镜像域名怎么办？

域名连通性排查

Docker 拉取出现 410 Gone 怎么办？

410 Gone 排查

出现 402 或「流量用尽」提示怎么办？

402 与流量用尽

Docker 拉取提示 UNAUTHORIZED（401）怎么办？

401 认证失败

遇到 429 Too Many Requests（请求太频繁）怎么办？

429 限流

docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？

D-Bus 凭证提示

为什么会出现「单层超过 20GB」或 413，无法加速拉取？

413 与超大单层

账号 / 计费 / 权限

轩辕镜像免费版和专业版有什么区别？

免费版与专业版区别

轩辕镜像支持哪些 Docker 镜像仓库？

支持的镜像仓库

镜像拉取失败还会不会扣流量？

失败是否计费

麒麟 V10 / 统信 UOS 提示 KYSEC 权限不够怎么办？

KYSEC 拦截脚本

如何在轩辕镜像申请开具发票？

申请开票

怎么修改轩辕镜像的网站登录和仓库登录密码？

修改登录密码

如何注销轩辕镜像账户？要注意什么？

注销账户

配置与原理类

写了 registry-mirrors，为什么还是走官方或仍然报错？

mirrors 不生效

怎么用 docker tag 去掉镜像名里的轩辕域名前缀？

去掉域名前缀

如何拉取指定 CPU 架构的镜像（如 ARM64、AMD64）？

指定架构拉取

用轩辕镜像拉镜像时快时慢，常见原因有哪些？

拉取速度原因

为什么拉取镜像的 :latest 标签，拿到的往往不是「最新」镜像？

latest 与「最新」

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"

lloesche/valheim-server

Valheim专用游戏服务器Docker镜像，支持自动更新、世界备份，以及BepInEx和ValheimPlus模组

lloesche/valheim-server Docker镜像

目录

基本Docker使用方法

环境变量

日志过滤器

日志过滤器事件钩子

事件钩子

镜像拉取方式

轩辕镜像加速拉取命令点我查看更多 valheim-server 镜像标签

DockerHub 原生拉取命令

更多 valheim-server 镜像推荐

tedtramonte/valheim-server

adaliszk/valheim-server

查看更多 valheim-server 相关镜像

轩辕镜像配置手册

Docker 配置

登录仓库拉取

专属域名拉取

K8s Containerd

K3s

Dev Containers

Podman

Singularity/Apptainer

其他仓库配置

Harbor 镜像源配置

Portainer 镜像源配置

Nexus 镜像源配置

系统配置

Linux

Windows/Mac

MacOS OrbStack

Docker Compose

NAS 设备

群晖

飞牛

绿联

威联通

极空间

网络设备

爱快路由

宝塔面板

镜像拉取常见问题

使用与功能问题

配置了专属域名后，docker search 为什么会报错？

Docker Hub 上有的镜像，为什么在轩辕镜像网站搜不到？

机器不能直连外网时，怎么用 docker save / load 迁镜像？

docker pull 拉插件报错（plugin v1+json）怎么办？

WSL 里 Docker 拉镜像特别慢，怎么排查和优化？

轩辕镜像安全吗？如何用 digest 校验镜像没被篡改？

第一次用轩辕镜像拉 Docker 镜像，要怎么登录和配置？

轩辕镜像合规吗？轩辕镜像的合规是怎么做的？

错误码与失败问题

docker pull 提示 manifest unknown 怎么办？

docker pull 提示 no matching manifest 怎么办？

镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？

Docker pull 时 HTTPS / TLS 证书验证失败怎么办？

Docker pull 时 DNS 解析超时或连不上仓库怎么办？

docker 无法连接轩辕镜像域名怎么办？

Docker 拉取出现 410 Gone 怎么办？

出现 402 或「流量用尽」提示怎么办？

Docker 拉取提示 UNAUTHORIZED（401）怎么办？

遇到 429 Too Many Requests（请求太频繁）怎么办？

docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？

为什么会出现「单层超过 20GB」或 413，无法加速拉取？

账号 / 计费 / 权限

轩辕镜像免费版和专业版有什么区别？

轩辕镜像支持哪些 Docker 镜像仓库？

镜像拉取失败还会不会扣流量？

麒麟 V10 / 统信 UOS 提示 KYSEC 权限不够怎么办？

如何在轩辕镜像申请开具发票？

怎么修改轩辕镜像的网站登录和仓库登录密码？

如何注销轩辕镜像账户？要注意什么？

配置与原理类

写了 registry-mirrors，为什么还是走官方或仍然报错？

怎么用 docker tag 去掉镜像名里的轩辕域名前缀？

如何拉取指定 CPU 架构的镜像（如 ARM64、AMD64）？

用轩辕镜像拉镜像时快时慢，常见原因有哪些？

为什么拉取镜像的 :latest 标签，拿到的往往不是「最新」镜像？