在腾讯云 Ubuntu 镜像中部署 Docker,所谓的“一键”通常指的是利用云厂商提供的自动化脚本、Cloud-Init 配置,或者通过简单的 Shell 命令组合来实现。虽然不存在一个真正的魔法按钮(除非你使用容器化应用市场),但我们可以把过程简化为几个核心步骤,确保环境干净、安全且符合最佳实践。
以下是基于腾讯云 Ubuntu 实例的标准操作流程,分为基础手动版(适合理解原理)和自动化/进阶版(适合生产环境)。
一、 前置准备:连接与权限
-
登录服务器
使用 SSH 工具(如 PuTTY、Xshell 或终端)连接到你的腾讯云 Ubuntu 实例。ssh root@<你的公网IP>注意:Ubuntu 默认用户通常是
ubuntu,如果你使用的是自定义镜像或特定版本,请确认用户名。 -
更新系统包
保持系统最新是减少依赖冲突的关键。sudo apt update && sudo apt upgrade -y
二、 标准安装流程(推荐方式)
腾讯云的 Ubuntu 镜像本身并不预装 Docker CE(社区版),因为官方源中的 Docker 版本可能滞后。最稳定、合规的方式是通过 Docker 官方仓库安装。
1. 卸载旧版本(如果存在)
如果之前安装过 docker.io 或其他旧版,建议清理以避免冲突。
sudo apt-get remove docker docker-engine docker.io containerd runc
2. 设置 Docker 官方 GPG 密钥和 APT 源
这一步是为了确保下载的软件来自可信源,防止中间人攻击。
# 安装必要的依赖
sudo apt-get install ca-certificates curl gnupg lsb-release -y
# 添加 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
3. 安装 Docker Engine
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin -y
4. 验证安装
sudo docker run hello-world
看到 Hello from Docker! 即表示安装成功。
三、 关键优化:免 sudo 运行 & 开机自启
普通用户每次都要输 sudo docker ... 很麻烦,且容易出错。
1. 创建 docker 用户组并添加当前用户
# 创建 docker 组
sudo groupadd docker
# 将当前用户加入 docker 组
sudo usermod -aG docker $USER
# 激活更改(需要重新登录生效,或执行 newgrp docker)
newgrp docker
2. 设置开机自启并启动服务
sudo systemctl enable docker
sudo systemctl start docker
四、 “伪一键”部署:使用 Cloud-Init 或 UserData
如果你希望在新建实例时自动完成上述所有操作,可以使用腾讯云控制台提供的 “高级选项” -> “自定义数据” 功能,传入一段 Cloud-Init 脚本。
在创建 CVM 实例时,找到“自定义数据”输入框,粘贴以下内容:
#cloud-config
package_update: true
package_upgrade: true
packages:
- ca-certificates
- curl
- gnupg
- lsb-release
runcmd:
# 添加 Docker 官方 GPG 密钥
- mkdir -p /etc/apt/keyrings
- curl -fsSL https://download.docker.com/linux/ubuntu/gpg | 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" > /etc/apt/sources.list.d/docker.list
# 安装 Docker
- apt-get update
- apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
# 配置权限
- groupadd docker
- usermod -aG docker ubuntu
- systemctl enable docker
- systemctl start docker
注意:请将
ubuntu替换为你实际使用的用户名。这种方式实现了真正意义上的“创建即部署”。
五、 常见问题与避坑指南
-
网络问题:
国内访问download.docker.com有时较慢。如果遇到下载超时,可以考虑更换为阿里云的 Docker 镜像源(需修改/etc/apt/sources.list.d/docker.list中的 URL),但需注意合规性和稳定性风险。强烈建议使用官方源,若速度不可接受,可考虑在本地构建镜像后上传至腾讯云镜像仓库(TCR),再拉取部署。 -
内核模块缺失:
某些精简版 Ubuntu 镜像可能缺少overlay2驱动所需的内核模块。如果 Docker 启动失败,检查日志:journalctl -u docker.service确保安装了
linux-image-extra-virtual包。 -
防火墙与安全组:
Docker 默认绑定到127.0.0.1,不会直接暴露端口。如果你需要外部访问容器端口(如-p 80:80),务必在腾讯云控制台的 安全组 规则中放行相应端口,同时在服务器内部检查ufw是否阻止了流量。 -
资源限制:
腾讯云轻量应用服务器(Lighthouse)和低配 CVM 内存较小,Docker 守护进程会占用一定内存。建议至少分配 1GB 以上内存,并配置 Swap 分区以防 OOM(内存溢出)。
六、 总结
对于大多数用户,手动执行第二步的命令序列是最稳妥、最透明的方式。它让你清楚每一步发生了什么,便于后续排查问题。
如果你追求效率,使用 Cloud-Init 脚本 是在新建实例时实现“一键部署”的最佳实践。避免使用第三方非官方的“一键安装包”,这些脚本往往包含未审计的代码,存在安全风险,尤其在云服务器这种高价值资产上,安全性应优先于便利性。
云技术博客