Linux怎么安装Portainer_Linux如何用Web面板管理Docker【教程】

夏芳姑娘_2953

夏芳姑娘_2953

2026-03-23

601人浏览

原创

不能。portainer是容器化应用,必须运行在docker环境中,需先安装并启动docker服务,再通过docker run命令部署,绑定端口、挂载数据卷并设置初始化密码后才可正常使用。

linux怎么安装portainer_linux如何用web面板管理docker【教程】

Portainer 能不能直接装在裸机 Linux 上

不能。Portainer 本身是容器化应用,必须运行在 Docker 环境里——它不是传统二进制程序,没有 ./portainer 这种直接执行方式。如果你还没装 Docker,先得配好 dockerddocker CLI,否则所有后续操作都会卡在 command not found: docker 或容器启动失败。

常见错误现象:docker: command not foundCannot connect to the Docker daemon。别急着拉镜像,先跑 systemctl status docker 确认服务在运行;非 root 用户记得加进 docker 用户组,否则会报权限拒绝。

  • Ubuntu/Debian:用 sudo apt install docker.io(注意不是 docker 包,那个是旧版 Docker CLI)
  • CentOS/RHEL:启用 docker-ce 仓库,避免用系统自带的过时 podman-docker 兼容层
  • 装完立刻验证:sudo docker run --rm hello-world,不报错才算真正就绪

用 docker run 启动 Portainer 的最小可行命令

官方推荐的单节点部署就是一条 docker run,但参数稍有差池就会导致 Web 打不开或数据丢失。核心是绑定宿主机端口、挂载数据卷、指定监听地址——漏掉任意一个,都可能表现为页面空白、502 错误或重启后配置清零。

最简且安全的命令长这样:

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

关键点说明:

  • -p 9000:9000:宿主机端口可改,但容器内固定是 9000,别写成 9000:8000
  • /var/run/docker.sock 必须绝对路径,挂载错位置(比如 /tmp/docker.sock)会导致 Portainer 看不见任何容器
  • portainer_data 是命名卷,比用 ./data 相对路径更可靠——后者在不同工作目录下行为不一致,且容易被误删
  • 镜像标签明确写 portainer-ce:latest,别用 portainer/portainer(已弃用,拉不到新版本)

访问不了 9000 端口?先查这三处

浏览器打不开 http://localhost:9000http://你的IP:9000,大概率不是 Portainer 自身问题,而是网络或权限链路断了。

  • 防火墙拦了:CentOS 用 sudo firewall-cmd --permanent --add-port=9000/tcp,Ubuntu 用 sudo ufw allow 9000
  • Docker 绑定的是 127.0.0.1:9000:默认没问题,但如果你加了 --host 参数或改过 daemon.json,可能只监听本地回环,外网访问就失败
  • SELinux 拦截(RHEL/CentOS):临时关掉测试 sudo setenforce 0,确认是它再用 sudo setsebool -P container_manage_cgroup on 开权限,别直接禁用 SELinux

顺手验证容器是否真在跑:docker ps | grep portainer,状态不是 Up 就得看日志:docker logs portainer。里面如果出现 failed to load data from database,基本是 /data 卷权限不对或损坏。

第一次登录后必须改 admin 密码

安装完成后浏览器打开,强制跳转到初始化页,要求设 admin 密码。这个密码不是“可选”,而是硬性门槛——没设就无法进入主界面,且 Portainer 不会提示“你忘了设”,只会卡在白屏或重定向循环。

容易被忽略的点:

  • 密码强度有最低要求:至少 8 位,含大小写字母+数字,纯数字或纯字母会提交失败,前端无明确提示
  • 用户名固定为 admin,不能改,别浪费时间找“新建用户”入口
  • 设完密码后,Portainer 会自动跳转,但如果浏览器缓存了旧重定向,可能还停在初始化页,试试硬刷 Ctrl+F5 或换隐身窗口
  • 密码丢了只能删容器重建:docker rm -f portainer && docker volume rm portainer_data,之前所有设置全丢

端口、权限、初始化密码,这三个点串起来才是真实可用的起点。少一个,Web 面板就只是个跑起来的容器,不是管理工具。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

1935

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

2562

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

896

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

2859

7

k8s和docker区别
k8s和docker区别

k8s和docker区别有抽象层次不同、管理范围不同、功能不同、应用程序生命周期管理不同、缩放能力不同、高可用性等等区别。本专题为大家提供k8s和docker区别相关的各种文章、以及下载和课程。

2023.07.24

625

4

docker进入容器的方法有哪些
docker进入容器的方法有哪些

docker进入容器的方法:1. Docker exec;2. Docker attach;3. Docker run --interactive --tty;4. Docker ps -a;5. 使用 Docker Compose。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

4219

6

docker容器无法访问外部网络怎么办
docker容器无法访问外部网络怎么办

docker 容器无法访问外部网络的原因和解决方法:配置 nat 端口映射以将容器端口映射到主机端口。根据主机兼容性选择正确的网络驱动(如 host 或 overlay)。允许容器端口通过主机的防火墙。配置容器的正确 dns 服务器。选择正确的容器网络模式。排除主机网络问题,如防火墙或连接问题。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

5077

6

docker镜像有什么用
docker镜像有什么用

docker 镜像是预构建的软件组件,用途广泛,包括:应用程序部署:简化部署,提高移植性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

1893

7

Docker容器化部署与DevOps实践
Docker容器化部署与DevOps实践

本专题面向后端与运维开发者,系统讲解 Docker 容器化技术在实际项目中的应用。内容涵盖 Docker 镜像构建、容器运行机制、Docker Compose 多服务编排,以及在 DevOps 流程中的持续集成与持续部署实践。通过真实场景演示,帮助开发者实现应用的快速部署、环境一致性与运维自动化。

2026.02.11

199

16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.6万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.1万人学习