避坑指南：在云主机上部署Portainer中文版的完整流程（附免费GPU资源）

最新推荐文章于 2026-06-07 11:04:37 发布

原创

最新推荐文章于 2026-06-07 11:04:37 发布 · 433 阅读

标签

#Portainer #Docker #容器管理 #云主机部署

避坑指南：在云主机上部署Portainer中文版的完整流程（附免费GPU资源）

最近几年，容器技术已经从开发者的“玩具”变成了企业基础设施的“标配”。但说实话，每次在命令行里敲 docker ps、docker logs，或者管理一堆复杂的 docker-compose.yml 文件时，总感觉少了点什么——一个直观、统一的管理界面。特别是当你需要在云服务器上快速搭建一套开发环境，或者管理多个容器化应用时，一个图形化的管理工具能省下大量时间和精力。

Portainer 就是这样一个“救星”。它把 Docker 和 Kubernetes 的管理界面做得像操作手机 App 一样简单。不过，很多朋友在初次部署时，尤其是在云主机这种远程环境下，总会遇到一些“坑”：端口映射不对、防火墙没开、镜像拉取慢、甚至因为时区问题导致日志时间错乱。更让人头疼的是，很多教程只讲基础安装，对于如何安全地暴露到公网、如何利用云服务商提供的特殊资源（比如免费的 GPU 算力）却语焉不详。

这篇文章，我就结合自己多次在各类云平台（包括提供免费 GPU 的社区资源）上部署 Portainer 的经验，为你梳理一份从零开始、避坑为主的完整指南。我们不仅会安装 Portainer 的中文社区版，还会重点解决外网安全访问和利用免费 GPU 资源这两个实战中高频出现的问题。无论你是刚接触容器的新手，还是希望优化现有云上工作流的开发者，相信都能找到有用的东西。

1. 环境准备与云主机选择

在开始部署任何服务之前，打好地基是关键。云主机的选择、操作系统的配置，直接决定了后续步骤的顺畅程度。很多人一上来就 docker run，结果卡在权限、网络或者资源不足上，白白浪费几个小时。

1.1 选择合适的云主机与操作系统

对于学习和实践 Docker 及 Portainer，我强烈建议从提供免费试用资源的云平台开始。这不仅能零成本入门，还能让你熟悉真实的云环境操作。近期，一些专注于 AI 开发和社区共享的平台会提供限时的免费 GPU 算力，这对于想尝试 GPU 加速应用（如机器学习模型训练、AI 推理）的开发者来说，是绝佳的起点。

选择云主机时，关注以下几点：

系统镜像：优先选择 Ubuntu 22.04 LTS 或 20.04 LTS。它们是 Docker 社区支持最完善、文档最丰富的 Linux 发行版，能避开大量依赖库问题。
资源配置：即使是免费资源，也尽量选择 1核2GB内存 以上的配置。运行 Portainer 本身资源消耗不大，但你需要为未来可能运行的业务容器预留空间。
网络与安全组：这是第一个大坑。务必确认云平台的安全组（或防火墙）规则允许你自定义开放端口。很多平台默认只开放 SSH 的 22 端口，你需要能自主添加如 9000、8000 等 Portainer 所需端口。

提示：如果你选择的平台提供了免费 GPU（例如 NVIDIA T4 或 4090 试用卡），在创建实例时，记得勾选相应的 GPU 规格。并确保系统镜像已包含基础的 NVIDIA 驱动或 CUDA 工具包，这能为后续运行需要 GPU 的容器铺平道路。

1.2 基础系统配置与 Docker 安装

拿到一台崭新的云主机，先别急着部署。完成以下几个基础配置，能让后续所有操作事半功倍。

首先，更新系统并安装常用工具：

# 以 root 用户或使用 sudo 执行
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl wget vim net-tools

接下来是重头戏：安装 Docker。Ubuntu 官方仓库的 Docker 版本可能较旧，我们采用 Docker 官方提供的安装脚本，这是最稳妥的方式。

# 下载并执行 Docker 官方安装脚本
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

安装完成后，将当前用户加入 docker 用户组，这样以后就不用每次都加 sudo 了。

# 将当前用户加入 docker 组
sudo usermod -aG docker $USER
# 注意：需要重新登录（退出SSH再连接）才能使组生效

验证 Docker 是否安装成功：

docker --version
# 预期输出类似：Docker version 24.0.7, build xxxxxxx
docker run hello-world
# 如果能成功运行并看到欢迎信息，说明 Docker 引擎工作正常。

最后，配置 Docker 镜像加速器。直接从 Docker Hub 拉取镜像速度可能很慢，甚至超时。替换为国内镜像源是必选项。

# 创建或修改 Docker 守护进程配置文件
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://hub-mirror.c.163.com",
    "https://mirror.baidubce.com",
    "https://docker.mirrors.ustc.edu.cn"
  ]
}
EOF
# 重启 Docker 服务使配置生效
sudo systemctl daemon-reload
sudo systemctl restart docker

你可以从下表中选择一个或多个镜像源替换上面的地址：