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

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

palworld-server-docker 项目地址: https://gitcode.com/gh_mirrors/pa/palworld-server-docker

项目概述

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专用服务器。如需进一步帮助，可以参考项目的官方文档。

palworld-server-docker 项目地址: https://gitcode.com/gh_mirrors/pa/palworld-server-docker