在腾讯云轻量应用服务器(Lighthouse)上安装 Docker,核心难点不在于“装”,而在于网络连通性和镜像源提速。
很多新手直接照搬官方文档 apt install docker 或 yum install docker,结果要么卡在下载进度条上不动,要么拉取镜像时超时。这是因为国内默认源访问 Docker Hub 不稳定。
下面是一套经过验证、能一次跑通的实操方案。假设你使用的是 Ubuntu/Debian 系统(CentOS 逻辑类似,只是包管理器不同),且已拥有 SSH 权限。
第一步:环境准备与清理旧物
如果你之前尝试过安装 Docker 但失败了,或者安装了旧版本,先彻底清理,避免冲突。
# 卸载可能存在的旧版本
sudo apt-get remove docker docker-engine docker.io containerd runc
# 更新系统包索引
sudo apt-get update
第二步:安装依赖并配置阿里云镜像源(关键步骤)
不要直接用 curl -fsSL get.docker.com 这种一键脚本,容易因为网络波动失败。我们手动一步步来,确保可控。
- 安装必要的基础工具
sudo apt-get install -y ca-certificates curl gnupg lsb-release
- 添加 Docker 官方的 GPG 密钥
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
- 设置稳定版仓库
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
注意:此时如果直接
apt-get update,可能会非常慢甚至超时。为了解决这个问题,我们需要将源替换为阿里云或其他国内提速源,或者在安装完成后立即配置镜像提速器。为了简化流程,建议先执行apt-get update,如果成功则继续;如果失败,请检查网络连接或稍后重试。
- 安装 Docker Engine
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
第三步:启动并验证
安装完成后,Docker 服务通常会自动启动。如果没有,手动启动:
sudo systemctl start docker
sudo systemctl enable docker
运行 hello-world 测试:
sudo docker run hello-world
如果看到 “Hello from Docker!” 字样,说明基础环境没问题。
第四步:配置镜像提速器(必须做!)
这是最关键的一步。不配这个,你拉取任何镜像都可能超时或失败。
-
登录阿里云容器镜像服务控制台
前往 https://cr.console.aliyun.com,找到“镜像提速器”。你会看到一个专属地址,例如https://xxxxxx.mirror.aliyuncs.com。 -
修改 Docker 配置文件
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
"registry-mirrors": ["https://你的专属提速地址.mirror.aliyuncs.com"]
}
EOF
- 重启 Docker 服务
sudo systemctl daemon-reload
sudo systemctl restart docker
- 验证提速器是否生效
docker info | grep Registry
输出中应包含你配置的阿里云镜像地址。
第五步:非 root 用户权限优化(可选但推荐)
每次都要敲 sudo docker 很麻烦,而且不安全。我们可以让普通用户直接使用 docker 命令。
# 创建 docker 用户组
sudo groupadd docker
# 将当前用户加入 docker 组
sudo usermod -aG docker $USER
# 注销并重新登录 SSH,使组变更生效
之后你可以直接运行 docker ps 而无需 sudo。
常见问题排查
- 端口问题:腾讯云轻量服务器默认只开放部分端口(如 80, 443, 22, 3389 等)。如果你要在容器中映射外部端口(如
docker run -p 8080:80),必须在腾讯云控制台的【防火墙】规则中添加该端口的入站规则,否则网络无法访问。 - Swap 分区警告:Docker 在某些 Linux 内核版本下会提示禁用 Swap。轻量服务器内存较小,可能没有 Swap。如果遇到此警告,可以忽略,或在
/etc/default/grub中添加swapaccount=1并重启,但对于大多数 Web 应用影响不大。 - 防火墙冲突:确保
ufw或firewalld没有阻止 Docker 的桥接网络。通常 Docker 安装后会自行管理 iptables 规则,一般无需额外配置。
总结
在腾讯云轻量服务器上装 Docker,重点不是安装命令本身,而是:
- 使用稳定的源;
- 配置国内镜像提速器;
- 记得在云平台防火墙放行端口。
按照上述步骤操作,基本可以一次性成功。如果遇到具体报错,请提供错误日志,我可以进一步帮你分析。
云知道CLOUD