在腾讯云上使用 Debian 系统配置 Docker,需要满足以下前置条件和步骤,以确保顺利安装和运行 Docker。
一、基础环境要求(前置条件)
-
操作系统版本
- 推荐使用较新的稳定版 Debian,如:
- Debian 10 (Buster)
- Debian 11 (Bullseye)
- Debian 12 (Bookworm)
- 腾讯云提供官方镜像支持这些版本,建议选择官方 Debian 镜像创建实例。
- 推荐使用较新的稳定版 Debian,如:
-
系统资源
- 至少 1GB 内存(推荐 2GB 或以上)
- 剩余磁盘空间 ≥ 10GB(Docker 镜像和容器会占用空间)
-
用户权限
- 使用具有
sudo权限的非 root 用户,或直接使用 root 用户操作。 - 建议开启 sudo 并将当前用户加入
docker组,避免每次使用sudo docker。
- 使用具有
-
网络连接
- 实例需能访问网络(用于下载 Docker 安装包和镜像)
- 确保安全组规则允许必要的端口(如 SSH 22,后续可能开放 80/443 等)
-
时间同步
- 确保系统时间准确,可通过 NTP 同步:
sudo timedatectl set-ntp true
- 确保系统时间准确,可通过 NTP 同步:
二、系统准备步骤
1. 更新系统软件包
sudo apt update && sudo apt upgrade -y
2. 安装依赖包
sudo apt install -y apt-transport-https ca-certificates curl gnupg lsb-release
3. 添加 Docker 官方 GPG 密钥
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
4. 添加 Docker APT 仓库
根据你的 Debian 版本(buster/bullseye/bookworm),执行如下命令(以 Debian 11 bullseye 为例):
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
⚠️ 注意:
$(lsb_release -cs)应输出bullseye、bookworm等。确认无误。
5. 更新 APT 缓存
sudo apt update
三、安装 Docker 引擎
sudo apt install -y docker-ce docker-ce-cli containerd.io
docker-ce是社区版,适合大多数场景。
四、验证安装
sudo docker version
sudo docker run hello-world
如果看到欢迎信息,说明安装成功。
五、(可选)配置非 root 用户使用 Docker
将当前用户加入 docker 组:
sudo usermod -aG docker $USER
然后重新登录或执行:
newgrp docker
之后即可无需 sudo 运行 docker 命令。
六、(可选)配置国内镜像提速(提升拉取速度)
编辑 /etc/docker/daemon.json:
{
"registry-mirrors": [
"https://mirror.ccs.tencentyun.com"
]
}
腾讯云提供专属镜像提速地址:
https://mirror.ccs.tencentyun.com(仅限腾讯云内网访问更高效)
重启 Docker 服务:
sudo systemctl daemon-reload
sudo systemctl restart docker
七、启用并设置开机自启
sudo systemctl enable docker
sudo systemctl start docker
总结:关键前置条件清单
| 条件 | 说明 |
|---|---|
| ✅ Debian 10+ | 推荐使用官方镜像 |
| ✅ sudo 权限 | 用于安装和配置 |
| ✅ 网络通畅 | 可访问 Docker 仓库和镜像源 |
| ✅ 安装必要工具 | curl, gnupg, apt-transport-https 等 |
| ✅ 添加 Docker 官方源 | 使用 HTTPS 和 GPG 校验保证安全 |
| ✅ 腾讯云镜像提速 | 提高 pull 镜像速度(推荐) |
完成以上步骤后,你就可以在腾讯云的 Debian 实例上正常使用 Docker 部署应用了。
云小栈