京东云主机使用Docker时报错，常见原因有哪些？

在京东云主机上使用 Docker 时报错，可能由多种原因引起。以下是常见问题及其排查方向和解决方法：

一、Docker 未安装或安装不完整

现象：执行 docker 命令报错如 command not found 或 docker: command not found。

解决方法：

• 确认是否已正确安装 Docker。

• 安装命令示例（以 CentOS/Ubuntu 为例）：

  # Ubuntu
  sudo apt update && sudo apt install docker.io
  
  # 或使用官方脚本安装
  curl -fsSL https://get.docker.com | sh

• 安装后启动并设置开机自启：

  sudo systemctl start docker
  sudo systemctl enable docker

二、权限不足（Permission denied）

现象：运行 docker ps 报错 Got permission denied while trying to connect to the Docker daemon socket。

原因：当前用户不在 docker 用户组中。

解决方法：

# 将当前用户加入 docker 组
sudo usermod -aG docker $USER

# 重新登录或刷新组权限
newgrp docker

三、Docker 服务未启动

现象：提示 Cannot connect to the Docker daemon。

解决方法：

# 检查 Docker 服务状态
sudo systemctl status docker

# 启动服务
sudo systemctl start docker

# 查看日志定位问题
sudo journalctl -u docker.service --no-pager -n 50

四、系统资源不足

现象：容器启动失败、卡顿、OOM（内存溢出）等。

原因：京东云主机配置较低（如1核1G），运行多个容器或大镜像时资源耗尽。

解决方法：

• 升级云主机配置（CPU、内存、磁盘）。
• 清理无用的镜像和容器：

  docker system prune -a

• 监控资源使用情况：

  docker stats
  free -h

五、镜像拉取失败（Pull 失败）

现象：docker pull 超时或连接拒绝。

可能原因：

• 镜像源访问受限（尤其是国外镜像如 docker.io/library/nginx）。
• 网络策略限制（安全组、防火墙）。
• DNS 解析问题。

解决方法：

1. 配置国内镜像提速器（推荐）：
   编辑 /etc/docker/daemon.json：

   {
     "registry-mirrors": [
       "https://<your-mirror>.mirror.aliyuncs.com",
       "https://hub-mirror.c.163.com",
       "https://docker.mirrors.ustc.edu.cn"
     ]
   }

   重启 Docker：

   sudo systemctl restart docker

2. 检查网络连通性：

   ping registry-1.docker.io
   curl -v https://hub.docker.com

六、端口冲突或被占用

现象：容器启动时提示 port is already allocated。

解决方法：

# 查看端口占用
sudo netstat -tulnp | grep :80

# 或使用 lsof
sudo lsof -i :80

# 停止占用进程或更换容器端口映射

七、SELinux 或防火墙干扰（CentOS/RHEL）

现象：容器无法访问网络或挂载目录失败。

解决方法：

• 临时关闭 SELinux 测试：

  setenforce 0

• 修改 /etc/selinux/config 永久关闭（生产环境慎用）。
• 开放防火墙端口：

  sudo firewall-cmd --permanent --add-port=80/tcp
  sudo firewall-cmd --reload

八、存储驱动或磁盘空间问题

现象：no space left on device 或 devicemapper 错误。

解决方法：

• 检查磁盘使用情况：

  df -h

• 清理 Docker 资源：

  docker system prune -f
  docker volume prune

• 如使用 devicemapper，建议切换为 overlay2（现代 Linux 推荐）。

九、内核版本过低或不兼容

现象：Docker 启动失败，日志提示 kernel too old 或 missing cgroup。

解决方法：

• 检查内核版本：

  uname -r

• 更新系统内核（尤其老版本 CentOS 6/7）：

  sudo yum update kernel

• 确保内核支持必要的特性（如 cgroups、namespace）。

十、京东云安全组或网络策略限制

现象：容器能运行但外部无法访问服务。

解决方法：

• 登录京东云控制台，检查实例的安全组规则。
• 确保开放了所需端口（如 80、443、8080 等）。
• 确认云主机公网 IP 已绑定且 EIP 正常。

总结：排查步骤建议

1. systemctl status docker → 检查服务状态
2. journalctl -u docker → 查看详细日志
3. docker info → 查看 Docker 系统信息
4. df -h 和 free -h → 检查资源
5. ping registry-1.docker.io → 检查网络
6. 检查安全组和防火墙配置

如提供具体错误日志，可进一步精准诊断。