Cosmos-Server 容器域名访问故障排查指南

问题现象分析

在一次意外断电后，用户报告无法通过域名访问任何Cosmos-Server管理的容器应用，包括Cosmos自身、Nextcloud和Immich等服务。虽然Docker服务显示正常运行且容器状态正常，但域名解析和访问功能完全失效。

核心错误分析

从日志中可以明确看到关键错误信息："Cannot connect to the Docker daemon at unix:///var/run/docker.sock"。这表明Cosmos-Server容器无法与宿主机的Docker守护进程建立连接。这种连接中断通常由以下几种情况导致：

1. Docker socket文件权限问题
2. 卷挂载配置错误
3. 容器运行权限不足
4. Docker服务未完全启动

详细排查步骤

1. 检查Docker服务状态

首先确认Docker服务是否完全启动并正常运行：

systemctl status docker

确保服务状态为"active (running)"，且没有明显的错误信息。

2. 验证Docker socket权限

检查/var/run/docker.sock文件的权限设置：

ls -la /var/run/docker.sock

正确的权限应为"-rw-rw-rw-"或"-rw-r--r--"，所有者通常是root:docker。

3. 检查容器挂载配置

确认Cosmos-Server容器的docker.sock挂载配置是否正确。在docker-compose.yml或运行命令中应包含类似以下挂载配置：

volumes:
  - /var/run/docker.sock:/var/run/docker.sock

4. 验证容器运行权限

确保容器以root用户或具有足够权限的用户运行。检查容器的用户配置：

docker inspect cosmos-server | grep -i user

5. 检查容器日志

获取Cosmos-Server容器的完整日志：

docker logs cosmos-server

重点关注与Docker连接相关的错误信息。

解决方案

根据上述分析，建议采取以下解决措施：

1. 完全重启Docker服务：

   systemctl restart docker
   

2. 重建Cosmos-Server容器：

   docker-compose down && docker-compose up -d
   

3. 验证网络配置： 检查容器的网络模式是否为"host"或配置了正确的端口映射。

4. 检查防火墙设置： 确保没有防火墙规则阻止容器间的通信。

预防措施

为避免类似问题再次发生，建议：

1. 为服务器配置UPS不间断电源
2. 设置Docker服务为自动恢复模式
3. 定期检查容器健康状况
4. 配置日志监控和告警系统

总结

断电导致的Docker连接问题通常与服务启动顺序或权限配置有关。通过系统地检查Docker服务状态、socket权限和容器配置，大多数情况下可以快速恢复服务。对于生产环境，建议实施预防性措施以确保服务的高可用性。