银河麒麟系统安装Portainer 麒麟OS Docker容器管理

在银河麒麟V10系统上部署好Docker引擎后，很多朋友可能会觉得命令行操作不够直观。这时候，一个图形化的管理界面就显得尤为重要了。Portainer，作为一款轻量级的Web管理工具，正好能解决这个痛点，让你通过浏览器就能轻松管理容器、镜像、卷和网络等资源。

下面，我们就针对银河麒麟V10（包括SP1/SP2/SP3版本，以及x86_64和aarch64两种架构），介绍几种可靠且实用的安装方法。

一、在线拉取镜像并运行Portainer容器（适用于网络通畅环境）

如果你的服务器能顺畅访问外网，那么在线安装无疑是最快、最省事的方法。它直接利用Docker Hub拉取官方镜像，几步命令就能搞定。

首先，得确保Docker服务已经跑起来了，并且你的用户有操作权限。运行 sudo systemctl status docker 看看状态是不是“active (running)”，同时确认当前用户已经加入了docker用户组。

接下来，根据你的CPU架构拉取对应的镜像。对于x86_64平台，命令是：sudo docker pull portainer/portainer-ce:linux-amd64-2.20.2-alpine。如果是ARM64平台（比如飞腾处理器），则用：sudo docker pull portainer/portainer-ce:linux-arm64-2.20.2-alpine。

镜像拉取成功后，先创建一个数据卷，用来持久化保存Portainer的配置，避免容器重启后数据丢失：sudo docker volume create portainer_data。

最后，就是启动容器了。这条命令会映射9000端口，并挂载Docker的通信套接字和数据卷：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（注意镜像名要和你拉取的一致）。

别忘了，如果系统防火墙是开启的，需要放行9000端口：sudo firewall-cmd --permanent --add-port=9000/tcp && sudo firewall-cmd --reload。

二、离线加载Portainer镜像包（适用于涉密网、物理隔离或无外网环境）

对于内网、涉密环境或者无法连接互联网的服务器，离线部署是唯一的选择。这需要你提前在有网的机器上准备好镜像包。

操作也简单，先在联网的机器上拉取并保存镜像。例如，为ARM64架构准备：docker pull portainer/portainer-ce:linux-arm64-2.20.2-alpine && docker sa ve portainer/portainer-ce:linux-arm64-2.20.2-alpine > portainer-ce-arm64-2.20.2.tar。

然后，把这个生成的 portainer-ce-arm64-2.20.2.tar 文件拷贝到目标麒麟系统的某个目录下，比如 /opt/images/。

在目标机器上，加载这个镜像包：sudo docker load < /opt/images/portainer-ce-arm64-2.20.2.tar。加载完成后，用 sudo docker images | grep portainer 命令验证一下，应该能看到对应的镜像信息。

剩下的步骤就和在线安装一样了：创建数据卷，然后用刚刚加载到本地的镜像名来运行容器。

三、使用Docker Compose编排部署（适用于需统一管理多组件或复用配置场景）

如果你习惯使用Docker Compose，或者未来打算管理更多服务，用编排文件来部署Portainer会让管理更清晰，配置也更容易复用和版本控制。

首先确保系统已经安装了docker-compose工具。如果还没装，可以用yum或apt命令安装。

接着，创建一个专属目录，比如 mkdir -p /opt/portainer && cd /opt/portainer。

在这个目录下，创建 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:

文件保存后，一条命令即可启动：sudo docker-compose up -d。

最后，检查一下服务状态，运行 sudo docker-compose ps，如果看到portainer的状态是“Up”，那就大功告成了。

以上三种方法，基本覆盖了从在线到离线、从简单运行到编排管理的各种部署场景。你可以根据实际网络环境和运维习惯，选择最适合自己的那一种。部署完成后，打开浏览器访问 http://你的服务器IP:9000，就能看到Portainer的初始化界面了。