在腾讯云 Debian 服务器上安装 Docker,核心逻辑和在其他 Linux 发行版上是一致的,但考虑到国内网络环境和腾讯云的默认安全组策略,有几个坑需要提前避开。
这里提供两种方案:官方推荐的标准安装法(稳定、适合生产环境)和 一键脚本法(适合个人测试或快速部署)。鉴于你是腾讯云用户,我强烈建议优先使用第一种,因为更可控。
前置准备:检查系统版本
Debian 版本不同,命令略有差异。先确认你的版本:
cat /etc/os-release
通常我们用的是 Debian 10 (Buster) 或 Debian 11 (Bullseye)。以下步骤以较新的 Debian 11/12 为例。
方案一:官方标准安装(推荐)
这个方法通过添加 Docker 官方源来安装,保证你能拿到最新且稳定的版本。
1. 更新系统并安装依赖
SSH 登录到你的腾讯云 CVM,执行以下命令:
sudo apt update
sudo apt install -y ca-certificates curl gnupg lsb-release
2. 添加 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
sudo chmod a+r /etc/apt/keyrings/docker.gpg
注意:如果
curl下载速度极慢或者超时,说明 DNS 解析有问题或者网络不通。请检查你的服务器是否配置了正确的 DNS(如8.8.8.8或114.114.114.114),或者尝试更换为阿里云的镜像源(见后文“提速技巧”)。
3. 设置 Docker 稳定版仓库
将 Docker 的官方 APT 源添加到系统中:
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
4. 安装 Docker Engine
再次更新索引,然后安装 Docker 相关组件:
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
5. 验证安装
安装完成后,Docker 服务通常会自动启动。你可以运行 hello-world 镜像测试:
sudo docker run hello-world
如果看到 “Hello from Docker!” 字样,说明安装成功。
6. 【关键】免 sudo 运行 Docker
默认情况下,你需要每次都在命令前加 sudo。为了开发方便,可以将当前用户加入 docker 用户组:
sudo groupadd docker
sudo usermod -aG docker $USER
重要提示:修改完用户组后,你需要重新登录 SSH 或者重启服务器,否则新权限不会生效。
方案二:一键脚本安装(仅用于测试)
如果你只是想快速跑个 Demo,不想折腾源的问题,可以用 Docker 官方提供的一键安装脚本:
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
为什么指定
--mirror Aliyun?
因为直接从 Docker 官方下载脚本和资源在国内可能很慢,甚至失败。指定阿里云镜像可以显著加快安装速度。这是国内云服务器用户的常规操作。
腾讯云特有注意事项(避坑指南)
作为腾讯云用户,安装完 Docker 后,必须处理以下三个问题,否则容器大概率无法正常工作。
1. 安全组端口放行
Docker 本身不直接暴露端口给网络,但你的容器应用会。例如,如果你要运行一个 Web 服务(Nginx/Node.js/Python Flask),默认监听 80 或 8080 端口。
- 操作路径:腾讯云控制台 -> 实例 -> 更多 -> 网络和安全组 -> 管理安全组。
- 动作:添加入方向规则,允许 TCP 协议的
80、443或你自定义的端口。 - 常见错误:容器启动了,
docker ps能看到,但浏览器访问 IP:端口 超时。90% 的原因是忘了开安全组。
2. 内核参数优化(可选但推荐)
Debian 默认的 iptables/nftables 规则可能会干扰 Docker 的网络桥接。虽然现代 Docker 能自动处理,但在某些严格的安全策略下,可能需要调整内核参数。
编辑 /etc/sysctl.conf,确保包含以下内容:
net.ipv4.ip_forward=1
net.bridge.bridge-nf-call-iptables = 1
net.bridge.bridge-nf-call-ip6tables = 1
然后执行 sudo sysctl -p 使其生效。
3. 日志轮转配置
Docker 容器产生的日志如果不加限制,会迅速占满你的云硬盘空间(尤其是腾讯云的基础云盘)。建议在 /etc/docker/daemon.json 中配置日志驱动和大小限制:
{
"log-driver": "json-file",
"log-opts": {
"max-size": "10m",
"max-file": "3"
}
}
配置完后,重启 Docker 服务:
sudo systemctl restart docker
常见问题排查
Q: 安装时提示 E: Unable to locate package docker-ce?
A: 这说明第 3 步添加源失败了。请检查网络连接,或者手动检查 /etc/apt/sources.list.d/docker.list 文件内容是否正确。也可以尝试换用阿里云的 Docker 源替代官方源(搜索“阿里云 Docker 镜像提速”获取对应 Debian 版本的源地址)。
Q: docker ps 报错 permission denied?
A: 你没有把当前用户加入 docker 组,或者加了组但没有重新登录。请执行 sudo usermod -aG docker $USER 后退出 SSH 重新连接。
Q: 容器内无法上网?
A: 检查腾讯云实例是否有公网 IP。如果是私有子网内的实例,需要配置 NAT 网关或使用XX。另外,检查本地防火墙是否阻止了出站流量(虽然云服务器默认是放行的)。
总结:在腾讯云 Debian 上装 Docker,核心在于源的速度和安全组的配置。按照上述步骤操作,基本可以一次性搞定。如果遇到网络问题,优先替换为国内镜像源即可解决。
云技术博客