需安装Portainer作为轻量级Web管理工具，支持在线拉取镜像运行或离线加载镜像包两种方式，适配银河麒麟V10 SP1/SP2/SP3的x86_64与aarch64架构。
如果您已在银河麒麟系统上成功部署Docker，但缺乏图形化管理界面，无法便捷地查看容器、镜像、卷及网络等资源，则需安装Portainer作为轻量级Web管理工具。以下是适用于银河麒麟V10（含SP1/SP2/SP3、x86_64与aarch64双架构）的多种可靠安装方式：
一、在线拉取镜像并运行Portainer容器（适用于网络通畅环境）
该方法直接利用Docker Hub拉取官方Portainer CE镜像，启动标准化容器实例，依赖已就绪的Docker守护进程和本地socket通信，部署最快、步骤最简。
1、确认Docker服务已运行且权限正常：sudo systemctl status docker 输出应为active (running)，且当前用户已加入docker组。
2、拉取适配架构的Portainer CE镜像：sudo docker pull portainer/portainer-ce:linux-amd64-2.20.2-alpine（x86_64平台）或sudo docker pull portainer/portainer-ce:linux-arm64-2.20.2-alpine（ARM64平台）。
3、创建专用数据卷以持久化配置：sudo docker volume create portainer_data。
4、运行Portainer容器并绑定关键路径与端口：sudo docker run -d -p 9000:9000 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:linux-amd64-2.20.2-alpine。
5、开放系统防火墙端口：sudo firewall-cmd --permanent --add-port=9000/tcp && sudo firewall-cmd --reload。
二、离线加载Portainer镜像包（适用于涉密网、物理隔离或无外网环境）
该方案规避网络依赖，通过预下载并校验的镜像压缩包完成部署，要求提前在联网机器完成镜像获取与打包，并确保目标麒麟系统架构与镜像标签严格匹配。
1、在联网主机执行镜像拉取与保存：docker pull portainer/portainer-ce:linux-arm64-2.20.2-alpine && docker save portainer/portainer-ce:linux-arm64-2.20.2-alpine > portainer-ce-arm64-2.20.2.tar。
2、将生成的portainer-ce-arm64-2.20.2.tar文件拷贝至麒麟目标机指定目录（如/opt/images/）。
3、在目标机执行离线加载：sudo docker load ；验证结果：sudo docker images | grep portainer 应显示对应镜像ID与标签。
4、创建数据卷并运行容器（命令同第一种方法第3、4步，仅替换镜像名为本地已加载名称）。
三、使用Docker Compose编排部署（适用于需统一管理多组件或复用配置场景）
该方式通过docker-compose.yml声明式定义Portainer服务，支持版本控制、环境变量注入与启动策略管理，便于批量部署与配置复用。
1、确保系统已安装docker-compose（若未安装：sudo yum install -y docker-compose 或 sudo apt install -y docker-compose）。
2、创建部署目录并进入：mkdir -p /opt/portainer && cd /opt/portainer。
3、创建docker-compose.yml文件：sudo tee docker-compose.yml
version: '3.8'
services:
portainer:
image: portainer/portainer-ce:linux-amd64-2.20.2-alpine
container_name: portainer
restart: always
ports:
- "9000:9000"
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- portainer_data:/data
volumes:
portainer_data:
EOF
4、执行编排部署：sudo docker-compose up -d。
5、检查容器状态：sudo docker-compose ps，输出应显示portainer状态为Up。
