jammsen/palworld-dedicated-server Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Docker - 幻兽帕鲁专用服务器

![Build-Status master]([] ![Build-Status develop]([] !Docker 拉取量 !Docker 星标数 !镜像大小 ![]([]

[!TIP] 想与社区交流吗？

加入我们的***

此Docker镜像包含基于Linux和Docker的幻兽帕鲁(Palworld)专用服务器。

---

目录

• Docker - 幻兽帕鲁专用服务器
  • 目录
  • 如何获取此Docker镜像的支持
  • 前提要求
  • 最低系统要求
  • 更新日志
  • 致谢/鸣谢/贡献者
  • 快速入门
  • 环境变量
  • Docker Compose示例
    • 带RCON命令行工具的游戏服务器
  • 执行RCON命令
  • 备份管理器
  • Webhook集成
    • 支持的事件
  • 使用Helm部署
  • 常见问题(FAQ)
    • 此镜像是否支持Xbox专用服务器？
    • 如何在Portainer中使用此镜像的交互式控制台？
    • 如何查看幻兽帕鲁容器的配置文件？
    • 启动容器时日志中出现S_API错误怎么办？
    • 使用Apple Silicon硬件，能否运行此镜像？
    • 修改了BaseCampWorkerMaxNum设置，为何服务器没有更新？
  • 未来计划功能
  • 使用的软件

如何获取此Docker镜像的支持

如果需要此Docker镜像的支持：

• 欢迎创建新的Issue。
  • 若遇到类似问题，可通过#issue编号引用其他Issue。
• 按照提供帮助人员的指示操作并回答问题。
• 问题解决后，请关闭Issue，并考虑为此仓库和Docker Hub仓库点赞。
• 请注意，一周未活跃的Issue将被标记为不活跃并关闭。

请避免：

• 重复使用或复活旧Issue。这可能导致垃圾信息，并可能骚扰未同意参与新问题讨论的参与者。
• 若发生此类情况，我们保留锁定Issue或删除评论的权利，特此警告！

前提要求

运行此Docker镜像需要具备Docker、Docker Compose、Linux和网络（端口转发/NAT）的基础知识。

最低系统要求

更新日志

更新日志可在此处查看

致谢/鸣谢/贡献者

以下两位对本项目提供了巨大帮助，使我和本项目得以改进！如果您不喜欢我的Docker镜像版本或正在寻找其他功能，欢迎查看以下两个镜像：

• @thejcpalma - [] - [] - ❤️🫡
• @thijsvanloef - [] - [] - ❤️🫡

快速入门

1. 在Docker节点的游戏服务器目录中创建game子目录
   • 例如：/srv/palworld、/opt/palworld或/home/用户名/palworld
   • 此目录用于存储游戏服务器文件，包括配置和存档
   • 旧版本中需要通过CHMOD或CHOWN设置权限，现在已无需此操作！
2. 为Docker Compose文件中的端口设置端口转发或NAT
3. 拉取最新版本镜像：docker pull jammsen/palworld-dedicated-server:latest
4. 下载docker-compose.yml和default.env
5. 根据需求配置docker-compose.yml和default.env
   • 确保根据要使用的用户设置PUID和PGID
     • PUID和PGID为0将导致错误，这是有意为之！
     • 若以root用户运行Docker，容器内可使用1000
   • 更多信息请参考环境变量部分
6. 通过以下命令启动容器：docker-compose up -d && docker-compose logs -f
   • 观察日志，若无错误，可按ctrl+c关闭日志输出
7. 祝您游戏愉快！🎮😉

环境变量

环境变量文档请参见此文件

Docker Compose示例

带RCON命令行工具的游戏服务器

示例请参见docker-compose.yml。

执行RCON命令

[!NOTE] 请参考官方文档了解RCON命令：[***]

可直接在终端/Shell中使用docker exec palworld-dedicated-server rconcli <命令>执行RCON命令。

shell
$ docker exec palworld-dedicated-server rconcli showplayers
name,playeruid,steamid

$ docker exec palworld-dedicated-server rconcli info
欢迎使用幻兽服务器[v0.1.4.1] jammsen-docker-generated-20384

$ docker exec palworld-dedicated-server rconcli save
保存完成

备份管理器

[!WARNING] 若RCON被禁用，备份管理器将无法在创建备份前通过RCON执行保存操作，并会报告警告。 这意味着备份将基于服务器的上次自动保存创建。 可能导致数据丢失和/或存档损坏。

建议： 使用备份管理器前，请确保RCON已启用。

[!WARNING] 以下操作请始终使用-user steam选项，否则文件将以root用户权限创建

使用方法：docker exec -user steam palworld-dedicated-server backup [命令] [参数]

示例：

shell
$ docker exec -user steam palworld-dedicated-server backup create
> 备份 'saved-20240203_032855.tar.gz' 创建成功。

shell
$ docker exec -user steam palworld-dedicated-server backup list
> 列出 2 个备份文件！
2024-02-03 03:28:55 | saved-20240203_032855.tar.gz
2024-02-03 03:28:00 | saved-20240203_032800.tar.gz

shell
$ docker exec -user steam palworld-dedicated-server backup clean 3
> 清理了 1 个备份，保留 2 个备份。

shell
$ docker exec -user steam palworld-dedicated-server backup list 1
> 列出 1 个备份文件！
2024-02-03 03:30:00 | saved-20240203_033000.tar.gz

Webhook集成

要启用Webhook集成，需在default.env中设置以下环境变量：

shell
WEBHOOK_ENABLED=true
WEBHOOK_URL="[***]"

启用后，服务器将以***兼容格式向Webhook URL发送消息。

更多变量详情请参见此处。

支持的事件

• 服务器启动中
  • 此事件表示服务器正在启动，而非已启动。启动后约5秒服务器将上线
• 服务器已停止
• 服务器更新中
• 服务器更新并验证中

使用Helm部署

可使用palworld-helm Helm Chart部署此容器。

常见问题(FAQ)

此镜像是否支持Xbox专用服务器？

支持，只需将ALLOW_CONNECT_PLATFORM的值从Steam改为Xbox。更多文档请参见：[***]

如何在Portainer中使用此镜像的交互式控制台？

可运行docker exec -ti palworld-dedicated-server bash，或在Portainer的**“Stacks”标签中选择你的堆栈，点击容器名称，然后点击“Exec console”**按钮。

如何查看幻兽帕鲁容器的配置文件？

可运行docker exec -ti palworld-dedicated-server cat /palworld/Pal/Saved/Config/LinuxServer/PalWorldSettings.ini，将显示容器内的配置文件内容。

启动容器时日志中出现S_API错误怎么办？

类似[S_API FAIL] Tried to access Steam interface SteamUser021 before SteamAPI_Init succeeded.的错误可安全忽略。

使用Apple Silicon硬件，能否运行此镜像？

可尝试在docker-compose文件的palworld服务中添加参数platform: linux/amd64。这并非Apple Silicon的专用修复，而是用于非x86主机。ARM支持仅通过强制x86模拟实现（若主机未默认启用）。Rosetta负责翻译/模拟x86指令。

修改了BaseCampWorkerMaxNum设置，为何服务器没有更新？

这是一个已知问题。在PalWorldSettings.ini中修改BaseCampWorkerMaxNum对服务器无影响。可使用第三方工具解决，例如：<[***]>

[!WARNING] 添加WorldOption.sav将导致PalWorldSetting.ini失效。因此，对设置的任何新更改（无论是通过文件还是环境变量），都需要重新创建WorldOption.sav才能生效。

未来计划功能

• 欢迎提出建议。在“Issues”中可选择“Feature Request”类型提交功能请求。

使用的软件

• CM2Network SteamCMD - 基于Debian（Valve官方推荐 - [***]
• Supercronic - [***]
• rcon-cli - [***]
• 幻兽帕鲁专用服务器（APP-ID: 2394010 - [***]