努力
加油

腾讯云轻量服务器Ubuntu系统怎么安装Docker?

在腾讯云轻量应用服务器(Lighthouse)上安装 Docker,最稳妥且推荐的方式是通过官方源安装。虽然腾讯云控制台有“Docker 镜像”的一键部署选项,但如果你已经处于 Ubuntu 系统中,或者需要特定版本的 Docker,手动安装是更灵活的选择。

以下是基于 Ubuntu 20.04/22.04 LTS 系统的标准安装流程,步骤清晰,避免踩坑。

核心原则

  1. 优先使用 apt 官方仓库:不要直接用 curl -fsSL get.docker.com | bash 这种脚本一键安装,除非你非常清楚自己在做什么。官方仓库的版本更新维护更有保障。
  2. 权限管理:后续操作建议配置非 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 包。

  1. 添加 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
  1. 设置稳定版仓库:

你需要根据你 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。


腾讯云轻量服务器特别注意事项

  1. 防火墙与安全组:
    Docker 本身不强制要求开放端口,但当你运行 Web 服务(如 Nginx, WordPress, Node.js)时,记得去腾讯云控制台 → 安全组 中放行对应端口(如 80, 443, 8080 等)。轻量服务器的防火墙规则是在控制台图形界面配置的,不是通过 ufw 或 iptables。

  2. Docker Compose 版本:
    上述安装方式会自动安装 docker-compose-plugin。使用时,命令是:

    docker compose up -d

    (注意中间没有横杠,这是新版插件的命令格式。如果你习惯旧版 docker-compose 命令,可以单独安装二进制文件。)

  3. 性能调优(可选):
    轻量服务器通常资源有限。如果发现 Docker 容器内存占用过高,可以在 /etc/docker/daemon.json 中配置限制,例如:

    {
      "default-runtime": "runc",
      "exec-opts": ["native.cgroupdriver=systemd"]
    }

    大多数情况下,默认配置即可满足个人项目需求。

  4. 关于云厂商定制版 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、微服务架构),可进一步讨论。