在腾讯云 Ubuntu 服务器上部署 Docker,核心逻辑其实和在其他 Linux 发行版上差不多,但考虑到国内网络环境、云服务器的安全组配置以及腾讯云的特定操作习惯,有几个“坑”需要特别注意。
下面按生产环境的标准流程走一遍,确保你装完就能用,而不是装完发现连不上网或者权限不对。
一、 前置准备:系统清理与环境检查
很多新手直接 apt install docker.io,这在老版本 Ubuntu 上没问题,但在较新的版本(如 20.04, 22.04)中,官方推荐的源才是最新稳定版。所以第一步是彻底清除可能存在的旧版本残留,避免冲突。
打开终端,执行以下命令:
# 卸载可能存在的旧版本或无关包
sudo apt-get remove docker docker-engine docker.io containerd runc
# 更新软件包索引
sudo apt-get update
二、 安装 Docker Engine
这里推荐使用 Docker 官方提供的 APT 仓库进行安装,这样后续升级比较方便。
1. 设置依赖项和 Docker 官方 GPG 密钥
这一步是为了确保你下载的软件包来源可信。
sudo apt-get install -y ca-certificates curl gnupg lsb-release
# 添加 Docker 官方 GPG key
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
# 设置权限
sudo chmod a+r /etc/apt/keyrings/docker.gpg
2. 添加 Docker 官方 APT 仓库
根据你当前的 Ubuntu 版本自动选择对应的源。大多数腾讯云 Ubuntu 镜像现在都是 20.04 或 22.04。
echo
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
3. 安装 Docker
再次更新索引,然后安装全套组件(包括 engine, cli, containerd, compose)。
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
4. 验证安装
sudo docker run hello-world
如果看到 “Hello from Docker!” 并提示成功,说明基础环境没问题。
三、 关键配置:免 sudo 运行 & 开机自启
1. 创建 docker 用户组并加入当前用户
默认情况下,Docker daemon 绑定在一个 Unix socket 上,只有 root 用户或 docker 组的成员才能访问这个 socket。为了日常开发不用每次都敲 sudo,我们需要把当前用户加到 docker 组。
# 创建 docker 组(如果已存在会提示)
sudo groupadd docker
# 将当前登录用户加入 docker 组
sudo usermod -aG docker $USER
# 重启生效(或者重新登录 SSH)
newgrp docker
注意:修改完后,最好断开 SSH 重新连接一下,或者执行 newgrp docker 让当前会话生效,否则 docker ps 可能会报 permission denied。
2. 设置 Docker 服务开机自启
云服务器重启后,Docker 不应该手动去启动。
sudo systemctl enable docker
sudo systemctl enable containerd
四、 国内网络优化:镜像提速器
这是在国内云服务器上使用 Docker 最重要的一步。默认拉取 Docker Hub 的镜像速度极慢,甚至超时失败。我们需要配置阿里云或腾讯云自己的镜像提速地址。
以腾讯云为例(如果你用的是其他云厂商,替换对应的提速 URL 即可):
-
编辑
/etc/docker/daemon.json文件。如果文件不存在,就新建一个。sudo vi /etc/docker/daemon.json -
填入以下内容(注意 JSON 格式,逗号不要多也不要少):
{ "registry-mirrors": [ "https://mirror.ccs.tencentyun.com" ] }注:上面的
mirror.ccs.tencentyun.com是腾讯云通用的公共提速地址。如果你有个人专属的提速地址(通常在腾讯云控制台->容器服务->镜像提速器里可以看到),请替换为你自己的。 -
重启 Docker 服务使配置生效:
sudo systemctl restart docker -
验证配置是否生效:
docker info | grep -i mirror如果输出了你刚才配置的提速地址 URL,说明配置成功。
五、 腾讯云特有注意事项:安全组与防火墙
很多人 Docker 跑起来了,容器也开了端口(比如 8080),但网络就是访问不了。这通常不是 Docker 的问题,而是腾讯云的安全组没放行。
-
检查云主机安全组:
- 登录腾讯云控制台 -> CVM 实例 -> 点击你的服务器 ID -> 左侧菜单找到“安全组”。
- 查看入站规则(Inbound Rules)。
- 确保你容器映射的端口(例如
-p 8080:80)已经在安全组的允许列表中。协议选 TCP,源 IP 一般填0.0.0.0/0表示允许所有 IP 访问。
-
检查本地防火墙(UFW):
- Ubuntu 默认可能开启了 UFW 防火墙。虽然 Docker 会自动处理 iptables 规则,但为了保险起见,建议确认 UFW 状态。
- 如果你不熟悉 iptables,建议暂时关闭 UFW 测试连通性:
sudo ufw disable - 生产环境建议保持 UFW 开启,并手动放行相关端口:
sudo ufw allow 8080/tcp
六、 常用运维技巧
-
查看 Docker 日志:
当容器启动失败时,别瞎猜,看日志最直接。# 查看最近 100 行日志 docker logs -f --tail 100 <容器ID或名称> -
清理磁盘空间:
Docker 用久了,悬空镜像(dangling images)和未使用的卷会占用大量磁盘。定期清理可以释放空间。# 清理所有停止的容器、未使用的网络和悬空镜像 docker system prune -a警告:这会删除所有未被任何容器使用的镜像,请谨慎使用。
-
使用 Docker Compose 管理多容器:
上面安装的docker-compose-plugin让你可以直接用docker compose up -d来运行docker-compose.yml文件,比老版本的docker-compose二进制命令更推荐,因为它是作为 Docker CLI 的子命令存在的,版本跟随 Docker Engine 一起更新。
总结
在腾讯云 Ubuntu 上装 Docker,核心就三点:
- 源要对:用官方源,别用系统自带的老包。
- 速要快:必须配镜像提速器,否则体验极差。
- 门要开:别忘了去腾讯云控制台开安全组端口。
按照这个流程走,基本不会踩坑。如果遇到具体报错,贴出错误日志再针对性排查,通常 90% 的问题都出在网络不通或者权限不足上。
云技术博客