在腾讯云轻量应用服务器(Lighthouse)上安装 Docker,最稳妥且推荐的方式是通过官方源安装。虽然腾讯云控制台有“Docker 镜像”的一键部署选项,但如果你已经处于 Ubuntu 系统中,或者需要特定版本的 Docker,手动安装是更灵活的选择。
以下是基于 Ubuntu 20.04/22.04 LTS 系统的标准安装流程,步骤清晰,避免踩坑。
核心原则
- 优先使用
apt官方仓库:不要直接用curl -fsSL get.docker.com | bash这种脚本一键安装,除非你非常清楚自己在做什么。官方仓库的版本更新维护更有保障。 - 权限管理:后续操作建议配置非 root 用户可以使用 docker 命令,避免每次都要敲 sudo。
第一步:卸载旧版本(如果存在)
如果你的服务器上之前装过老版本的 Docker(如 docker, docker-engine, docker.io),建议先清理,防止冲突。
sudo apt-get remove docker docker-engine docker.io containerd runc
注意:这一步不会删除你的镜像、容器或数据卷,只是移除软件包。
第二步:更新系统并安装依赖
确保你的 Ubuntu 系统是最新的,并安装 HTTPS 传输所需的依赖包。
# 更新包索引
sudo apt-get update
# 安装必要的依赖
sudo apt-get install -y ca-certificates curl gnupg lsb-release
第三步:添加 Docker 官方 GPG 密钥和 APT 源
这是最关键的一步,确保你下载的是正版且安全的 Docker 包。
- 添加 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
- 设置稳定版仓库:
你需要根据你 Ubuntu 的具体版本来设置源。你可以用以下命令自动识别版本并添加源:
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
常见版本对照:
- Ubuntu 20.04 ->
focal- Ubuntu 22.04 ->
jammy- Ubuntu 24.04 ->
noble
第四步:安装 Docker Engine
再次更新包索引,然后安装 Docker 及其相关组件。
# 更新索引
sudo apt-get update
# 安装最新稳定版 Docker
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
第五步:验证安装
安装完成后,检查 Docker 服务是否启动,并运行测试容器。
# 检查服务状态
sudo systemctl status docker
# 运行 hello-world 测试
sudo docker run hello-world
如果看到 Hello from Docker! 的输出,说明安装成功。
进阶优化:免 sudo 运行 Docker
默认情况下,运行 docker 命令需要 sudo。为了方便日常开发,可以将当前用户加入 docker 用户组。
# 创建 docker 组(如果不存在)
sudo groupadd docker
# 将当前用户添加到 docker 组
sudo usermod -aG docker $USER
# 重启会话使更改生效(或者直接注销重新登录)
newgrp docker
之后,你就可以直接运行 docker ps 等命令,而不需要加 sudo。
腾讯云轻量服务器特别注意事项
-
防火墙与安全组:
Docker 本身不强制要求开放端口,但当你运行 Web 服务(如 Nginx, WordPress, Node.js)时,记得去腾讯云控制台 → 安全组 中放行对应端口(如 80, 443, 8080 等)。轻量服务器的防火墙规则是在控制台图形界面配置的,不是通过ufw或iptables。 -
Docker Compose 版本:
上述安装方式会自动安装docker-compose-plugin。使用时,命令是:docker compose up -d(注意中间没有横杠,这是新版插件的命令格式。如果你习惯旧版
docker-compose命令,可以单独安装二进制文件。) -
性能调优(可选):
轻量服务器通常资源有限。如果发现 Docker 容器内存占用过高,可以在/etc/docker/daemon.json中配置限制,例如:{ "default-runtime": "runc", "exec-opts": ["native.cgroupdriver=systemd"] }大多数情况下,默认配置即可满足个人项目需求。
-
关于云厂商定制版 Docker:
腾讯云有时会提供带有监控插件的 Docker 镜像或一键安装包,但这些主要用于企业级监控集成。对于普通开发者,使用标准上游 Docker CE 版本更利于排查问题和社区支持。
常见问题排查
-
Q: 提示
docker: command not found?
A: 检查环境变量,或尝试重新加载 shell:source ~/.bashrc。 -
Q: 无法连接 Docker 守护进程?
A: 检查sudo systemctl start docker是否报错。如果是权限问题,确认当前用户是否在docker组内。 -
Q: 如何查看已安装的 Docker 版本?
A:docker --version
按照以上步骤操作,你可以在腾讯云轻量 Ubuntu 服务器上顺利搭建 Docker 环境。如有其他具体应用场景(如 K8s、微服务架构),可进一步讨论。
云技术博客