在Raspberry Pi上安装Portainer

 

Portainer是Docker的轻量级管理UI,它简化了管理Docker容器的过程。它提供了一个直观的Web界面,用于部署,配置和监视容器。本指南可引导您在Raspberry Pi上安装和设置Portainer,使您可以轻松管理Docker容器。


你需要什么

  1. 覆盆子pi (任何具有Docker支持的模型,例如PI 3,PI 4)
  2. 覆盆子Pi OS 安装在覆盆子Pi上
  3. 互联网连接 用于下载Portainer
  4. Docker 安装在覆盆子Pi上(Portainer需要Docker运行)

步骤1:在Raspberry Pi上安装Docker

如果您的Raspberry Pi尚未安装Docker,请按照以下步骤安装:

  1. 更新软件包列表:

    sudo apt update
    sudo apt upgrade -y
    
  2. 使用官方脚本安装Docker:

    curl -sSL https://get.docker.com | sh
    
  3. 安装后,将当前用户添加到Docker组,以允许在没有的docker命令中 sudo:

    sudo usermod -aG docker ${USER}
    
  4. 重新启动覆盆子Pi以应用更改:

    sudo reboot
    
  5. 验证正确安装的Docker:

    docker --version
    

步骤2:安装Portainer

现在安装了Docker,您可以将Portainer安装为Docker容器。

  1. 从Docker Hub中拉出Portainer图像:

    docker pull portainer/portainer-ce
    
  2. 创建并运行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数据。
  3. 等待Portainer启动,然后打开您的网络浏览器,然后转到:

    http://<raspberry_pi_ip>:9000
    

    代替 <raspberry_pi_ip> 带有Raspberry Pi的IP地址。


步骤3:设置Portainer

当您首次访问Portainer Web界面时,会提示您创建一个管理员帐户。

  1. 创建管理员帐户:

    • 为管理帐户设置用户名和密码。
    • 单击“创建用户”进行。
  2. 连接到Docker:

    • 选择 当地的 在Raspberry Pi上管理当地的Docker环境。
    • 点击 连接.

步骤4:使用Portainer

连接后,您将被带到Portainer仪表板,您可以在那里开始管理Docker容器。你可以:

  • 查看运行容器:监视所有活动容器的状态。
  • 部署新容器:从Portainer接口创建新的Docker容器。
  • 管理卷和网络:查看和配置Docker量和网络。
  • 查看日志和统计:监视运行容器的日志和统计数据。

步骤5:管理Portainer

  1. 远程访问Portainer:

    • 要远程安全访问Portainer,您可以使用反向代理(例如Nginx或Traefik)配置SSL,或将端口9443用于HTTPS(由 docker run 上面的命令)。
  2. 停止并重新启动Portainer:要停止Portainer,请运行:

    docker stop portainer
    

    要重新启动Portainer,请运行:

    docker restart portainer
    
  3. 删除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环境的宝贵工具。


发表评论

Notice an Issue? Have a Suggestion?
If you encounter a problem or have an idea for a new feature, let us know! Report a problem or request a feature here.