Docker部署PokeRogue游戏：NAS家庭娱乐实战指南-代码聚汇网

Docker部署PokeRogue游戏：NAS家庭娱乐实战指南

清单控沙牛

1. 项目背景与核心价值

去年在整理NAS上的游戏资源时，偶然发现了一款开源的像素风宝可梦同人游戏PokeRogue。这个基于网页端的roguelike游戏完美复刻了经典宝可梦的战斗机制，又加入了随机地图和永久死亡机制，特别适合在NAS上部署后随时用浏览器打开游玩。相比传统游戏部署方案，用Docker容器化部署具有以下优势：

资源占用极低（容器镜像仅300MB左右）
完全脱离平台限制（任何设备通过浏览器即可访问）
数据持久化存储（游戏进度自动保存到NAS）
支持多用户同时在线对战

实测在绿联DX4600上部署后，手机/平板/电脑都能流畅运行，特别适合家庭娱乐场景。下面分享详细部署过程和调优技巧。

2. 环境准备与部署流程

2.1 基础环境配置

推荐使用绿联NAS的UGOS系统（基于Linux），需提前完成以下准备：

在应用中心安装Docker Manager
创建专用存储目录（建议至少分配5GB空间）
开启SSH访问（用于调试容器）

注意：不同型号绿联NAS的Docker管理界面可能略有差异，但核心功能一致。如果找不到相关选项，建议先升级系统到最新版本。

2.2 容器部署实操

通过Docker CLI部署最为可靠（绿联的Web界面有时会丢失参数）：

bash复制docker run -d \
  --name=pokerogue \
  -p 3000:3000 \
  -v /mnt/nas/games/pokerogue:/app/data \
  --restart unless-stopped \
  ghcr.io/pokerogue/pokerogue:latest

关键参数说明：

-p 3000:3000：将容器内3000端口映射到主机
-v参数：持久化保存游戏数据和配置
ghcr.io镜像：官方维护的最新稳定版

部署完成后，在浏览器访问http://NAS_IP:3000即可进入游戏。

3. 高级配置与优化

3.1 性能调优方案

针对低功耗NAS设备的优化建议：

内存限制（绿联设备通常内存有限）：

bash复制docker update --memory 512M --memory-swap 1G pokerogue

CPU优先级：

bash复制docker update --cpus 0.5 pokerogue

定时重启（预防内存泄漏）：
在绿联NAS的任务计划中添加每日重启：
```
code复制0 4 * * * docker restart pokerogue
```

3.2 安全增强措施

反向代理配置（推荐使用绿联自带的Nginx）：

nginx复制location /pokerogue {
  proxy_pass http://localhost:3000;
  proxy_set_header Upgrade $http_upgrade;
  proxy_set_header Connection "upgrade";
}

访问控制：
- 通过.htpasswd添加基础认证
- 或在绿联防火墙限制访问IP段

4. 常见问题排查

4.1 容器启动失败

典型错误及解决方案：

现象	可能原因	解决方法
端口冲突	3000端口被占用	修改映射端口为`-p 3001:3000`
权限拒绝	/app/data不可写	执行`chmod 777 /mnt/nas/games/pokerogue`
镜像拉取失败	GHCR限速	改用阿里云镜像源

4.2 游戏运行异常

高频问题处理：

存档丢失：检查volume挂载路径是否正确
对战卡顿：降低画面质量（修改/app/data/config.json）
无法多开：需要为每个实例分配不同端口和数据目录

5. 扩展玩法建议

MOD安装：
将mod文件放入挂载目录的/app/data/mods文件夹，游戏会自动加载。推荐几个热门mod：
- 全世代宝可梦扩展包
- 暗黑地牢风格皮肤
- 双倍经验补丁

数据备份方案：

bash复制# 每日增量备份
rsync -avz /mnt/nas/games/pokerogue /mnt/nas/backups/games/

家庭服务器联动：
通过绿联的DLNA功能，将游戏画面投屏到电视，手机作为控制器使用。

实际部署后发现，UGOS系统的cgroup v2实现有时会导致容器资源限制失效。临时解决方案是在/etc/docker/daemon.json中添加：

json复制{
  "exec-opts": ["native.cgroupdriver=cgroupfs"]
}

这个配置需要SSH到NAS后台修改，修改后记得重启Docker服务。建议在非高峰时段操作，避免影响其他容器运行。