如何轻松管控树莓派上多个Docker容器？

如果你用树莓派运行多个 Docker 容器，手动管理很快就会变得繁杂。Portainer 正是为此而生！它提供可视化网页管理面板，帮你统筹、操控所有容器，大幅简化操作流程。

Portainer 本身就能以 Docker 容器的形式安装在树莓派上。部署完成后，直接打开网页端，就能管理设备内全部 Docker 容器。

如果你刚接触树莓派，这些操作看起来可能偏技术向。别担心，我会带你走完完整流程。读完本文，你就能借助 Portainer 在树莓派上部署第一个 Docker 容器！

Portainer 是什么？为什么要使用它？

Docker 容器可以跨系统运行、测试程序，不用繁琐处理各类依赖（程序运行所需配套软件）。但如果你和我一样不喜欢命令行，在树莓派上操作 Docker 会十分吃力。

Portainer 完美解决这个痛点：简洁美观的可视化界面，一站式管理树莓派上所有 Docker 容器，功能包含实时容器日志查看、容器终端直连等，功能十分全面。

这款工具最大的优势：自身是轻量 Docker 容器，直接部署即可，无需额外处理依赖。了解完 Portainer 的作用，我们先来梳理搭建所需设备。

所需硬件（清单很短）：

树莓派：必备设备。推荐树莓派 5（内存至少 2GB，本文使用该机型）；树莓派 3 及以上型号均可正常使用。

带 SD 卡读卡器的电脑（也可以用预装镜像烧录工具的树莓派） 若无读卡器，可选购平价 USB 读卡器（亚马逊有售同款）。

有线 / 无线网络：教程默认你的树莓派通过网线或 Wi-Fi 接入家庭局域网。

微型 SD 卡：用于刷入最新版树莓派官方系统。 这里有一份兼顾性能的 SD 卡选购推荐，普通型号也能正常运行。

树莓派镜像烧录工具 Raspberry Pi Imager：用来将官方系统镜像写入 SD 卡。

只要你的树莓派装好最新系统，且能通过终端 / 显示器操作（强烈推荐树莓派远程连接工具），就可以跟着教程操作了！

在树莓派安装 Portainer

第一步先在树莓派部署 Portainer。前文提到 Portainer 是 Docker 容器，因此需要先给树莓派装好 Docker，再以容器形式启动 Portainer。

步骤 1：树莓派安装 Docker

树莓派部署 Docker 流程十分简单，我之前专门写过完整安装教程。如果尚未安装 Docker，先阅读该文完成部署，再回到本篇继续操作。

https://raspberrytips.com/docker-on-raspberry-pi/

Docker安装配置完成后，就能在终端执行 Docker 相关命令了。

Docker 部署完毕，接下来安装并启动 Portainer。

步骤 2：配置 Portainer

Portainer 本身以 Docker 容器运行，本小节我们使用 Docker Compose 语法编写 Portainer 配置文件，写法清晰，后续修改维护更方便。

编写 Portainer 容器配置：

新建文件夹存放 Portainer 项目（推荐放在用户根目录）

mkdir portainer

进入文件夹，新建 compose.yaml 配置文件

cd portainernano compose.yaml

将以下配置粘贴进文件（缩进格式至关重要，不能错乱）

services:  portainer:    container_name: portainer    image: portainer/portainer-ce:sts    restart: always    volumes:      - /var/run/docker.sock:/var/run/docker.sock      - portainer_data:/data    ports:      - 9443:9443      - 8000:8000  # Remove if you do not intend to use Edge Agentsvolumes:  portainer_data:    name: portainer_datanetworks:  default:    name: portainer_network

保存并退出编辑器：快捷键 Ctrl+X

这份配置看着复杂，我逐条拆解说明：

image: portainer/portainer-ce:sts：自动拉取 Portainer 官方镜像

restart: always：程序异常退出后自动重启

portainer_data:/data：数据卷映射，持久化保存 Portainer 配置数据

9443:9443：端口映射，局域网通过 9443 端口访问 Portainer 管理面板

8000:8000：远程边缘节点接入专用端口。仅内网使用建议删除，简化配置。

想深入了解配置语法，可以阅读我们的 Docker 配置详解文章。

https://raspberrytips.com/docker-mistakes-raspberry-pi/

Portainer 配置文件编写完成，接下来启动容器。

步骤 3：启动 Portainer

仅需一条命令即可运行 Portainer：

docker compose up

这条命令会读取 compose.yaml 内的配置，自动下载镜像并启动 Portainer 容器。

重要操作：复制屏幕输出的 setup-token 备用 示例密钥：8403586527aa728239ce40355562f5bd58fe9a440d15df0c…

说明：setup-token 是安全临时验证密钥，若长时间未登录网页端会自动失效；密钥过期只需重启容器即可重新生成。

全部部署就绪后，按下快捷键 D 让容器后台运行。下面讲解如何登录网页面板完成初始化。

登录 Portainer 网页管理界面

Portainer 容器启动后，局域网内所有设备都能通过 9443 端口访问管理面板，两种登录方式：树莓派本机localhost访问，或局域网其他设备输入树莓派 IP 访问。

打开浏览器，输入地址（必须手动加上 https）

https://<RaspberryIP>:9443

页面会弹出隐私安全警告，属于正常现象，点击「高级」→「继续访问」即可。

若出现连接超时报错，返回步骤 3 操作：

按下 Ctrl+C 停止容器，重新执行docker compose up启动，复制新生成的临时密钥（每次重启密钥都会变化）。

顺利访问会进入欢迎初始化页面

设置管理员密码并妥善保存，粘贴刚才复制的 setup-token，点击「创建管理员账号」

弹出环境选择向导，直接点击「开始使用」默认本地 Docker 环境即可

（添加多环境可实现 K8s 集群等复杂运维场景）

跳转首页，页面会展示当前树莓派所有 Docker 容器概览

至此 Portainer 初始化全部完成，下面演示用可视化面板部署容器。

Portainer 实操：部署第一个容器

全部环境就绪，我们通过网页面板部署测试容器：

点击首页本地环境卡片进入管理页面

切换至「容器」标签页

首次进入列表只会显示 Portainer 自身容器，点击「+ 添加容器」新建实例

部署 hello-world 测试容器

填写自定义容器名称，镜像一栏输入hello-world，点击「部署容器」

部署耗时数秒。该容器运行一次后自动停止，状态显示已退出 - 代码0，0 代表运行成功

查看容器日志：点击容器名称进入详情页，选择「日志」按钮

日志内会输出程序欢迎文字，代表容器部署完全成功！

延伸阅读推荐

终极家庭服务器搭建方案：在树莓派上运行 50 多个 Docker 容器！

七个会拖垮树莓派的 Docker 使用误区!

恭喜！你已经通过 Portainer 可视化面板完成首个容器部署。借此熟悉操作界面，就能体会这款工具的强大能力，而这仅仅是基础用法。建议查阅 Portainer官方文档深入学习更多高级功能。

https://docs.portainer.io/