在TencentOS Server 3.1 TK4系统上如何正确安装Docker？-ECLOUD博客

在 TencentOS Server 3.1 TK4（基于 CentOS 8/Red Hat 8 生态的腾讯云定制系统）上安装 Docker，推荐使用官方推荐的 Docker Engine 方式，通过腾讯云提供的容器镜像仓库或 Docker 官方源进行安装。以下是标准安装步骤：

✅ 前置条件

系统版本确认：cat /etc/tencentos-release 应显示 TencentOS Server release 3.1 (TK4)
已配置 YUM/DNF 源（默认已包含腾讯云官方源）
关闭防火墙或开放必要端口（可选，但建议先测试）
以 root 用户或 sudo 权限执行

🔧 安装步骤

1️⃣ 卸载旧版 Docker（如已存在）

sudo yum remove -y docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine

若使用 dnf 代替 yum 也可：sudo dnf remove ...

2️⃣ 安装依赖包

sudo yum install -y yum-utils device-mapper-persistent-data lvm2

3️⃣ 添加 Docker 官方 YUM 仓库（推荐方式）

腾讯云 TK4 通常已预装兼容 Docker 的仓库，但若需最新稳定版，可手动添加：

# 方法一：使用腾讯云官方 Docker 仓库（推荐）
sudo yum-config-manager --add-repo https://mirrors.cloud.tencent.com/docker-ce/linux/centos/docker-ce.repo

# 方法二（备用）：使用 Docker 官方源
# sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

💡 提示：腾讯云镜像源速度更快、稳定性更高，优先使用 mirrors.cloud.tencent.com

4️⃣ 安装 Docker CE 及相关组件

sudo yum install -y docker-ce docker-ce-cli containerd.io

注意：containerd.io 是必需组件，Docker 20.10+ 已将其作为独立服务。

5️⃣ 启动并设置开机自启

sudo systemctl start docker
sudo systemctl enable docker

6️⃣ 验证安装

docker version
docker run hello-world

若看到欢迎信息，则安装成功。

🛠️ 可选优化：配置镜像提速（强烈推荐）

为避免拉取镜像慢，可配置腾讯云镜像提速器：

编辑 /etc/docker/daemon.json：

{
 "registry-mirrors": [
   "https://docker.mirrors.tencentyun.com"
 ]
}

重载配置并重启 Docker：

sudo systemctl daemon-reload
sudo systemctl restart docker

⚠️ 注意：若使用其他云厂商或自建 registry，请替换对应地址。

❗ 常见问题排查

问题	解决方案
`docker: command not found`	检查是否未添加到 PATH，或安装失败；重新运行安装命令
`permission denied while trying to connect to the Docker socket`	将当前用户加入 `docker` 组：`sudo usermod -aG docker $USER`，然后重新登录
启动失败（systemctl status docker）	查看日志：`journalctl -u docker.service`；检查 `containerd` 状态
拉取镜像超时	配置上述镜像提速器；或使用国内公共镜像（如 `docker pull registry.cn-hangzhou.aliyuncs.com/library/hello-world`）

📌 补充说明

TencentOS 3.1 TK4 对内核有定制优化，不建议升级非官方 Docker 版本，以免引发兼容性风险。
若需 Kubernetes 环境，可考虑使用腾讯云 TKE 托管服务，避免本地集群维护成本。
所有操作建议在测试环境中先行验证。

如需进一步集成 Prometheus + Grafana 监控、或部署 CI/CD 流水线，可继续提问。