Portainer是Docker的轻量级管理UI,它简化了管理Docker容器的过程。它提供了一个直观的Web界面,用于部署,配置和监视容器。本指南可引导您在Raspberry Pi上安装和设置Portainer,使您可以轻松管理Docker容器。
你需要什么
- 覆盆子pi (任何具有Docker支持的模型,例如PI 3,PI 4)
- 覆盆子Pi OS 安装在覆盆子Pi上
- 互联网连接 用于下载Portainer
- Docker 安装在覆盆子Pi上(Portainer需要Docker运行)
步骤1:在Raspberry Pi上安装Docker
如果您的Raspberry Pi尚未安装Docker,请按照以下步骤安装:
-
更新软件包列表:
sudo apt update sudo apt upgrade -y
-
使用官方脚本安装Docker:
curl -sSL https://get.docker.com | sh
-
安装后,将当前用户添加到Docker组,以允许在没有的docker命令中
sudo
:sudo usermod -aG docker ${USER}
-
重新启动覆盆子Pi以应用更改:
sudo reboot
-
验证正确安装的Docker:
docker --version
步骤2:安装Portainer
现在安装了Docker,您可以将Portainer安装为Docker容器。
-
从Docker Hub中拉出Portainer图像:
docker pull portainer/portainer-ce
-
创建并运行Portainer容器:
docker volume create portainer_data docker run -d -p 9000:9000 -p 9443:9443 --name portainer --restart always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce
这是命令所做的:
-
-d
:以独立模式运行容器。 -
-p 9000:9000
:在端口9000上公开Web UI。 -
-p 9443:9443
:在端口9443上使用HTTPS公开Web UI。 -
--name portainer
:将容器名称设置为“ Portainer”。 -
--restart always
:自动在引导上重新启动Portainer或容器崩溃。 -
-v /var/run/docker.sock:/var/run/docker.sock
:绑定用于管理Docker容器的安装码头套接字。 -
-v portainer_data:/data
:安装一个卷以持续portainer数据。
-
-
等待Portainer启动,然后打开您的网络浏览器,然后转到:
http://<raspberry_pi_ip>:9000
代替
<raspberry_pi_ip>
带有Raspberry Pi的IP地址。
步骤3:设置Portainer
当您首次访问Portainer Web界面时,会提示您创建一个管理员帐户。
-
创建管理员帐户:
- 为管理帐户设置用户名和密码。
- 单击“创建用户”进行。
-
连接到Docker:
- 选择 当地的 在Raspberry Pi上管理当地的Docker环境。
- 点击 连接.
步骤4:使用Portainer
连接后,您将被带到Portainer仪表板,您可以在那里开始管理Docker容器。你可以:
- 查看运行容器:监视所有活动容器的状态。
- 部署新容器:从Portainer接口创建新的Docker容器。
- 管理卷和网络:查看和配置Docker量和网络。
- 查看日志和统计:监视运行容器的日志和统计数据。
步骤5:管理Portainer
-
远程访问Portainer:
- 要远程安全访问Portainer,您可以使用反向代理(例如Nginx或Traefik)配置SSL,或将端口9443用于HTTPS(由
docker run
上面的命令)。
- 要远程安全访问Portainer,您可以使用反向代理(例如Nginx或Traefik)配置SSL,或将端口9443用于HTTPS(由
-
停止并重新启动Portainer:要停止Portainer,请运行:
docker stop portainer
要重新启动Portainer,请运行:
docker restart portainer
-
删除Portainer:如果要删除Portainer,请停止并卸下容器:
docker stop portainer docker rm portainer
可选,您还可以删除Docker卷:
docker volume rm portainer_data
故障排除
- Portainer无法访问:确保您的Raspberry Pi的防火墙允许访问端口9000和9443。如果使用HTTPS,请验证是否正确设置了SSL证书。
-
Docker容器崩溃:检查容器日志是否有错误:
docker logs portainer
-
没有Docker访问:确保您的用户是Docker组的一部分:
sudo usermod -aG docker ${USER} sudo reboot
结论
Portainer通过提供易于使用的Web界面来简化Raspberry Pi上的Docker容器管理。只需几个命令,您就可以使用Docker和Portainer启动并运行,从而更容易管理和监视您的容器。无论您是运行家庭自动化系统,Web服务器还是其他Dockerized服务,Portainer都是管理Raspberry Pi的Docker环境的宝贵工具。