自托管后端概览

六套开源支持 API：用途、默认地址与 GitHub 仓库

​

用途

普通用户可以继续用官方 Fly.io 实例。本专题给进阶用户：查源码、本地联调，或把探索 / 周刊 / 分享流量接到自己的实例。Direct 许可证 / 支付后端不在「设置 → 服务」里。

设置 → 服务：六张后端卡片（URL 仍为官方默认）

截图待补充 · images/screenshots/self-hosting/overview.webp

​

服务一览

服务	用途（App 内）	默认生产地址	本地默认端口	GitHub
Trending	探索 → 趋势	https://starcat-trending-api.fly.dev	5002	starcat-trending-api
Weekly	探索 → 周刊	https://starcat-weekly-api.fly.dev	5003	starcat-weekly-api
Discovery	探索 → 发现 / 热门 / 新发布	https://starcat-discovery-api.fly.dev	5006	starcat-discovery-api
Wiki	Wiki / 外部文档索引探测	https://starcat-wiki-api.fly.dev	5004	starcat-wiki-api
Recommend	相似仓库推荐	https://starcat-recommend-api.fly.dev	5005	starcat-recommend-api
Sharing	AI 分享页 / 短链	https://starcat-sharing-api.fly.dev	5001	starcat-sharing-api

Direct 许可证 / 支付相关后端不在「设置 → 服务」里配置，也不在本专题范围内。

​

鉴权约定

• 业务与探测接口：/api/v1/* 需要 Authorization: Bearer <API_KEY>
• 进程存活：GET /healthz 无鉴权（状态栏可用性）
• 设置页「测试连接」：GET /api/v1/ping（校验地址 + Key + 服务身份）

Key 格式一般为 sk-starcat- + 32 位字符；可用各仓库 README 或 monorepo 脚本 supports/scripts/gen-api-key.sh 生成。

​

下一步

1. 自部署：本地运行或 Fly.io
2. 在 Starcat 中配置：设置 → 服务

相关产品能力：探索概览、周刊、趋势、分享卡。