Portainer实战：轻松搭建Docker可视化管理系统

前言

Portainer作为一款轻量级、开源的Docker图形化管理工具，通过Web界面让容器管理变得简单高效，无需记忆复杂的Docker命令。本文将详细介绍如何安装和配置Portainer，并展示其核心功能。

1. Portainer简介

Portainer是一个轻量级的Docker环境管理UI，支持独立Docker主机和Docker Swarm集群两种模式。它提供了直观的图形界面，使开发者能够轻松管理容器、镜像、网络和数据卷等Docker资源。

核心特性：

• 状态显示面板，实时监控Docker环境状态
• 应用模板快速部署，支持自定义模板
• 完整的容器生命周期管理（创建、启动、停止、删除）
• 镜像管理（拉取、上传、构建）
• 网络和数据卷管理
• 用户管理和访问控制
• Swarm集群和服务管理

Portainer社区版（CE）完全免费，基于容器化安装方式，部署简单高效。

2. 安装准备

在安装Portainer之前，请确保：

• 已安装Docker环境（Docker CE或Docker Engine）
• 系统有足够的磁盘空间（至少1GB可用空间）
• 开放所需端口（9000为Web界面，8000为Edge Agent通信）

检查Docker是否正常运行：

root@wangge:~# docker version
Client:Version:           27.5.1API version:       1.47Go version:        go1.22.2Git commit:        27.5.1-0ubuntu3~22.04.2Built:             Mon Jun  2 12:18:38 2025OS/Arch:           linux/amd64Context:           defaultServer:Engine:Version:          27.5.1API version:      1.47 (minimum version 1.24)Go version:       go1.22.2Git commit:       27.5.1-0ubuntu3~22.04.2Built:            Mon Jun  2 12:18:38 2025OS/Arch:          linux/amd64Experimental:     falsecontainerd:Version:          1.7.24GitCommit:runc:Version:          1.1.12-0ubuntu2~22.04.1GitCommit:docker-init:Version:          0.19.0GitCommit:

3. 安装Portainer

3.1 Docker快速安装

单机版安装是最简单的方式，适合管理单个Docker主机。

创建数据卷（实现数据持久化）：

docker volume create portainer_data

运行Portainer容器：

docker run -d -p 9000:9000 -p 8000:8000 --name portainer --restart always \-v /var/run/docker.sock:/var/run/docker.sock \-v portainer_data:/data \portainer/portainer-ce:latest

参数说明：

• -d：后台运行容器
• -p 9000:9000：映射Web界面端口
• -p 8000:8000：映射Edge Agent通信端口（可选）
• --restart always：容器自动重启
• -v /var/run/docker.sock:/var/run/docker.sock：挂载Docker套接字
• -v portainer_data:/data：持久化存储Portainer数据

3.2 使用Docker Compose安装

对于更喜欢声明式配置的用户，可以使用Docker Compose安装。

创建docker-compose.yml文件：

version: '3.1'
services:portainer:image: portainer/portainer-ce:latestcontainer_name: portainerports:- "9000:9000"- "8000:8000"volumes:- /var/run/docker.sock:/var/run/docker.sock- ./data:/data- ./public:/publicrestart: always

启动服务：

docker-compose up -d

3.3 二进制安装

除了容器化部署，Portainer还支持二进制安装：

wget https://github.com/portainer/portainer/releases/download/1.19.2/portainer-1.19.2-linux-amd64.tar.gz
tar xvpfz portainer-1.19.2-linux-amd64.tar.gz
cd /opt/portainer
./portainer --template-file "${PWD}/templates.json"

4. 访问与初始配置

4.1 访问和初始化

1. 打开浏览器，访问 http://你的IP地址:9000

2. 首次登录需要创建管理员账户：
   • 用户名：admin
   • 设置密码（建议使用强密码）

3. 对于单机安装，选择"Local"并点击"Connect"即可连接到本地Docker。

4.2 仪表盘

登录后的首页展示了Docker环境的整体状态：

• 运行中的容器/停止的容器数量
• 镜像、网络、数据卷数量
• 资源使用情况（CPU、内存、存储）

4.3 容器管理

在"Containers"页面可以：

• 查看所有容器列表及状态
• 启动、停止、重启、删除容器
• 进入容器控制台执行命令
• 查看容器日志
• 监控容器资源使用情况

创建新容器：

1. 点击"Add container"
2. 配置容器参数：
   • 容器名称
   • 使用的镜像
   • 端口映射
   • 环境变量
   • 数据卷挂载
3. 点击"Deploy the container"启动

4.4 镜像管理

在"Images"页面可以：

• 查看本地镜像列表
• 从Registry拉取镜像
• 推送镜像到Registry
• 删除镜像
• 构建新镜像
  

拉取镜像示例：

1. 点击"Pull image"
2. 输入镜像名称（如：nginx:latest）
3. 点击"Pull the image"

4.5 堆栈管理

对于Docker Compose应用，可以使用"Stacks"功能部署：

1. 点击"Add stack"
2. 输入堆栈名称
3. 上传docker-compose.yml文件或直接粘贴内容
4. 点击"Deploy the stack"
   

5.汉化部署方法

5.1 删除容器

我们需要重新创建容器，之前创建portainer容器需要删除。

root@wangge:~# docker rm -f portainer
portainer

5.2 创建挂载目录

• 重新创建挂载目录

mkdir -p /docker/portainer/{data,public}

5.3 下载汉化包

登录Github，打开以下地址，下载public-public.tar.gz汉化包

下载地址：https://github.com/eysp/public/releases/tag/public

root@wangge:/docker/portainer/public# pwd
/docker/portainer/public
root@wangge:/docker/portainer/public# ls
public-public.tar.gz

5.4 解压汉化包

tar -zvxf public-public.tar.gz -C /docker/portainer/public --strip-components=1

5.5 创建容器

docker run -d --restart=always \
--name=portainer \
-p 9000:9000 \
-v /var/run/docker.sock:/var/run/docker.sock \
-v /docker/portainer/data:/data \
-v /docker/portainer/public:/public \
portainer/portainer-ce:2.9.1

5.6 访问效果

访问http://192.168.3.251:9000，可以看到正常汉化。

总结

通过本文的详细步骤，我们成功实现了Portainer的安装、配置与汉化，轻松搭建起Docker的可视化管理平台。Portainer不仅简化了容器、镜像、网络等资源的操作，还提升了管理效率与用户体验。汉化支持让中文用户更加得心应手，降低了使用门槛。未来可进一步探索其在多节点管理、权限控制等方面的高级功能，充分发挥其在生产环境中的价值。

---