mirror of
https://github.com/YuzuZensai/palworld-server-docker.git
synced 2026-01-06 04:32:43 +00:00
214 lines
12 KiB
Markdown
214 lines
12 KiB
Markdown
# Palworld Dedicated Server Docker
|
||
|
||
[](https://github.com/thijsvanloef/palworld-server-docker/releases)
|
||
[](https://hub.docker.com/r/thijsvanloef/palworld-server-docker)
|
||
[](https://hub.docker.com/r/thijsvanloef/palworld-server-docker)
|
||
[](https://hub.docker.com/r/thijsvanloef/palworld-server-docker/tags)
|
||
[](https://discord.com/invite/UxBxStPAAE)
|
||
[](https://github.com/thijsvanloef/palworld-server-docker?tab=readme-ov-file#palworld-dedicated-server-docker)
|
||
|
||
在 [Docker Hub](https://hub.docker.com/r/thijsvanloef/palworld-server-docker) 查看
|
||
|
||
加入我们的 [Discord](https://discord.gg/UxBxStPAAE)
|
||
|
||
[English](/README.md) | [한국어](/docs/kr/README.md) | [简体中文](/docs/zh-CN/README.md)
|
||
|
||
> [!TIP]
|
||
> 不知道从何开始？ [看看这里吧！](https://tice.tips/containerization/palworld-server-docker/)
|
||
|
||
这是一个 [Docker](https://docs.docker.com/engine/install/) 容器，可帮助您创建自己的
|
||
[幻兽帕鲁](https://store.steampowered.com/app/1623730/Palworld/) 服务器
|
||
|
||
此容器经测试可正常在 (Ubuntu/Debian) 和 Windows 10 上运行
|
||
|
||
> [!IMPORTANT]
|
||
> 目前, Xbox Game Pass/Xbox 主机玩家无法加入服务器
|
||
>
|
||
> 他们只能通过邀请码加入，并且最多允许4人游玩
|
||
|
||
## 服务器配置需求
|
||
|
||
| 资源 | 最小 | 推荐 |
|
||
|----------|---------|------------------------------------------|
|
||
| CPU | 4 核 | 4+ 核以上 |
|
||
| 内存 | 16GB | 推荐 32GB 以上以稳定运行 |
|
||
| 存储空间 | 4GB | 12GB |
|
||
|
||
## 开始使用
|
||
|
||
注意，您需要配置 [环境变量](#环境变量).
|
||
|
||
### Docker Compose
|
||
|
||
您可以直接使用 [docker-compose.yml](/docker-compose.yml) 来配置您的服务器
|
||
|
||
```yml
|
||
services:
|
||
palworld:
|
||
image: thijsvanloef/palworld-server-docker:latest
|
||
restart: unless-stopped
|
||
container_name: palworld-server
|
||
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=Asia/Shanghai
|
||
- ADMIN_PASSWORD="adminPasswordHere"
|
||
- COMMUNITY=false # 如果您希望服务器显示在社区服务器页中，请启用此选项（注意配置SERVER_PASSWORD!）
|
||
- SERVER_NAME="World of Pals"
|
||
volumes:
|
||
- ./palworld:/palworld/
|
||
```
|
||
|
||
### Docker Run
|
||
|
||
将`<palworld-folder>`修改为您自己的路径
|
||
|
||
```bash
|
||
docker run -d \
|
||
--name palworld-server \
|
||
-p 8211:8211/udp \
|
||
-p 27015:27015/udp \
|
||
-v ./<palworld-folder>:/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="adminPasswordHere" \
|
||
-e SERVER_PASSWORD="worldofpals" \
|
||
-e COMMUNITY=false \
|
||
-e SERVER_NAME="World of Pals" \
|
||
--restart unless-stopped \
|
||
thijsvanloef/palworld-server-docker:latest
|
||
|
||
```
|
||
|
||
### Kubernetes
|
||
|
||
将此容器部署到 Kubernetes 的所有文件都位于[此文件夹中](k8s/).
|
||
|
||
请按照 [此处](k8s/readme.md) 进行部署
|
||
|
||
#### 使用 helm 部署
|
||
|
||
请按照 [此处](./chart/README.md) 进行部署
|
||
|
||
### 环境变量
|
||
|
||
您可以使用以下值来修改服务器设置
|
||
强烈建议您在启动服务器之前设置以下变量：
|
||
|
||
* PLAYERS
|
||
* PORT
|
||
* PUID
|
||
* PGID
|
||
|
||
| 变量 | 信息 | 默认值 | 允许值 |
|
||
|------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------|------------------------------------------------------------------------------------------------------------|
|
||
| TZ | 备份服务器时所使用的时间戳 | UTC | 参见 [时区列表](https://zh.wikipedia.org/wiki/%E6%97%B6%E5%8C%BA%E5%88%97%E8%A1%A8) |
|
||
| PLAYERS* | 可同加入服务器的最大玩家数 | 16 | 1-32 |
|
||
| PORT* | 服务器将开放的 UDP 端口 | 8211 | 1024-65535 |
|
||
| PUID* | 服务器运行时的用户的 UID | 1000 | !0 |
|
||
| PGID* | 服务器运行时的组的 GID | 1000 | !0 |
|
||
| MULTITHREADING** | 提高多线程 CPU 环境下的性能。它最多对 4 个线程有效，分配超过这个数量的线程没有太大意义 | false | true/false |
|
||
| COMMUNITY | 服务器是否显示在社区服务器页中（建议设置SERVER_PASSWORD） | false | true/false |
|
||
| PUBLIC_IP | 您可以手动指定服务器 IP 地址。若未指定，将自动检测 | | x.x.x.x |
|
||
| PUBLIC_PORT | 您可以手动指定服务器端口。若未指定，将自动检测 | | 1024-65535 |
|
||
| SERVER_NAME | 服务器名称 | | "string" |
|
||
| SERVER_PASSWORD | 为服务器设置密码 | | "string" |
|
||
| ADMIN_PASSWORD | 为服务器设置管理员密码 | | "string" |
|
||
| UPDATE_ON_BOOT** | 在启动 Docker 容器时更新/安装服务器（需要在第一次运行时启用） | true | true/false |
|
||
| RCON_ENABLED*** | 为服务器启用 RCON | true | true/false |
|
||
| RCON_PORT | RCON 连接端口 | 25575 | 1024-65535 |
|
||
| QUERY_PORT | 用于与 Steam 服务器通信的查询端口 | 27015 | 1024-65535 |
|
||
|
||
*强烈建议设置
|
||
|
||
** 启用该选项时，请确保您知道自己在做什么
|
||
|
||
*** 是使用docker命令保存并关闭服务器的必要条件
|
||
|
||
> [!IMPORTANT]
|
||
> 环境变量中使用的布尔值区分大小写，因为它们是在 shell 脚本中使用的
|
||
>
|
||
> 必须准确使用 `true` 或 `false` 设置它们，选项才能生效
|
||
|
||
### Game Ports
|
||
|
||
| 端口 | 信息 |
|
||
|-------|------------------|
|
||
| 8211 | 游戏端口 (UDP) |
|
||
| 27015 | 查询端口 (UDP) |
|
||
| 25575 | RCON 端口 (TCP) |
|
||
|
||
## 使用 RCON
|
||
|
||
RCON 已在此项目中默认开启
|
||
使用 RCON CLI 非常简单:
|
||
|
||
```bash
|
||
docker exec -it palworld-server rcon-cli
|
||
```
|
||
|
||
这将打开一个 CLI，使用 RCON 使用服务器命令
|
||
|
||
### 命令列表
|
||
|
||
| 命令 | 信息 |
|
||
|----------------------------------|-----------------------------------------------------|
|
||
| Shutdown {秒} {信息} | 服务器将在{秒}后关闭 |
|
||
| DoExit | 强制关闭服务器 |
|
||
| Broadcast | 向服务器中所有玩家发送消息 |
|
||
| KickPlayer {SteamID} | 从服务器中踢出玩家 |
|
||
| BanPlayer {SteamID} | 从服务器中封禁玩家 |
|
||
| TeleportToPlayer {SteamID} | 传送到目标玩家 |
|
||
| TeleportToMe {SteamID} | 将目标玩家传送到身边 |
|
||
| ShowPlayers | 显示所有已连接玩家信息 |
|
||
| Info | 显示服务器信息 |
|
||
| Save | 保存游戏 |
|
||
|
||
请查看 [官方文档](https://tech.palworldgame.com/server-commands) 以获取所有命令
|
||
|
||
## 创建备份
|
||
|
||
To create a backup of the game's save at the current point in time, use the command:
|
||
|
||
```bash
|
||
docker exec palworld-server backup
|
||
```
|
||
|
||
执行后将在 `/palworld/backups/` 文件夹中生成备份
|
||
|
||
若启用了 RCON，服务器将在备份前进行保存
|
||
|
||
## 修改服务器设置
|
||
|
||
服务器启动时， `PalWorldSettings.ini` 文件将在 `<mount_folder>/Pal/Saved/Config/LinuxServer` 文件夹中生成
|
||
|
||
所有更改将在服务器下次启动时生效
|
||
|
||
请注意，环境变量将始终覆盖对 `PalWorldSettings.ini` 所做的更改
|
||
|
||
服务器配置文件参数相关说明，请在
|
||
[shockbyte](https://shockbyte.com/billing/knowledgebase/1189/How-to-Configure-your-Palworld-server.html) 中查看
|
||
|
||
## 报告问题/功能请求
|
||
|
||
可通过 [此链接](https://github.com/thijsvanloef/palworld-server-docker/issues/new/choose) 报告问题/功能请求
|
||
|
||
### 已知问题
|
||
|
||
已知问题已在 [Wiki](https://github.com/thijsvanloef/palworld-server-docker/wiki/Known-Issues) 中列出
|