Web & API · ProWeb 与 API · Pro
The official dashboard and full REST operations surface are included with every CertHub Pro tier.官方 Web 控制台与完整 REST 操作面包含在所有 CertHub Pro 档位中。
http://localhost:8080 · REST
edition boundary版本边界Future Community distributions keep CLI + YAML and the public
/health endpoint, without the official dashboard or full REST API. Historical MIT releases that already contain Web keep their granted rights.未来 Community 发行版保留 CLI、YAML 与公开的 /health,不包含官方控制台和完整 REST API。历史 MIT 版本中已经发布的 Web 代码仍保留既有授权。Open the dashboard打开控制台
After installing the Pro Web package, visit http://localhost:8080. Pages: dashboard, certificates, configuration and logs. Manual CDN helper: /manual-domains.html.安装 Pro Web 包后打开 http://localhost:8080。页面包含仪表盘、证书、配置和日志;CDN 手动辅助页为 /manual-domains.html。
auth鉴权
Set
CERTHUB_API_TOKEN in .env (see .env.example / SECURITY.md). The :8080 reverse proxy injects the token for the dashboard. External API callers need X-CertHub-Token or Authorization: Bearer. /health stays public. Do not expose :8080 to the public Internet.
在 .env 设 CERTHUB_API_TOKEN(见 .env.example / SECURITY.md)。8080 反代会给控制台注入 token;外部调 API 需带 X-CertHub-Token 或 Authorization: Bearer。/health 仍公开。不要把 :8080 直接暴露到公网。
REST endpointsREST 接口
| Method | Path | Notes说明 |
|---|---|---|
| GET | /api/dashboard | Counts and health summary数量与健康摘要 |
| GET | /api/certificates | List certs证书列表 |
| POST | /api/certificates | Create / issue创建 / 申请 |
| POST | /api/certificates/{domain}/renew | Renew续期 |
| DELETE | /api/certificates/{domain} | Delete删除 |
| GET | /api/certificates/{domain}/download | Download zip下载压缩包 |
| GET | /api/certificates/manual | Manual domain list手动域名列表 |
| GET | /api/certificates/manual/{domain}/download | Manual pack zip手动包 ZIP |
| GET/POST | /api/config/{type} | domains / dns / servers / notification域名 / DNS / 服务器 / 通知 |
| GET | /api/logs/{type} | cert / error / cron logs证书 / 错误 / 定时日志 |
| GET | /api/monitoring | Monitoring snapshot监控快照 |
| GET | /health | Liveness存活检查 |