使用Docker部署Palworld专用服务器的完整指南

项目概述

Palworld-server-docker是一个专为Palworld游戏设计的Docker容器解决方案，它简化了Palworld专用服务器的部署和管理流程。该项目支持跨平台运行，包括Linux(Ubuntu/Debian)、Windows 10和macOS(包括Apple Silicon设备)。

系统要求

在部署前，请确保您的服务器满足以下硬件要求：

资源类型	最低配置	推荐配置
CPU	4核	4核以上
内存	16GB	32GB以上
存储空间	8GB	20GB

部署方法

使用Docker Compose部署

1. 创建docker-compose.yml文件，内容如下：

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="yourpassword"
      - MULTITHREADING=true
      - RCON_ENABLED=true
      - RCON_PORT=25575
      - TZ=Asia/Shanghai
      - ADMIN_PASSWORD="adminPassword"
      - COMMUNITY=false
      - SERVER_NAME="My Palworld Server"
    volumes:
      - ./palworld:/palworld/

2. 使用以下命令启动服务：

docker-compose up -d

使用Docker Run直接部署

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=Asia/Shanghai \
    -e ADMIN_PASSWORD=adminPassword \
    -e SERVER_PASSWORD=yourpassword \
    -e COMMUNITY=false \
    -e SERVER_NAME="My Palworld Server" \
    --restart unless-stopped \
    --stop-timeout 30 \
    thijsvanloef/palworld-server-docker:latest

关键环境变量配置

以下是一些关键环境变量的说明：

变量名	描述	默认值	建议值
PLAYERS	最大玩家数量	16	1-32
PORT	游戏服务器端口(UDP)	8211	1024-65535
SERVER_PASSWORD	服务器密码	无	建议设置
ADMIN_PASSWORD	管理员密码	无	必须设置
MULTITHREADING	启用多线程	false	性能优化建议true
RCON_ENABLED	启用远程控制	true	建议保持true
BACKUP_ENABLED	启用自动备份	true	建议保持true

服务器管理

RCON远程控制

RCON默认已启用，可以通过以下命令使用：

docker exec -it palworld-server rcon-cli "Broadcast Hello everyone"

常用RCON命令包括：

• Shutdown {秒数} {消息} - 定时关闭服务器
• ShowPlayers - 显示在线玩家
• Save - 手动保存游戏
• KickPlayer {SteamID} - 踢出玩家

备份与恢复

手动创建备份：

docker exec palworld-server backup

恢复备份：

docker exec -it palworld-server restore

备份文件存储在容器的/palworld/backups/目录下。

自动维护设置

通过环境变量可以配置自动维护任务：

1. 自动备份：

BACKUP_CRON_EXPRESSION: "0 0 * * *"  # 每天午夜备份
DELETE_OLD_BACKUPS: true             # 删除旧备份
OLD_BACKUP_DAYS: 30                  # 保留30天内的备份

2. 自动更新：

AUTO_UPDATE_ENABLED: true
AUTO_UPDATE_CRON_EXPRESSION: "0 * * * *"  # 每小时检查更新

3. 自动重启：

AUTO_REBOOT_ENABLED: true
AUTO_REBOOT_CRON_EXPRESSION: "0 0 * * *"  # 每天午夜重启

常见问题解决

1. ARM架构设备支持： 如果您使用Raspberry Pi、M1/M2 Mac等ARM设备，请使用:latest-arm64镜像标签。

2. 端口冲突： 确保8211(UDP)、27015(UDP)和25575(TCP)端口未被其他服务占用。

3. 性能优化：

   • 启用MULTITHREADING=true可提升多核CPU性能
   • 定期重启服务器可释放内存

4. 数据持久化： 务必配置volume映射(./palworld:/palworld/)以防止数据丢失。

通过本指南，您应该能够顺利部署并管理自己的Palworld专用服务器。如需进一步帮助，可以参考项目的官方文档。