

# 前言

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是否正常运行：
```bash
root@wangge:~# docker version
Client:
 Version:           27.5.1
 API version:       1.47
 Go version:        go1.22.2
 Git commit:        27.5.1-0ubuntu3~22.04.2
 Built:             Mon Jun  2 12:18:38 2025
 OS/Arch:           linux/amd64
 Context:           default

Server:
 Engine:
  Version:          27.5.1
  API version:      1.47 (minimum version 1.24)
  Go version:       go1.22.2
  Git commit:       27.5.1-0ubuntu3~22.04.2
  Built:            Mon Jun  2 12:18:38 2025
  OS/Arch:          linux/amd64
  Experimental:     false
 containerd:
  Version:          1.7.24
  GitCommit:
 runc:
  Version:          1.1.12-0ubuntu2~22.04.1
  GitCommit:
 docker-init:
  Version:          0.19.0
  GitCommit:
```

# 3. 安装Portainer

## 3.1 Docker快速安装

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

**创建数据卷**（实现数据持久化）：
```bash
docker volume create portainer_data
```
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11991284/d52ba59f19e293966dd9239b1e8c4360.png)

**运行Portainer容器**：
```bash
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
```

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11991284/75d7d8bfe4ac850dce810c8caf7d4808.png)





参数说明：
- `-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`文件：
```yaml
version: '3.1'
services:
  portainer:
    image: portainer/portainer-ce:latest
    container_name: portainer
    ports:
      - "9000:9000"
      - "8000:8000"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./data:/data
      - ./public:/public
    restart: always
```

启动服务：
```bash
docker-compose up -d
```

## 3.3  二进制安装

除了容器化部署，Portainer还支持二进制安装：
```bash
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`

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11991284/27e34f1683c1d11b6a373c5af2744745.png)


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

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11991284/28f01f6a1f3de83d9e91e42a4d7d3368.png)





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

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11991284/bed099fe7a9ffcc2e448e5c65934935f.png)

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11991284/28b54cbc809ce225ab91fc6c00c91abd.png)











## 4.2  仪表盘

登录后的首页展示了Docker环境的整体状态：
- 运行中的容器/停止的容器数量
- 镜像、网络、数据卷数量
- 资源使用情况（CPU、内存、存储）

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11991284/f8a5bf65950d00a1e8ae499badbf62c1.png)


## 4.3 容器管理

在"Containers"页面可以：
- 查看所有容器列表及状态
- 启动、停止、重启、删除容器
- 进入容器控制台执行命令
- 查看容器日志
- 监控容器资源使用情况

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11991284/b8589bf0b15b754006e6b3d851f7e69a.png)


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

## 4.4 镜像管理

在"Images"页面可以：
- 查看本地镜像列表
- 从Registry拉取镜像
- 推送镜像到Registry
- 删除镜像
- 构建新镜像
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11991284/ab12bcfe82758c3c9d045f5a48c9008e.png)


**拉取镜像示例**：
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"
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11991284/2b7e2cba29d09e3c64614bf9c8c43278.png)

# 5.汉化部署方法
## 5.1 删除容器

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

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

## 5.2 创建挂载目录


- 重新创建挂载目录

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

## 5.3 下载汉化包

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

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

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11991284/0759b3d8124741034227388068c20aef.png)


```bash
root@wangge:/docker/portainer/public# pwd
/docker/portainer/public
root@wangge:/docker/portainer/public# ls
public-public.tar.gz
```
## 5.4 解压汉化包

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

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11991284/979aaee853183e1e8490e5703bbed3a9.png)


## 5.5 创建容器

```bash
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
```
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11991284/3acb8a2fd62904b22fdc04ca9ac73293.png)
## 5.6 访问效果

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


![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11991284/7df87c5ac6bd9ce57fef66c2470d3492.png)
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11991284/0a0d5cdaf343089eb92a681ce84c5686.png)


# 总结

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

---

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

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

开发工具

云计算

运维

Portainer是一款轻量级Docker可视化管理系统，支持容器、镜像、网络等资源管理。本文详细介绍Portainer安装配置方法，包括Docker单机部署、Compose安装及汉化教程，帮助用户快速搭建高效容器管理平台，提升Docker运维效率。

容器

Docker

Agent

AI驱动 智领未来

文章

问答

视频

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Portainer实战：轻松搭建Docker可视化管理系统-腾讯云开发者社区-腾讯云

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

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

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐