new-api-custom/CUSTOMIZATION.md

自定义版本说明

当前版本为 v1.0.0-rc.38-custom.43-20260926，基于官方 v1.0.0-rc.38，对应 2026-09-26 已部署的自定义源码。

主要定制

• 固定令牌支持有序分组池、备用分组、可重试错误切换及分组可用性判断；按实际命中的分组计费和记录日志。
• 支持分组动态计费表达式、请求明细、路由过程及逐次请求结算。
• 用户侧隐藏上游错误细节；客户端断开与真实上游故障分别处理。
• Astra 模型指纹抽检、响应模型守卫、鹈鹕检测及检测费用结算。
• 独立公开 uptime 页，使用 shadcn/ui，支持分组别名、隐藏分组和管理员重置当前分组检测记录。
• 主站 /group-status 使用真实分组名并展示全部分组，检测请求使用真实分组标识；独立 uptime 页应用公开展示配置。
• 渠道每 15 分钟探活，展示最近 18 次记录；正常用户请求可恢复分组正常状态。
• 两页共用分组行布局，正常状态优先，同类状态中支持 Astra 的分组排在前面，其他分组使用紧凑布局；鹈鹕样例按时间倒序横向滚动，最新在左，点击缩略图预览。
• 鹈鹕检测通过 manxue.ai 访客接口请求公开作品，保存可跳转的作品链接；连接失败时本地生成并标记为不确定。
• 作品脚本在隔离 iframe 中运行，以保留腿部、踏板等动画绘制；缩略图按容器宽度等比缩放。

从源码构建

docker build -f Dockerfile.local-release -t local/new-api:v1.0.0-rc.38-custom.43-20260926 .

此入口从 Bun、Go 和 Debian 基础镜像构建前端与服务，不要求预先存在旧版 local/new-api 镜像。VERSION 用于编译版本号；Compose 如果设置了 VERSION 环境变量，也应同步更新。

其他 Dockerfile.* 和 build-fingerprint-backend.sh 保留为历史构建参考。部分增量构建文件依赖服务器上的旧版镜像或已编译二进制，新环境请使用 Dockerfile.local-release。

运行与升级

使用现有外部 PostgreSQL 和 Valkey，连接信息通过部署环境提供。仓库不包含生产凭据、数据库内容或线上 Compose 配置。

升级前备份数据库及 Compose 配置，部署后检查容器健康、版本号、主站分组状态和公开 uptime 页面。Uptime Kuma 的停用与域名反向代理属于部署配置，不会仅因替换应用镜像自动完成。

公开作品链接受 manxue.ai 的保留期限约束；没有公开链接的历史作品继续使用本站预览。