Palworld Dedicated Server Docker

![Release]([] ![Docker Pulls]([] ![Docker Stars]([] ![Image Size]([] ![]([]

镜像概述和主要用途

这是一个Docker容器，帮助您快速搭建和运行自己的Palworld专用服务器。该Docker容器已在Linux（Ubuntu/Debian）和Windows 10系统上测试并正常工作。

核心功能和特性

• 简化Palworld服务器部署流程
• 支持自动更新服务器
• 内置备份和恢复功能
• 支持RCON管理
• 可配置的自动备份、更新和重启
• 支持***通知集成
• 多平台兼容（Linux、Windows）
• 可定制的服务器设置
• 支持锁定特定游戏版本

服务器要求

使用场景和适用范围

• 个人或小团体搭建私人Palworld服务器
• 社区服务器托管
• 希望自定义服务器设置的玩家
• 需要可靠服务器管理和备份功能的场景
• 企业或组织内部游戏服务器部署

使用方法和配置说明

Docker Compose

本仓库包含一个示例的docker-compose.yml文件，可用于设置服务器：

yaml
services:
   palworld:
      image: thijsvanloef/palworld-server-docker:latest
      restart: unless-stopped
      container_name: palworld-server
      stop_grace_period: 30s # 设置等待容器优雅停止的时间
      ports:
        - 8211:8211/udp
        - 27015:27015/udp
      environment:
         PUID: 1000
         PGID: 1000
         PORT: 8211 # 可选但推荐设置
         PLAYERS: 16 # 可选但推荐设置
         SERVER_PASSWORD: "worldofpals" # 可选但推荐设置
         MULTITHREADING: true
         RCON_ENABLED: true
         RCON_PORT: 25575
         TZ: "UTC"
         ADMIN_PASSWORD: "adminPasswordHere"
         COMMUNITY: false  # 如果希望服务器显示在社区服务器列表中，请启用此项，需配合SERVER_PASSWORD使用
         SERVER_NAME: "palworld-server-docker by Thijs van Loef"
         SERVER_DESCRIPTION: "palworld-server-docker by Thijs van Loef"
      volumes:
         - ./palworld:/palworld/

作为替代方案，您可以将.env.example文件复制到名为**.env**的新文件中，根据需要修改，并将docker-compose.yml修改为：

yaml
services:
   palworld:
      image: thijsvanloef/palworld-server-docker:latest
      restart: unless-stopped
      container_name: palworld-server
      stop_grace_period: 30s # 设置等待容器优雅停止的时间
      ports:
        - 8211:8211/udp
        - 27015:27015/udp
      env_file:
         -  .env
      volumes:
         - ./palworld:/palworld/

Docker Run

将所有<>替换为您自己的配置：

bash
docker run -d \
    --name palworld-server \
    -p 8211:8211/udp \
    -p 27015:27015/udp \
    -v ./palworld:/palworld/ \
    -e PUID=1000 \
    -e PGID=1000 \
    -e PORT=8211 \
    -e PLAYERS=16 \
    -e MULTITHREADING=true \
    -e RCON_ENABLED=true \
    -e RCON_PORT=25575 \
    -e TZ=UTC \
    -e ADMIN_PASSWORD="adminPasswordHere" \
    -e SERVER_PASSWORD="worldofpals" \
    -e COMMUNITY=false \
    -e SERVER_NAME="palworld-server-docker by Thijs van Loef" \
    -e SERVER_DESCRIPTION="palworld-server-docker by Thijs van Loef" \
    --restart unless-stopped \
    --stop-timeout 30 \
    thijsvanloef/palworld-server-docker:latest

作为替代方案，您可以使用.env文件：

bash
docker run -d \
    --name palworld-server \
    -p 8211:8211/udp \
    -p 27015:27015/udp \
    -v ./palworld:/palworld/ \
    --env-file .env \
    --restart unless-stopped \
    --stop-timeout 30 \
    thijsvanloef/palworld-server-docker:latest

Kubernetes

部署此容器到Kubernetes所需的所有文件都位于k8s文件夹中。请按照k8s/readme.md中的步骤进行部署。

非root用户运行

这仅适用于高级用户。可以运行此容器并覆盖默认用户（此镜像中的默认用户是root）。

指定用户和组后，PUID和PGID将被忽略。

要查找您的UID：id -u 要查找您的GID：id -g

您必须将用户设置为数字UID:数字GID

假设您的UID是1000，GID是1001：

• 在docker run命令中添加--user 1000:1001 \
• 在docker compose中添加user: 1000:1001

如果希望使用与自己不同的UID/GID运行，需要更改绑定目录的所有权：chown UID:GID palworld/或更改所有用户的权限：chmod o=rwx palworld/

Helm Chart

***helm chart位于单独的仓库：palworld-server-chart

环境变量详解

您可以使用以下值在启动时更改服务器设置。强烈建议在启动服务器前设置以下环境变量：

• PLAYERS
• PORT
• PUID
• PGID

*强烈建议设置 ** 启用此选项时请确保了解其作用 *** Docker停止时保存和优雅关闭服务器所需

重要提示：环境变量中使用的布尔值区分大小写，必须使用true或false才能使选项生效。

游戏端口说明

RCON使用方法

palworld-server-docker镜像默认启用RCON。打开RCON命令行非常简单：

bash
docker exec -it palworld-server rcon-cli

这将打开一个使用RCON向Palworld服务器发送命令的命令行界面。

服务器命令列表

完整命令列表请访问：[***]

备份与恢复

创建备份

要创建当前游戏存档的备份，请使用以下命令：

bash
docker exec palworld-server backup

这将在/palworld/backups/目录下创建一个备份。如果启用了rcon，服务器将在备份前运行保存。

从备份恢复

要从备份恢复，请使用以下命令：

bash
docker exec -it palworld-server restore

必须将RCON_ENABLED环境变量设置为true才能使用此命令。

重要提示：如果docker重启策略未设置为always或unless-stopped，服务器将关闭并需要手动重启。示例docker run命令和docker compose文件已使用所需策略。

手动从备份恢复

在/palworld/backups/中找到要恢复的备份并解压缩。需要先停止服务器：

bash
docker compose down

删除位于palworld/Pal/Saved/SaveGames/0/<旧哈希值>的旧存档文件夹。

将新解压缩的存档文件夹Saved/SaveGames/0/<新哈希值>的内容复制到palworld/Pal/Saved/SaveGames/0/<新哈希值>。

在palworld/Pal/Saved/Config/LinuxServer/GameUserSettings.ini中，将DedicatedServerName替换为新文件夹名称：

ini
DedicatedServerName=<新哈希值>  # 替换为你的文件夹名称

重启游戏（如果使用Docker Compose）：

bash
docker compose up -d

自动备份配置

服务器将根据TZ设置的时区在每天午夜自动备份。

设置BACKUP_ENABLED启用或禁用自动备份（默认启用）。

BACKUP_CRON_EXPRESSION是cron表达式，用于定义作业运行间隔。

提示：此镜像使用Supercronic处理crons，参见supercronic或Crontab Generator。

设置BACKUP_CRON_EXPRESSION更改默认计划。例如，将BACKUP_CRON_EXPRESSION设置为0 2 * * *，备份脚本将在每天凌晨2:00运行。

自动更新配置

要使用服务器自动更新功能，必须将以下环境变量设置为true：

• RCON_ENABLED
• UPDATE_ON_BOOT

重要提示：如果docker重启策略未设置为always或unless-stopped，服务器将关闭并需要手动重启。示例docker run命令和docker compose文件已使用所需策略。

设置AUTO_UPDATE_ENABLED启用或禁用自动更新（默认禁用）。

AUTO_UPDATE_CRON_EXPRESSION是cron表达式，用于定义作业运行间隔。

自动重启配置

要使用服务器自动重启功能，需启用RCON_ENABLED。

重要提示：如果docker重启策略未设置为always或unless-stopped，服务器将关闭并需要手动重启。示例docker run命令和docker compose文件已使用所需策略。

设置AUTO_REBOOT_ENABLED启用或禁用自动重启（默认禁用）。

AUTO_REBOOT_CRON_EXPRESSION是cron表达式，用于定义作业运行间隔，默认根据TZ设置的时区在每天午夜重启。

服务器设置编辑

使用环境变量

重要提示：由于游戏仍处于测试阶段，这些环境变量/设置可能会发生变化。请查看***网页获取支持的参数。

将服务器设置转换为环境变量遵循相同原则（有一些例外）：

• 全部大写字母
• 用下划线分隔单词
• 如果设置以单个字母开头（如'b'），删除该字母

例如：

• Difficulty -> DIFFICULTY
• PalSpawnNumRate -> PAL_SPAWN_NUM_RATE
• bIsPvP -> IS_PVP

所有变量：[***]

手动编辑配置文件

服务器启动时，将在以下位置创建PalWorldSettings.ini文件：<挂载文件夹>/Pal/Saved/Config/LinuxServer/PalWorldSettings.ini

请注意，环境变量将始终覆盖对PalWorldSettings.ini所做的更改。

重要提示：只能在服务器关闭时对PalWorldSettings.ini进行更改。服务器运行时所做的任何更改将在服务器停止时被覆盖。

详细的服务器设置列表请访问：Palworld Wiki

更详细的服务器设置说明请访问：shockbyte

*** Webhooks使用

1. 在服务器设置中为您的服务器生成webhook URL。

2. 使用*** webhook URL设置环境变量：

docker run方式：

sh
-e ***_WEBHOOK_URL="[***]" \
-e ***_PRE_UPDATE_BOOT_MESSAGE="服务器正在更新..." \

docker compose方式：

yaml
- ***_WEBHOOK_URL=[***]
- ***_PRE_UPDATE_BOOT_MESSAGE=服务器正在更新...

锁定特定游戏版本

警告：可以降级到较低的游戏版本，但尚不清楚这对现有存档有什么影响。请自行承担风险！

如果设置了TARGET_MANIFEST_ID环境变量，将把服务器版本锁定到特定的manifest。manifest对应发布日期/更新版本。可以使用SteamCMD或SteamDB等网站找到manifest