jammsen/palworld-dedicated-server Docker Image Overview

jammsen/palworld-dedicated-server

基于Docker的幻兽帕鲁(Palworld)专用服务器镜像，支持Linux环境部署，提供配置自定义、RCON命令管理、自动备份及Webhook通知功能，可快速搭建多人游戏服务器。

64 收藏0 次下载activejammsen镜像

🚀专业版镜像服务，面向生产环境设计

中文简介版本下载

🚀专业版镜像服务，面向生产环境设计

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）的基础知识。

最低系统要求

资源	1-8名玩家	8-12+名玩家
CPU	4核高频CPU	6-8核高频CPU
内存	基础8GB + 每玩家2GB	基础12GB + 每玩家2GB
存储	30GB	30GB+

更新日志

更新日志可在此处查看

致谢/鸣谢/贡献者

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

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

快速入门

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

环境变量

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

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 [命令] [参数]

命令	参数	必选/可选	默认值	取值范围	描述
create	N/A	N/A	N/A	N/A	创建备份。
list	`<显示数量>`	可选	N/A	正整数	列出所有备份。若指定`<显示数量>`，则仅列出最近的`<显示数量>`个备份。
clean	`<保留数量>`	可选	`BACKUP_RETENTION_AMOUNT_TO_KEEP`	正整数	清理备份。若指定`<保留数量>`，则清理并保留最近的`<保留数量>`个备份。若未指定，默认使用`BACKUP_RETENTION_AMOUNT_TO_KEEP`变量

示例：

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 - [***]

查看更多 palworld-dedicated-server 相关镜像 →

linuxserver/code-server

by linuxserver.io

linuxserver/code-server是VS Code服务器版Docker镜像，可在浏览器中运行完整VS Code开发环境，无需本地安装即可跨设备访问。支持全部VS Code扩展、代码同步与终端功能，适配远程开发、团队协作或低配置设备场景。镜像经linuxserver优化，兼容ARM/AMD架构，内置持久化存储与安全配置，开箱即用，轻松打造云端IDE，提升开发灵活性与效率。

72750M+ pulls

上次更新：3 天前

doctorserver/tf2-dedicated-server

by doctorserver

Includes all necessary dependencies and configurations to quickly deploy and manage a TF2 server.

10K+ pulls

上次更新：10 个月前

linuxserver/openssh-server

by linuxserver.io

提供OpenSSH服务器服务，支持远程登录与服务器管理，具备易于部署、配置灵活的特点，适用于各类需要安全远程访问的场景。

14310M+ pulls

上次更新：10 天前

mailserver/docker-mailserver

by Docker Mailserver

一个全栈且简单易用的邮件服务器，支持SMTP、IMAP协议，集成LDAP、反垃圾邮件及反病毒等功能。

由LinuxServer.io提供的Sonarr容器，是一款专为电视节目集管理设计的自动化工具，能够监控指定剧集的更新信息、自动从索引器获取下载链接并通过下载客户端（如Deluge、qBittorrent等）完成资源下载，同时支持按自定义规则整理文件结构、重命名剧集文件以保持媒体库整洁有序；LinuxServer.io作为专注于提供高质量容器化应用的团队，其构建的Sonarr容器基于轻量级Linux系统，优化了资源占用与运行稳定性，适合家庭媒体服务器或个人影视库的自动化管理场景使用。

这是由LinuxServer.io提供的Jackett容器，其中Jackett是一款实用的种子索引聚合工具，能够整合多个torrent追踪器的搜索结果，为qBittorrent、Deluge等各类P2P下载客户端提供统一的搜索接口，帮助用户更便捷地查找和获取所需资源；而LinuxServer.io团队凭借专业的容器化技术，确保该Jackett容器具备稳定的运行环境、简便的部署流程以及持续的更新支持，可满足用户在不同系统环境下高效使用Jackett的需求。

12011B+ pulls

上次更新：13 小时前

轩辕镜像配置手册

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

登录仓库拉取

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

Linux

在 Linux 系统配置镜像服务

Windows/Mac

在 Docker Desktop 配置镜像

Docker Compose

Docker Compose 项目配置

K8s Containerd

Kubernetes 集群配置 Containerd

K3s

K3s 轻量级 Kubernetes 镜像加速

Dev Containers

VS Code Dev Containers 配置

MacOS OrbStack

MacOS OrbStack 容器配置

宝塔面板

在宝塔面板一键配置镜像

群晖

Synology 群晖 NAS 配置

飞牛

飞牛 fnOS 系统配置镜像

极空间

极空间 NAS 系统配置服务

爱快路由

爱快 iKuai 路由系统配置

绿联

绿联 NAS 系统配置镜像

威联通

QNAP 威联通 NAS 配置

Podman

Podman 容器引擎配置

Singularity/Apptainer

HPC 科学计算容器配置

其他仓库配置

ghcr、Quay、nvcr 等镜像仓库

专属域名拉取

无需登录使用专属域名

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

镜像拉取常见问题

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

免费版仅支持 Docker Hub 访问，不承诺可用性和速度；专业版支持更多镜像源，保证可用性和稳定速度，提供优先客服响应。

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

专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等；免费版仅支持 docker.io。

流量耗尽错误提示

当返回 402 Payment Required 错误时，表示流量已耗尽，需要充值流量包以恢复服务。

410 错误问题

通常由 Docker 版本过低导致，需要升级到 20.x 或更高版本以支持 V2 协议。

manifest unknown 错误

先检查 Docker 版本，版本过低则升级；版本正常则验证镜像信息是否正确。

镜像拉取成功后，如何去掉轩辕镜像域名前缀？

使用 docker tag 命令为镜像打上新标签，去掉域名前缀，使镜像名称更简洁。

查看全部问题→

用户好评

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

oldzhang

运维工程师

Linux服务器

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

jammsen/palworld-dedicated-server Docker 镜像 - 轩辕镜像

Docker - 幻兽帕鲁专用服务器

目录

如何获取此Docker镜像的支持

前提要求

最低系统要求

更新日志

致谢/鸣谢/贡献者

快速入门

环境变量

Docker Compose示例

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

执行RCON命令

备份管理器

Webhook集成

支持的事件

使用Helm部署

常见问题(FAQ)

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

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

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

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

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

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

未来计划功能

使用的软件

轩辕镜像配置手册

登录仓库拉取

Linux

Windows/Mac

Docker Compose

K8s Containerd

K3s

Dev Containers

MacOS OrbStack

宝塔面板

群晖

飞牛

极空间

爱快路由

绿联

威联通

Podman

Singularity/Apptainer

其他仓库配置

专属域名拉取

镜像拉取常见问题

用户好评