Drone.io 容器日志查看与调试指南

drone.io 以 docker 容器方式运行时，其日志默认不落盘到系统 `/var/log/`，而是由 docker 引擎托管；可通过 `docker logs` 命令实时查看容器输出，快速定位如登录失败（http 400）、oauth 回调异常等运行时问题。

Drone.io 在标准部署中通常以单容器（或配合数据库容器）形式运行，所有运行时日志（包括 HTTP 请求、认证流程、GitHub OAuth 回调解析、数据库连接状态等）均直接输出到容器的标准输出（stdout/stderr），而非写入宿主机文件系统。因此，在 /var/log/ 下搜索 drone 文件必然为空——这是设计使然，而非配置遗漏。

✅ 正确查看 Drone 日志的步骤

1. 确认 Drone 容器正在运行：

   docker ps -a | grep drone

   输出示例：

   a1b2c3d4e5f6   drone/drone:2.22.0   "/bin/drone-server"   2 hours ago   Up 2 hours   0.0.0.0:8080->80/tcp   drone-server

2. 实时跟踪日志（推荐调试时使用）：

   docker logs -f a1b2c3d4e5f6

   -f 参数实现“follow”模式，类似 tail -f，可即时捕获登录请求、OAuth 重定向、state 校验失败、code 解析异常等关键线索。

3. 查看最近 100 行历史日志（排查已发生的 400 错误）：

   docker logs --tail 100 a1b2c3d4e5f6

⚠️ 常见问题与日志线索提示

• 若出现 HTTP 400 Bad Request 且重定向 URL 中含 ?code=...&state=...，日志中通常会明确打印：
  • failed to exchange oauth code: invalid_client → GitHub OAuth App 的 client_id 或 client_secret 配置错误；
  • invalid state parameter → DRONE_SECRET 不一致或会话丢失（常见于多实例未共享 secret）；
  • database connection failed → 数据库服务不可达或凭据错误；
  • no such file or directory → .drone.yml 解析失败或挂载路径错误（若使用 volume 挂载配置）。

? 提示：启动容器时建议始终添加 --log-driver=json-file --log-opt max-size=10m --log-opt max-file=3（Docker 默认即为 json-file），确保日志可被 docker logs 可靠读取；避免使用 none 或 syslog 等非标准驱动导致日志不可见。

? 进阶调试建议

• 启动容器时启用调试日志级别（v2+ 版本支持）：

  docker run -d \
    --env DRONE_LOGS_DEBUG=true \
    --env DRONE_LOGS_TRACE=true \
    ...
    drone/drone:2.22.0

• 若使用 docker-compose.yml，可在 services.drone-server.logging 下统一配置日志行为；
• 对于生产环境，建议将 Docker 日志对接 ELK、Loki 或云日志服务，实现集中化检索与告警。

通过 docker logs 直接观测容器输出，是 Drone 故障诊断的第一道也是最高效的入口——它绕过了传统守护进程的日志抽象层，让你直面真实运行上下文。