Valheim Linux Docker服务器启用-crossplay flag时的libparty.so加载异常问题

问题背景 #

基于debian:bullseye-slim镜像运行Valheim服务器，添加-crossplay启动参数后出现两个连续问题：

1. 初始错误：libparty.so无法预加载（Crossplay核心组件）

   18.05 14:25:42 [Server] INFO Unable to preload the following plugins:
   18.05 14:25:42 [Server] INFO libparty.so
   

2. 安装libpulse-dev后出现致命段错误：

   18.05 14:33:40 [Server] INFO Caught fatal signal - signo:11 code:1 errno:0 addr:0x20
   

解决方案 #

1. 安装完整的运行时依赖 #

libparty.so的依赖不止libpulse-dev（开发包），运行时需要基础库，且bullseye-slim缺少Valheim Crossplay所需的系统依赖。执行以下命令安装完整依赖：

apt update && apt install -y libpulse0 libssl1.1 libcurl4 libgssapi-krb5-2 libsdl2-2.0-0

• 说明：libpulse0是libpulse-dev对应的运行时库，其余库是PlayFab（Crossplay依赖的后端服务）和Valheim服务器的必要依赖。

2. 修复目录权限与挂载 #

段错误常因权限不足导致配置文件无法生成或读取，确保容器运行时：

• 挂载本地数据目录到容器内的Valheim服务器目录，保证数据持久化且权限正确：

  docker run -v /host/path/to/valheim/data:/valheim -u $(id -u):$(id -g) your-valheim-image
  

• -u $(id -u):$(id -g)会让容器进程以当前宿主用户身份运行，避免权限冲突。

3. 改用完整基础镜像（可选） #

如果bullseye-slim的精简环境仍存在依赖缺失问题，直接使用debian:bullseye完整镜像，或使用社区维护的Valheim服务器镜像（如linuxserver/valheim），这类镜像已预配置好所有Crossplay所需组件，无需手动安装依赖。

验证 #

完成上述操作后，重新启动服务器，查看日志：

• 确认libparty.so预加载成功
• 无致命段错误日志
• 尝试通过Crossplay功能连接服务器，验证功能正常

内容的提问来源于stack exchange，提问作者Dectom