答案是分层验证docker二进制存在性、服务状态、socket权限、配置文件语法及底层依赖。先执行which docker和docker --version确认cli可用；再用sudo systemctl status docker检查服务是否active (running)；接着验证/var/run/docker.sock存在且用户属docker组；然后用python3 -m json.tool校验/etc/docker/daemon.json语法；最后排查containerd、磁盘空间、inode及内核oom问题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在运行HermesAgent时收到“Docker未安装或无法启动”的提示，说明HermesAgent在初始化阶段检测到本地缺少Docker运行时环境，或systemd未能成功激活docker.service。该提示通常出现在依赖容器化执行引擎的模块加载过程中，需分层验证Docker二进制存在性、服务状态及权限配置。
一、确认Docker CLI是否可用
Docker命令行工具（docker）必须存在于系统PATH中，且具备可执行权限。若which docker返回空或报错，则表明Docker未安装或未纳入环境路径。
1、在终端中执行which docker并回车。
2、若输出为空或显示docker not found，进入Docker安装流程；若输出类似/usr/bin/docker，继续下一步验证。
3、运行docker --version确认版本信息是否正常输出，预期应显示类似 Docker version 24.0.0 或更高版本。
二、检查Docker服务运行状态
即使docker命令可用，若后台服务未运行，HermesAgent仍会判定为不可用。systemd是主流Linux发行版管理Docker服务的标准方式，需验证其active状态与子进程健康度。
1、执行sudo systemctl status docker查看服务摘要。
2、确认输出中包含active (running)且无红色FAILED标记。
3、若状态为inactive (dead)或failed，立即执行sudo systemctl start docker尝试启动。
4、再次运行status命令，确保所有子服务（如containerd）也处于active状态。
三、验证Docker守护进程监听能力
Docker守护进程需响应本地Unix socket（/var/run/docker.sock）或TCP端口请求。HermesAgent通过socket连接探测其可达性，权限缺失或socket路径错误将导致连接拒绝。
1、执行ls -l /var/run/docker.sock检查socket文件是否存在且可访问。
2、若提示No such file or directory，说明docker服务未真正启动或配置异常。
3、若文件存在但权限为srw-rw---- 1 root docker，当前用户须属于docker组才能读写。
4、运行groups确认当前用户是否在docker组中；若无，执行sudo usermod -aG docker $USER并重新登录终端或执行newgrp docker生效。
四、排查Docker配置文件语法错误
/etc/docker/daemon.json是Docker守护进程的核心配置文件，任意JSON语法错误（如末尾逗号、引号不匹配、非法字段）均会导致服务启动失败，且systemd日志中常仅显示generic error。
1、运行sudo jsonlint -q /etc/docker/daemon.json进行静态校验（如无jsonlint，可使用sudo cat /etc/docker/daemon.json | python3 -m json.tool）。
2、若报错，临时重命名配置文件：sudo mv /etc/docker/daemon.json /etc/docker/daemon.json.bak。
3、执行sudo systemctl daemon-reload && sudo systemctl restart docker。
4、重启后若服务恢复active状态，说明原配置文件存在致命语法缺陷。
五、检查底层依赖服务与资源限制
Docker依赖containerd、iptables、cgroup v2等内核级组件。任一依赖异常或系统资源超限（如内存OOM、磁盘满、inodes耗尽）均会中断服务启动流程，且错误表现常被掩盖为“general failure”。
1、依次检查关键依赖状态：sudo systemctl status containerd、sudo systemctl status networking、sudo systemctl status systemd-cgroups-agent。
2、运行df -h /与df -i /确认根分区磁盘空间与inode未达100%。
3、执行dmesg -T | grep -i "oom\|docker\|cgroup"筛查内核级OOM或cgroup拒绝日志。
4、若发现Out of memory: Kill process docker类记录，需立即释放内存或调整systemd内存限制。
