告别黑乎乎的命令行！用 Portainer 给你的 Docker 装上一个酷炫的“仪表盘”

原创于 2025-11-01 14:54:17 发布 · 914 阅读

18 ·

CC 4.0 BY-SA版权

文章标签：

#docker #容器 #运维 #portainer

docker 专栏收录该内容

41 篇文章

订阅专栏

👋 告别黑乎乎的命令行！用 Portainer 给你的 Docker 装上一个酷炫的“仪表盘”

嘿，各位 Docker 玩家和 DevOps (Development and Operations, 开发运维一体化) 工程师们！🚀

你是否也曾被 docker ps 那一大长串的输出搞得眼花缭乱？或者为了查看某个微服务的日志，不得不在多个终端窗口间反复横跳，敲着 docker logs -f [容器名]？

虽然命令行很酷，但在管理数十个容器时，它的效率确实有点“感人”。😅

今天，我要向你安利一款神器——Portainer！它是一个轻量、强大且开源的 Docker 图形化管理界面。把它装上，就等于给你的 Docker 引擎配上了一个直观、酷炫的“驾驶舱仪表盘”！

🤔 Portainer 是什么？为什么你需要它？

简单来说，Portainer 就是一个 Web UI (Web User Interface, 网页用户界面)，让你可以在浏览器里完成几乎所有的 Docker 操作。

告别这些烦恼：

😵 忘记了某个容器的全名或 ID (Identifier, 标识符)？
🤯 想快速看看哪个容器占用了最多的 CPU (Central Processing Unit, 中央处理器) 或内存？
😫 在长长的日志里用肉眼搜索错误信息？
😥 需要进入容器内部执行一个命令，但忘了 docker exec -it ... 的完整语法？

拥抱这些便利：

仪表盘概览 📊：一登录就能看到所有容器、镜像、网络、数据卷的健康状态。
一键式操作🖱️：通过点击按钮，轻松实现容器的 启动、停止、重启、删除。
实时资源监控📈：直观的图表展示每个容器的 CPU 和内存使用情况。
强大的日志浏览器 📄：内置日志查看器，支持自动刷新、搜索、筛选，甚至可以下载日志文件。
Web 终端 💻：一键打开任何容器的 sh 或 bash 终端，就像在用一个网页版的 SSH (Secure Shell, 安全外壳协议) 工具。
轻松管理 🗄️：无论是清理不再使用的镜像（dangling images），还是创建新的 Docker 网络，都变得轻而易举。

听起来是不是很棒？最棒的是，安装它只需要两条命令！

🚀 两步安装 Portainer，只需 30 秒！

下面，我们就在你的 Linux 服务器上，通过 Docker 来安装 Portainer。（用 Docker 管理 Docker，这很“套娃”，也很酷！😎）

第 1 步：创建 Portainer 的数据卷

我们需要为 Portainer 创建一个持久化的数据卷，用来存放它的配置信息（比如你创建的用户名、密码等）。这样，即使 Portainer 容器被删除或更新，你的配置也不会丢失。

docker volume create portainer_data

终端会返回 portainer_data，表示数据卷创建成功！

第 2 步：运行 Portainer 容器

现在，执行下面这条 docker run 命令，一键启动 Portainer！

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

让我们来解读一下这条“咒语”：

-d: 在后台（detached 模式）运行容器。
-p 9443:9443: 将服务器的 9443 端口映射到容器的 9443 端口。我们将通过这个端口访问 Portainer 的 HTTPS (Hypertext Transfer Protocol Secure, 安全超文本传输协议) 安全界面。
--name portainer: 给这个容器取个名字，方便管理。
--restart=always: 确保无论 Docker 重启还是服务器重启，Portainer 容器都会自动启动。
-v /var/run/docker.sock:/var/run/docker.sock: 这是最关键的一步！ 它将主机（你的服务器）的 Docker Unix 套接字文件挂载到容器内部。Portainer 就是通过这个文件来与主机 Docker 引擎通信，从而实现对所有容器的管理。
-v portainer_data:/data: 将我们第一步创建的数据卷挂载到容器的 /data 目录，用于持久化存储配置。
portainer/portainer-ce:latest: 指定要使用的 Portainer 社区版（Community Edition）的最新镜像。

当你执行这条命令后，你会看到 Docker 开始拉取 Portainer 镜像，就像这样：

Unable to find image 'portainer/portainer-ce:latest' locally
latest: Pulling from portainer/portainer-ce
22d4f45bf667: Pull complete
...
Status: Downloaded newer image for portainer/portainer-ce:latest
46587c4b36cb1947bc8d2d2957b238edd2c7ec01764081586302a3d70e662f61

看到最后那串长长的容器 ID，就表示 Portainer 已经成功在你的服务器上运行起来了！

🛠️ 首次访问与配置

开放防火墙 (如果需要)
确保你的服务器防火墙允许外部访问 9443 端口。
```
# 以 Ubuntu 的 ufw 为例
sudo ufw allow 9443/tcp
```
访问 Web 界面
在你的浏览器中，输入 https://[你的服务器IP]:9443。例如：https://192.168.31.73:9443。
- 注意：是 https:// 而不是 http://。
- 浏览器可能会警告“连接不是私密的”，因为 Portainer 使用的是自签名证书。不用担心，直接点击“高级” -> “继续前往”即可。
创建管理员账户
首次访问，Portainer 会要求你设置一个管理员 admin 的密码。请设置一个强密码并妥善保管。
连接到 Docker 环境
登录后，Portainer 会让你选择要管理的环境。选择 Docker，然后点击“Connect”。

完成！ 🎉 你现在应该能看到一个漂亮的仪表盘，上面列出了你服务器上所有正在运行的容器（包括你刚刚部署的 hx-gateway-app, mysql-service 等）。

现在，去尽情探索吧！点击任何一个容器，查看它的日志，监控它的资源使用，或者直接打开一个 Web 终端。你会发现，管理 Docker 从未如此简单和直观！

结语

对于个人开发者、小型团队，或者任何想要从繁琐的命令行中解放出来的人来说，Portainer 都是一个“必备神器”。它极大地降低了 Docker 的管理门槛，让你能更专注于你的应用本身。

如果你还在用黑乎乎的终端管理着一堆容器，别犹豫了，花 30 秒给自己装上这个酷炫的“仪表盘”吧！相信我，你会爱上它的！❤️

附录：总结与图表

📊 Portainer 安装与使用总结

步骤	命令 / 操作	目的	效果
1. 创建数据卷	`docker volume create portainer_data`	持久化存储 Portainer 的配置	⚙️ 配置不丢失
2. 运行容器	`docker run -d -p 9443:9443 ...`	启动 Portainer 服务	🚀 服务运行
3. 开放防火墙	`sudo ufw allow 9443/tcp`	允许外部网络访问	🌐 公网可达
4. 浏览器访问	`https://[服务器IP]:9443`	打开 Web UI 界面	🖥️ 看到界面
5. 初始化设置	创建管理员账户，连接本地 Docker	完成首次配置	✅ 开始使用

🗺️ Mermaid 流程图：Portainer 安装流程

🔄 Mermaid 时序图：Portainer 如何管理 Docker

🚦 Mermaid 状态图：一个容器在 Portainer 中的生命周期

🏛️ Mermaid 类图：Portainer 与 Docker 的关系

🔗 Mermaid 实体关系图：Portainer 的核心挂载

🧠 Markdown 思维导图

使用 Portainer 可视化管理 Docker
- 痛点 (Why?)
  - 命令行操作繁琐、易出错
  - 容器状态、资源监控不直观
  - 日志查看和搜索困难
- Portainer 是什么?
  - 一个轻量级的 Docker 图形化管理界面 (Web UI)
  - 核心功能
    - 📊 仪表盘
    - 🖱️ 一键操作 (启停、删除)
    - 📈 实时监控 (CPU, 内存)
    - 📄 强大的日志浏览器
    - 💻 Web 终端
- 如何安装 (How?)
  - 前提：服务器已安装 Docker
  - 第一步：创建数据卷
    - 命令: docker volume create portainer_data
    - 目的: 持久化存储配置
  - 第二步：运行容器
    - 命令: docker run -d -p 9443:9443 ...
    - 关键配置: -v /var/run/docker.sock:/var/run/docker.sock
      - 作用：让 Portainer 容器能与主机的 Docker 引擎通信
- 如何使用 (What?)
  - 1. 开放防火墙
    - sudo ufw allow 9443/tcp
  - 2. 浏览器访问
    - https://[你的服务器IP]:9443
  - 3. 初始化
    - 创建管理员账户
    - 连接到本地 Docker 环境
- 结论
  - Portainer 是从命令行到图形化管理的最佳入门工具
  - 安装简单，功能强大，极大提升 Docker 管理效率 🚀