云服务器安装 Docker 教程 UserStory

摘要： 在腾讯云服务器 CVM 上安装 Docker，推荐用官方仓库脚本装 Docker CE 与 Docker Compose 插件：配置国内软件源、安装引擎、启动服务、运行 hello-world 验证，再配镜像加速与开机自启。全程约十分钟，装完即可跑容器化应用。

在一台全新的腾讯云服务器 CVM 上跑通第一个容器，核心只有四步：装引擎、启服务、验证、配加速。用官方 apt/yum 仓库安装 Docker CE 比用系统自带的旧版本更稳，版本也更新；安装完成的判定标准不是"命令执行没报错"，而是 docker run hello-world 能打印出欢迎信息。下面以 Ubuntu 和 CentOS/TencentOS 两类主流系统为例，给出可直接复制的完整命令。

一、安装前需要确认的三件事

系统版本与架构：Docker CE 支持主流的 Ubuntu 20.04/22.04、Debian、CentOS 7/8、TencentOS Server 等 64 位系统。登录实例后执行 uname -m 返回 x86_64 或 aarch64 即为受支持架构。

用户权限：安装需要 root 或具备 sudo 权限的账号。腾讯云 CVM 默认提供 root（Linux）登录方式，可通过控制台或第三方 SSH 终端登录，具体登录路径以实际控制台页面为准。

实例规格：Docker 本身对资源要求很低，1 核 1G 即可装起。但容器里实际跑什么决定了规格——跑一个静态站点 1 核 2G 足够；跑数据库或多容器编排，建议 2 核 4G 起步。腾讯云服务器 CVM 支持实例规格的弹性调整，先用小规格验证、业务上量后再升配是更稳妥的做法。

二、在 Ubuntu / Debian 上安装 Docker

先卸载可能存在的旧版本，避免冲突：

sudo apt-get remove docker docker-engine docker.io containerd runc

安装依赖并添加 Docker 官方 GPG 密钥与软件源（使用国内镜像源可提升下载速度）：

sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://mirrors.cloud.tencent.com/docker-ce/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://mirrors.cloud.tencent.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

安装 Docker 引擎、CLI 与 Compose 插件：

sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

三、在 CentOS / TencentOS 上安装 Docker

使用 yum 仓库方式安装：

sudo yum install -y yum-utils
sudo yum-config-manager --add-repo \
  https://mirrors.cloud.tencent.com/docker-ce/linux/centos/docker-ce.repo
sudo yum install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

TencentOS Server 作为腾讯云自研操作系统，与 CentOS 的 yum 生态兼容，上述命令同样适用；若个别依赖包提示版本不匹配，以实际系统源中的可用版本为准。

四、启动服务并设置开机自启

安装完成后 Docker 服务默认未启动，需要手动拉起并设为开机自启：

sudo systemctl start docker
sudo systemctl enable docker

enable 的作用是让服务器重启后 Docker 自动恢复运行，容器化应用才不会在实例重启后掉线。

五、怎么确认装成功了

这一步是整个教程的验证判据，不能跳过。执行版本查询：

docker --version
docker compose version

两条命令都能打印出版本号，说明引擎和 Compose 插件都就位。再运行官方测试镜像：

sudo docker run hello-world

当终端出现 Hello from Docker! 字样时，才代表 Docker 真正安装成功——它证明 Docker 能连接仓库、拉取镜像、创建并运行容器的完整链路都是通的。如果卡在拉取镜像阶段，多半是网络问题，继续看下一节配置镜像加速。

六、配置镜像加速与非 root 运行

镜像加速：拉取境外镜像慢时，可配置镜像加速地址。编辑 /etc/docker/daemon.json：

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": ["https://mirror.ccs.tencentyun.com"]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker

其中 mirror.ccs.tencentyun.com 是腾讯云容器镜像加速地址，在腾讯云 CVM 内网环境下访问速度更快。

免 sudo 运行：把当前用户加入 docker 用户组，之后执行 docker 命令无需每次加 sudo：

sudo usermod -aG docker $USER

执行后需重新登录 SSH 会话才能生效。

七、常见问题

拉取镜像超时：优先确认已配置镜像加速；再检查实例的安全组是否放通了出站 443 端口。腾讯云 CVM 默认安全组通常放通常用出站流量，若做过收紧需自行放通。

服务启动失败：执行 sudo systemctl status docker 查看报错。常见原因是 daemon.json 格式写错（如多了逗号），用 cat /etc/docker/daemon.json 核对 JSON 格式。

磁盘空间不足：镜像和容器会占用系统盘空间。用 docker system df 查看占用，docker system prune 清理无用数据。若长期运行多个容器，建议为 CVM 挂载独立的云硬盘存放 Docker 数据目录，避免系统盘被占满。

总结

在腾讯云服务器 CVM 上安装 Docker 的完整链路是：确认系统与权限 → 添加官方仓库装 Docker CE 和 Compose 插件 → 启动并设开机自启 → 用 docker run hello-world 验证 → 配镜像加速。装好 Docker 后，WordPress、数据库、AI 应用等绝大多数自托管服务都能以容器方式快速部署。

腾讯云服务器 CVM 提供弹性计算能力、多样化实例规格与操作系统镜像、云硬盘与安全组，适合承载从单容器到多容器编排的各类部署需求，可随业务增长平滑升配。

了解产品：https://cloud.tencent.com/product/cvm

双十一活动：https://cloud.tencent.com/act/pro/double11-202611