跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / Bash

Ubuntu 25.04 安装 Docker 与 Portainer 教程

在 Ubuntu 25.04 系统上通过命令行安装 Docker 引擎,配置阿里云镜像加速及国内镜像源,并使用 Docker 容器运行方式部署 Portainer 图形化管理界面。包含权限设置、端口映射及常见问题排查步骤,实现本地容器的可视化运维管理。

灵魂摆渡发布于 2026/2/9更新于 2026/10/2689 浏览
Ubuntu 25.04 安装 Docker 与 Portainer 教程

Ubuntu 25.04 安装 Docker 与 Portainer 教程

为什么选择 Docker + Portainer?

Docker 是目前最流行的容器化解决方案,可让您在隔离环境中轻松部署应用。Portainer 则提供了直观的 Web 界面,是管理 Docker 环境的理想工具,特别适合:

  • 容器管理初学者
  • 希望可视化操作的用户
  • 需要简化复杂容器操作流程的场景

下面是安装的具体步骤:

一、安装前置依赖

打开终端,执行以下命令升级系统并安装必要工具:

# 更新软件源
sudo apt update
sudo apt upgrade -y
# 安装必要工具(支持 HTTPS 传输)
sudo apt install apt-transport-https curl -y

这一步确保我们拥有安全访问仓库所需的工具支持。

二、配置 Docker 的阿里云镜像源

为避免从官方源下载速度缓慢,我们配置阿里云作为下载源:

# 导入 Docker 官方 GPG 密钥
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
# 添加 Docker 阿里云源(自动适配当前系统架构)
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://mirrors.aliyun.com/docker-ce/linux/ubuntu/ $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

注意: 这里会自动检测您的系统架构和版本代号,确保匹配正确。

三、安装 Docker 引擎

现在可以安装 Docker 及其相关组件:

# 刷新软件源
sudo apt update
# 安装 Docker 核心组件
sudo apt install -y \
  docker-ce \
  docker-ce-cli \
  containerd.io \
  docker-buildx-plugin \
  docker-compose-plugin \
  docker-ce-rootless-extras

安装后验证:

sudo docker version
# 查看已安装版本
sudo docker run hello-world

# 测试基本功能

看到 "Hello from Docker!" 消息说明安装成功。

四、配置国内镜像加速(重要步骤)

为提高后续镜像下载速度,创建或编辑配置文件:

sudo nano /etc/docker/daemon.json

添加以下内容(包含两个国内主流镜像源):

{
  "registry-mirrors": [
    "https://docker.1ms.run",
    "https://docker.aityp.com"
  ]
}

保存后重启 Docker 服务:

sudo systemctl restart docker

验证加速效果:

docker info | grep "Registry Mirrors"

五、安装 Portainer 图形化管理界面

5.1 启动 Portainer 容器
sudo docker run -d \
  --restart=always \
  --name="portainer" \
  -p 9005:9000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v portainer_data:/data \
  portainer/portainer-ce:2.9.1

参数说明:

  • --restart=always: Docker 重启时自动恢复
  • -p 9005:9000: 通过 9005 端口访问 WEB 管理界面
  • -v /var/run/...: 授予 Portainer 管理 Docker 的权限
  • -v portainer_data: 配置数据存储卷

六、访问和初始化 Portainer

  1. 在浏览器访问:http://你的主机 IP:9005/
  2. 初次使用会要求创建管理员账户
  3. 选择 "Local" 环境连接本地 Docker

七、常见问题解决

1. 权限问题

为当前用户添加 docker 组权限:

sudo usermod -aG docker $(whoami)
newgrp docker
# 刷新组权限

2. 端口冲突

如果 9005 端口被占用,修改启动命令中的端口映射,例如:

-p 9080:9000 # 改为其他端口

3. 国内镜像失效

  • 定期检查 daemon.json 中的镜像源可用性

可替换为其他镜像源如:

"https://registry.docker-cn.com", "https://docker.mirrors.ustc.edu.cn"

八、应用场景示例

  1. 通过 Portainer 部署 Nginx 服务:
    • 点击 Containers → + 创建容器
    • 输入名称 'web-server'
    • 镜像选择 nginx:latest
    • 端口映射:输入 '80:80'
    • 点击启动 即可访问 Nginx 欢迎页
  2. 管理多个 Docker 主机:
    • 在 Settings → Environments 中添加新主机 SSH 信息
    • 可集中管理所有部署了 Docker 的服务器

目录

  1. Ubuntu 25.04 安装 Docker 与 Portainer 教程
  2. 为什么选择 Docker + Portainer?
  3. 一、安装前置依赖
  4. 更新软件源
  5. 安装必要工具(支持 HTTPS 传输)
  6. 二、配置 Docker 的阿里云镜像源
  7. 导入 Docker 官方 GPG 密钥
  8. 添加 Docker 阿里云源(自动适配当前系统架构)
  9. 三、安装 Docker 引擎
  10. 刷新软件源
  11. 安装 Docker 核心组件
  12. 查看已安装版本
  13. 测试基本功能
  14. 四、配置国内镜像加速(重要步骤)
  15. 五、安装 Portainer 图形化管理界面
  16. 5.1 启动 Portainer 容器
  17. 六、访问和初始化 Portainer
  18. 七、常见问题解决
  19. 刷新组权限
  20. 八、应用场景示例

更多推荐文章

查看全部
  • Trae AI 原生 IDE 安装与上手指南
  • 10 款 AI 论文写作工具实测与使用指南
  • 【GitHub Copilot】Figma MCP还原设计稿生成前端代码
  • MWC 2026 IQ 时代与 DeepSeek V4 多模态技术解析
  • ComfyUI:AI 绘画与图像生成的高效工作流
  • WebGIS 实战:WKT 转 GeoJSON 方法与 Leaflet 集成
  • LangChain 框架简介、核心模块与文档指南
  • Python 爬虫入门与分布式架构原理
  • OpenClaw 飞书 AI 机器人搭建指南
  • JWT 详解:原理、与 Session 区别及 Spring Boot 实战
  • 基于 RAG 与 Prompt 的 AI 编程需求拆解与代码实现教程
  • DeepSeek 完整使用手册:功能、技巧与 API 集成指南
  • Windows 语音识别效率提升:Whisper 完全使用指南
  • 使用 Opencode Skills 组合掌控 AI 开发流程
  • Linux 部署 OpenClaw 并接入 QQ 机器人
  • Docker 部署 AI 量化分析平台:波浪理论实战指南
  • YOLO12 应用于无人机倾斜摄影密集楼宇窗户识别
  • 2026 主流 AI 编程助手深度评测:文心快码、Copilot 与 Cursor
  • 基于 Python 与 OpenCV 的自动扫雷程序实现
  • Android 不规则封闭区域填充色彩实现

相关免费在线工具

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online

  • JSON美化和格式化

    将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online