Linux安装Portainer管理Docker教程

本文手把手教你如何在Linux系统中快速部署轻量级开源工具Portainer，仅需六步——从确保Docker服务正常运行、拉取官方镜像、创建持久化数据卷，到运行容器并映射端口与挂载关键文件，再到浏览器初始化管理员账户并验证Docker引擎连接状态——即可获得一个直观、安全、无需复杂配置的图形化Docker管理界面，大幅提升容器运维效率，特别适合初学者和中小型项目团队轻松上手。

如果您希望在Linux系统中通过图形化界面管理Docker容器，Portainer是一个轻量、开源且无需复杂配置的可视化工具。以下是完成Portainer部署与访问的完整操作流程：

一、确认Docker服务已运行并启用

Portainer依赖于Docker守护进程提供API接口，因此必须确保Docker已正确安装且处于活动状态。若Docker未运行，Portainer将无法连接本地引擎。

1、执行命令检查Docker服务状态：sudo systemctl status docker

2、如显示inactive，启动服务：sudo systemctl start docker

3、设置开机自启：sudo systemctl enable docker

二、拉取Portainer Server镜像

Portainer以容器方式运行，需先从Docker Hub获取官方镜像。使用默认latest标签可获得稳定版本，避免指定过时或测试分支。

1、执行拉取命令：docker pull portainer/portainer-ce:latest

2、验证镜像是否成功下载：docker images | grep portainer

三、创建持久化数据卷

Portainer需保存用户配置、端点信息及权限策略，使用命名卷可确保容器重启后数据不丢失，避免每次重装都需重新配置。

1、创建专用卷：docker volume create portainer_data

2、确认卷已存在：docker volume ls | grep portainer_data

四、运行Portainer容器（绑定宿主机端口）

通过映射宿主机的9000端口至容器内部，使Web界面可通过浏览器直接访问。同时挂载Docker套接字和数据卷，赋予Portainer管理权限与状态持久能力。

1、执行运行命令：docker run -d -p 9000:9000 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest

2、检查容器运行状态：docker ps | grep portainer

五、初始化管理员账户并登录

首次访问时，Portainer强制要求创建管理员用户，该账户拥有对所有连接端点的完全控制权，密码强度需满足至少小写字母、大写字母、数字、特殊字符中的三项。

1、在浏览器中打开地址：http://localhost:9000（若为远程服务器，替换localhost为服务器IP）

2、在注册表单中输入用户名与强密码，点击Create user

3、选择Local端点类型，点击Connect完成接入

六、验证Docker引擎连接状态

登录后首页会显示当前连接的Docker环境信息。若出现“Endpoint unreachable”提示，说明容器未能正确挂载Docker套接字或Docker服务异常。

1、进入左侧菜单Endpoints，查看状态列是否显示Up

2、若状态为Down，重新检查步骤四中-v参数是否包含/var/run/docker.sock路径

3、确认宿主机Docker套接字文件存在且可读：ls -l /var/run/docker.sock

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Linux安装Portainer管理Docker教程》文章吧，也可关注golang学习网公众号了解相关技术文章。