努力
加油

腾讯云Debian服务器安装Docker的步骤是什么?

在腾讯云 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,核心在于源的速度和安全组的配置。按照上述步骤操作,基本可以一次性搞定。如果遇到网络问题,优先替换为国内镜像源即可解决。