Panther-X2部署Portainer并实现完美汉化 | 附Nginx反代配置和汉化补丁

封面图片来源：portainer

1. 简介#

先跟大家聊聊 Portainer —— 一款轻量级的Docker可视化管理工具，用Web界面就能搞定容器、镜像、网络的全生命周期管理，不用再死记硬背docker命令。

咱用Panther-X2小主机跑Docker服务时，纯命令行操作又麻烦又容易出错，尤其是管理多容器的时候，找个日志都得翻半天😤。

所以这篇教程，专门针对Panther-X2 Armbian环境，从部署Portainer、打汉化补丁，到配置Nginx反代，一步到位，最终实现全中文界面+友好端口访问+安全加密，小白也能轻松上手！

2. 环境准备#

先明确环境要求，我亲测Panther-X2完全适配，大家对号入座：

硬件设备：Rockchip RK3566 Panther-X2 小主机（ARM64架构，性能足够跑Portainer）
系统环境：Armbian 24.x / Linux 6.x 内核 / Debian trixie（rolling版实测无问题）
依赖条件：
- Docker已安装（版本≥20.10，Panther-X2安装教程可参考我之前的文章）
- Docker Compose（可选，方便管理Portainer容器）
- Nginx（用于反代，提前安装：apt install nginx -y）
坑点提醒：
- Portainer默认端口9000容易冲突，建议自定义端口
- 反代时必须开启WebSocket支持，否则界面操作卡顿
- 防火墙/路由器需放行反代端口（避开80/443，用非标端口如8888）

3. 一步步部署+汉化+反代#

核心步骤来了，全程命令可直接复制，重点标注关键操作，确保一次成功！

步骤1：拉取Portainer镜像并启动容器#

先创建Portainer数据目录，避免容器重启数据丢失，然后启动容器（自定义端口9001避免冲突）：

1
# 创建数据目录
2
mkdir -p /opt/portainer/data
3
# 拉取官方最新版镜像（ARM64架构适配）
4
docker pull portainer/portainer-ce:latest
5
# 启动容器（重点：映射9001端口，挂载Docker套接字和数据目录）
6
docker run -d \
7
  --name portainer \
8
  --restart=always \
9
  -p 9001:9000 \
10
  -v /var/run/docker.sock:/var/run/docker.sock \
11
  -v /opt/portainer/data:/data \
12
  portainer/portainer-ce:latest

验证启动是否成功：

1
# 查看容器状态
2
docker ps | grep portainer
3
# 访问测试（替换为Panther-X2内网IP）
4
curl http://192.168.1.x:9001

如果返回<!DOCTYPE html>开头的内容，说明容器启动正常。

步骤2：安装Portainer汉化补丁#

Portainer官方无中文版，需通过替换前端文件实现汉化，步骤如下：

1
# 进入Portainer容器
2
docker exec -it portainer /bin/sh
3
# 安装wget（容器内默认无）
4
apk add wget
5
# 备份原版前端文件
6
mv /usr/share/portainer/public /usr/share/portainer/public.bak
7
# 下载汉化版前端文件（适配最新版Portainer）
8
wget -O /tmp/portainer-cn.zip https://ghproxy.com/https://github.com/eysp/portainer-cn/releases/latest/download/portainer-cn.zip
9
# 解压到指定目录
10
unzip /tmp/portainer-cn.zip -d /usr/share/portainer/
11
# 退出容器
12
exit
13
# 重启Portainer生效
14
docker restart portainer

此时访问 http://Panther-X2内网IP:9001，就能看到全中文界面！首次登录需设置管理员密码，完成初始化。

步骤3：配置Nginx反代（优化访问体验）#

直接访问:9001端口不够友好，配置Nginx反代，实现「域名+非标端口」访问，同时开启HTTPS（可选）：

3.1 创建Nginx配置文件#

1
vim /etc/nginx/conf.d/portainer.conf

3.2 写入反代配置（关键：开启WebSocket）#

1
server {
2
    # 自定义反代端口（避开80/443，用8888）
3
    listen 8888;
4
    # 替换为你的DDNS域名（如portainer.example.com）
5
    server_name your-domain.com;
6

7
    # 反代核心配置
8
    location / {
9
        proxy_pass http://127.0.0.1:9001;
10
        proxy_set_header Host $host;
11
        proxy_set_header X-Real-IP $remote_addr;
12
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
13
        proxy_set_header X-Forwarded-Proto $scheme;
14

15
        # 必须开启WebSocket，否则界面操作卡顿
16
        proxy_http_version 1.1;
17
        proxy_set_header Upgrade $http_upgrade;
18
        proxy_set_header Connection "upgrade";
19
        proxy_read_timeout 86400;
20
    }
21
}

3.3 验证并重启Nginx#

1
# 检查配置语法
2
nginx -t
3
# 重启Nginx生效
4
systemctl restart nginx
5
# 设置开机自启
6
systemctl enable nginx

步骤4：最终验证#

访问 http://Panther-X2内网IP:8888（或域名+8888端口）
输入初始化设置的管理员密码
进入Portainer主界面，确认所有菜单、按钮均为中文
尝试创建/删除容器，验证功能正常无卡顿

4. 常见问题 & 排错#

整理我踩过的坑，遇到问题直接对号入座：

问题1：汉化后界面乱码/部分英文#

原因：汉化补丁版本与Portainer版本不匹配

解决：

1
# 查看Portainer版本
2
docker exec portainer portainer --version
3
# 下载对应版本的汉化补丁（替换版本号）
4
wget -O /tmp/portainer-cn.zip https://ghproxy.com/https://github.com/eysp/portainer-cn/releases/download/v2.20.0/portainer-cn.zip

问题2：反代后无法登录/操作卡顿#

原因：未开启WebSocket支持或Nginx配置错误

解决：检查Nginx配置中是否包含以下内容，缺一不可：

1
proxy_http_version 1.1;
2
proxy_set_header Upgrade $http_upgrade;
3
proxy_set_header Connection "upgrade";

问题3：端口被占用（9001/8888）#

解决：

1
# 查看端口占用进程
2
netstat -tulpn | grep 9001
3
# 替换端口重新启动（例如改为9002）
4
docker stop portainer && docker rm portainer
5
docker run -d --name portainer --restart=always -p 9002:9000 -v /var/run/docker.sock:/var/run/docker.sock -v /opt/portainer/data:/data portainer/portainer-ce:latest
6
# 同步修改Nginx配置中的proxy_pass为9002

问题4：外网无法访问#

排查步骤：
1. 检查Panther-X2防火墙：ufw allow 8888/tcp
2. 路由器端口转发：转发外网8888端口到Panther-X2内网IP的8888端口
3. 验证DDNS域名解析：nslookup your-domain.com（确保指向当前公网IP）

5. 总结#

这套流程下来，Panther-X2上的Portainer实现了三大核心目标：

全中文界面：告别英文菜单，新手也能轻松管理Docker
友好访问方式：通过Nginx反代，用域名+非标端口访问，避开运营商封锁
稳定可靠：容器化部署+开机自启，Panther-X2低负载运行（实测CPU占用≤5%）

最终效果：随时随地通过浏览器访问域名+8888端口，就能可视化管理Panther-X2上的所有Docker容器、镜像、网络，不用再敲繁琐的命令，真正做到「小白友好」！

如果你们在Panther-X2上部署Portainer遇到其他问题，欢迎评论区交流，一起避坑～