收集诊断信息
快速检查
先记录时间、操作、受影响的应用或域名、预期结果、实际结果以及错误信息。
在 Swarm manager 节点运行:
docker service ls
docker service ps captain-captain --no-trunc
docker service logs captain-captain --tail 100
根据故障类型检查:
- **应用:**通过
docker service ls查找 service。旧版应用可能使用srv-captain--APP_NAME名称。继续执行docker service ps SERVICE_NAME和docker service logs SERVICE_NAME。 - **网络:**检查 DNS,并分别测试 HTTP 与 HTTPS。
- **存储:**检查挂载、磁盘空间和任务所在节点。
收集完整服务器报告
如果 dashboard 无法访问、多个服务发生故障或快速检查没有明确结果,可以运行诊断收集脚本。在使用 systemd 的 Debian/Ubuntu Swarm manager 上执行:
curl -fL https://raw.githubusercontent.com/caprover/caprover-website/master/scripts/caprover-diagnostic.sh -o caprover-diagnostic.sh
less caprover-diagnostic.sh
sudo sh ./caprover-diagnostic.sh
输出文件:/tmp/caprover-diagnostic.*.txt,仅文件所有者可访问。
检查项目包括:
- 80/443/3000 端口的占用进程、宿主机 Web 服务和本地 HTTP 响应。
- Docker/Swarm service、任务错误、配置和日志。
/captain挂载及权限、网络、防火墙、内核及 Docker daemon 错误。- 软件包安装历史和可用的容器 runtime。
脚本会尝试短暂运行本地 hello-world 和 nginx:1.27.2 镜像,前提是镜像已经存在。它不会拉取镜像,也不会修改 CapRover service 配置。
**先阅读报告摘要。**例如:
- **80/443 端口已被其他进程占用:**可能导致 CapRover NGINX 无法绑定端口。
- **Swarm 任务被拒绝:**查看任务错误原因。
- **
/captain挂载缺失:**检查宿主机路径和挂载状态。 - **Docker API 警告:**结合其他证据判断。在 issue #2377 中,原因是宿主机 NGINX 占用了 80 端口。
分享报告前
- 检查整个报告并清除密码、token、用户隐私数据、应用名称以及能够识别服务器的信息。
- 诊断脚本不会收集 Docker 环境变量和 CapRover 配置正文,但日志、命令参数和软件包历史仍可能包含敏感信息。
- 仅分享经过脱敏且与问题有关的部分。
针对性恢复步骤参阅服务器诊断。
重启或检查服务
docker service update captain-captain --force # Restart CapRover
docker service update SERVICE_NAME --force # Restart an app
docker service logs SERVICE_NAME --since 10m
请在 Swarm manager 节点执行 Docker 命令。通过 docker service ls 获取实际 service 名称。如果需要进入应用容器,应在运行该任务的节点上执行 docker exec(见下文)。
故障诊断
从失败的请求或应用入手,记录时间和准确的错误信息。在 dashboard 中查看应用部署历史和日志。在 manager 节点运行:
docker service ls
docker service ps captain-captain --no-trunc
docker service logs captain-captain --tail 100
docker system df
- 通过
docker service ls找到应用 service,再运行docker service ps SERVICE_NAME --no-trunc和docker service logs SERVICE_NAME --tail 100。 - 新版应用通常以应用名作为 service 名称;旧版应用可能使用
srv-captain--APP_NAME。 - 对 DNS 或 HTTPS 问题,检查解析记录、端口可达性和域名证书状态。
- 多节点故障应检查节点可用性和私有网络连接。
- 分享日志前删除密码、token 和其他敏感数据。
- 更多按症状分类的指南参阅故障排查。
如果多个系统服务同时故障,或宿主机问题不明确,请在 manager 上收集完整报告。
无法通过 3000 端口访问 dashboard
- 在 manager 上执行
docker service ps captain-captain --no-trunc,再查看docker service logs captain-captain --since 60m和docker service logs captain-nginx --since 60m。 - 在 manager 上测试
curl -v http://127.0.0.1:3000/。 - 如果本地请求成功但公网 IP 无法访问,请检查云服务商和宿主机防火墙,以及端口映射。
- 如果 CapRover service 一直重启,先查看任务错误和日志,再调整网络。
- 修复根因后,可执行
docker service update captain-captain --force强制重启。
重启或检查应用
- 在 dashboard 中保存应用配置,可以触发 service update。
- 如果需要进入运行中的容器,先通过
docker service ls找到 service 名称,再用docker service ps SERVICE_NAME确认所在节点,然后在该节点运行:
docker ps --filter label=com.docker.swarm.service.name=SERVICE_NAME
docker exec -it CONTAINER_ID /bin/sh
将 SERVICE_NAME 和 CONTAINER_ID 替换为实际值。部分镜像没有 /bin/bash,但通常包含 /bin/sh。容器 shell 可能访问应用数据和 secrets,请谨慎使用。