mirror of
https://github.com/MengMengCode/CLICD.git
synced 2026-08-05 05:36:07 +08:00
MengMengCode
47 lines
1.1 KiB
Markdown
47 lines
1.1 KiB
Markdown
# 故障排查
|
|
|
|
## 服务无法访问
|
|
|
|
检查服务状态：
|
|
|
|
```bash
|
|
systemctl status clicd
|
|
journalctl -u clicd -n 100 --no-pager
|
|
```
|
|
|
|
检查端口监听：
|
|
|
|
```bash
|
|
ss -lntp | grep 8999
|
|
```
|
|
|
|
如果使用反向代理，请同时检查代理日志和上游地址。
|
|
|
|
## 镜像下载失败
|
|
|
|
- 确认宿主机可以访问镜像源和 GitHub Release。
|
|
- 检查磁盘空间。
|
|
- 在任务队列里查看失败原因。
|
|
- 如下载卡住，可尝试取消任务后重新下载。
|
|
|
|
## 容器无法联网
|
|
|
|
- 检查宿主机 NAT 和转发规则。
|
|
- 检查容器 IP 是否分配成功。
|
|
- 检查防火墙是否拦截转发流量。
|
|
- IPv6 场景下确认上游已经把地址段路由到宿主机。
|
|
|
|
## WebSSH 或 WebVNC 连接失败
|
|
|
|
- 确认容器或虚拟机正在运行。
|
|
- WebSSH 需要容器内 SSH 服务可用。
|
|
- WebVNC 需要 KVM 控制台可访问。
|
|
- 票据有效期很短，过期后重新创建即可。
|
|
|
|
## API 返回未授权
|
|
|
|
- 确认 API Key 没有被禁用。
|
|
- 确认请求头使用 `X-API-Key` 或 `Authorization: Bearer`。
|
|
- 确认密钥权限范围覆盖目标接口。
|
|
- 不要把面板登录密码当作 API Key 使用。
|