Shell / Bash
Ubuntu 25.04 安装 Docker 与 Portainer 教程
在 Ubuntu 25.04 系统上通过命令行安装 Docker 引擎，配置阿里云镜像加速及国内镜像源，并使用 Docker 容器运行方式部署 Portainer 图形化管理界面。包含权限设置、端口映射及常见问题排查步骤，实现本地容器的可视化运维管理。
在 Ubuntu 25.04 系统上通过命令行安装 Docker 引擎，配置阿里云镜像加速及国内镜像源，并使用 Docker 容器运行方式部署 Portainer 图形化管理界面。包含权限设置、端口映射及常见问题排查步骤，实现本地容器的可视化运维管理。
Docker 是目前最流行的容器化解决方案，可让您在隔离环境中轻松部署应用。Portainer 则提供了直观的 Web 界面，是管理 Docker 环境的理想工具，特别适合：
下面是安装的具体步骤：
打开终端，执行以下命令升级系统并安装必要工具：
# 更新软件源
sudo apt update
sudo apt upgrade -y
# 安装必要工具（支持 HTTPS 传输）
sudo apt install apt-transport-https curl -y
这一步确保我们拥有安全访问仓库所需的工具支持。
为避免从官方源下载速度缓慢，我们配置阿里云作为下载源：
# 导入 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 及其相关组件：
# 刷新软件源
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"
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: 配置数据存储卷http://你的主机 IP:9005/1. 权限问题
为当前用户添加 docker 组权限：
sudo usermod -aG docker $(whoami)
newgrp docker
# 刷新组权限
2. 端口冲突
如果 9005 端口被占用，修改启动命令中的端口映射，例如：
-p 9080:9000 # 改为其他端口
3. 国内镜像失效
可替换为其他镜像源如：
"https://registry.docker-cn.com", "https://docker.mirrors.ustc.edu.cn"
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online