在腾讯云的 Debian 系统上安装 Docker 非常简单。以下是详细的步骤,适用于 Debian 10、Debian 11 或 Debian 12。
✅ 步骤 1:更新系统包
sudo apt update && sudo apt upgrade -y
✅ 步骤 2:安装必要的依赖
sudo apt install -y ca-certificates curl gnupg lsb-release
✅ 步骤 3:添加 Docker 的 GPG 公钥
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
✅ 步骤 4:添加 Docker 官方 APT 仓库
根据你的 Debian 版本(如 bookworm、bullseye 等),设置正确的仓库。
先查看你的 Debian 版本:
lsb_release -cs
输出可能是 bookworm(Debian 12)、bullseye(Debian 11)等。
然后添加仓库(替换 $(lsb_release -cs) 为实际值,如 bookworm):
echo
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian
$(lsb_release -cs) stable" |
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
⚠️ 注意:如果提示权限问题,确保
/etc/apt/sources.list.d/可写。
✅ 步骤 5:更新 APT 包索引
sudo apt update
✅ 步骤 6:安装 Docker Engine
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
这将安装:
docker-ce: Docker 社区版containerd.io: 容器运行时docker-compose-plugin: 支持docker compose命令
✅ 步骤 7:验证安装
sudo docker --version
输出应类似:
Docker version 24.0.7, build afdd53b
测试运行一个容器:
sudo docker run hello-world
如果看到欢迎信息,说明安装成功。
✅ 步骤 8:(可选)配置非 root 用户使用 Docker
将当前用户加入 docker 组,避免每次使用 sudo:
sudo usermod -aG docker $USER
⚠️ 执行后需重新登录或重启 shell 才能生效。
验证(重新登录后):
docker run hello-world
不应再需要 sudo。
✅ 步骤 9:(可选)启用 Docker 开机自启
sudo systemctl enable docker
🛠️ 常见问题
-
报错:
NO_PUBKEYsudo apt-key add /etc/apt/keyrings/docker.gpg或使用:
sudo apt update --allow-insecure-repositories -
仓库找不到?
确保你的 Debian 版本被 Docker 支持。查看支持列表:https://docs.docker.com/engine/install/debian/ -
使用国内镜像提速(推荐腾讯云用户)
编辑或创建 Docker 配置文件:
sudo mkdir -p /etc/docker sudo tee /etc/docker/daemon.json <<EOF { "registry-mirrors": [ "https://mirror.ccs.tencentyun.com" ] } EOF腾讯云镜像提速地址:
https://mirror.ccs.tencentyun.com(需登录腾讯云容器镜像服务获取专属地址)重启 Docker:
sudo systemctl restart docker
✅ 完成!
你现在已经在腾讯云的 Debian 实例上成功安装了 Docker,可以开始部署容器应用了。
如需安装 docker-compose 命令,请注意:
docker-compose-plugin已安装,使用docker compose(有空格)- 而不是旧的
docker-compose(带连字符)
例如:
docker compose --version
如有问题欢迎提供错误信息,我可以帮你排查。
云计算导航