新增 admin「渠道监控」模块(参考 BingZi-233/check-cx),独立于现有 Channel 体系。
admin 配置 + 后台定时调用上游 LLM chat completions 健康检查 + 所有登录用户只读可见。
后端:
- ent: channel_monitor + channel_monitor_history(AES-256-GCM 加密 api_key)
- service 按职责拆分:service/aggregator/validate/checker/runner/ssrf
- provider strategy map 替代 switch(openai/anthropic/gemini)
- repository batch 聚合(ListLatestForMonitorIDs + ComputeAvailabilityForMonitors)消除 N+1
- runner: ticker(5s) + pond worker pool(5) + inFlight 防并发 + TrySubmit 防雪崩
+ 凌晨 3 点 cron 清理 30 天历史
- SSRF 防护:强制 https + 私网/loopback/云元数据 IP 拒绝(127/8、10/8、172.16/12、
192.168/16、169.254/16、100.64/10、::1、fc00::/7、fe80::/10)+ DialContext
在 socket 层防 DNS rebinding
- API key sanitize:擦除 url.Error 与上游响应 body 中的 sk-/sk-ant-/AIza/JWT 模式
- APIKeyDecryptFailed 标志位 + 单 monitor 路径检测,避免空 key 调用上游
handler:
- admin: CRUD + 手动触发 + 历史接口(api_key 脱敏)
- user: 只读列表 + 状态详情(去除 api_key/endpoint)
- ParseChannelMonitorID 共用 + dto.ChannelMonitorExtraModelStatus 共用
前端:
- 路由 /admin/channels/{pricing,monitor} + /monitor(用户只读)
- AppSidebar 父项 expandOnly 支持
- ChannelMonitorView 拆为 8 个子组件 + ChannelStatusView 拆出 detail dialog
- composables/useChannelMonitorFormat + constants/channelMonitor 共享
- i18n monitorCommon namespace 消除 admin/user 两 view 重复
合规:所有文件符合 CLAUDE.md(Go ≤ 500 行 / Vue ≤ 300 行 / 函数 ≤ 30 行)
CI: go build / gofmt / golangci-lint(0 issues) / make test-unit / pnpm build 全绿
193 lines
6.0 KiB
Go
193 lines
6.0 KiB
Go
package repository
|
||
|
||
import (
|
||
"database/sql"
|
||
"errors"
|
||
|
||
entsql "entgo.io/ent/dialect/sql"
|
||
"github.com/Wei-Shaw/sub2api/ent"
|
||
"github.com/Wei-Shaw/sub2api/internal/config"
|
||
"github.com/Wei-Shaw/sub2api/internal/service"
|
||
"github.com/google/wire"
|
||
"github.com/redis/go-redis/v9"
|
||
)
|
||
|
||
// ProvideConcurrencyCache 创建并发控制缓存,从配置读取 TTL 参数
|
||
// 性能优化:TTL 可配置,支持长时间运行的 LLM 请求场景
|
||
func ProvideConcurrencyCache(rdb *redis.Client, cfg *config.Config) service.ConcurrencyCache {
|
||
waitTTLSeconds := int(cfg.Gateway.Scheduling.StickySessionWaitTimeout.Seconds())
|
||
if cfg.Gateway.Scheduling.FallbackWaitTimeout > cfg.Gateway.Scheduling.StickySessionWaitTimeout {
|
||
waitTTLSeconds = int(cfg.Gateway.Scheduling.FallbackWaitTimeout.Seconds())
|
||
}
|
||
if waitTTLSeconds <= 0 {
|
||
waitTTLSeconds = cfg.Gateway.ConcurrencySlotTTLMinutes * 60
|
||
}
|
||
return NewConcurrencyCache(rdb, cfg.Gateway.ConcurrencySlotTTLMinutes, waitTTLSeconds)
|
||
}
|
||
|
||
// ProvideGitHubReleaseClient 创建 GitHub Release 客户端
|
||
// 从配置中读取代理设置,支持国内服务器通过代理访问 GitHub
|
||
func ProvideGitHubReleaseClient(cfg *config.Config) service.GitHubReleaseClient {
|
||
return NewGitHubReleaseClient(cfg.Update.ProxyURL, cfg.Security.ProxyFallback.AllowDirectOnError)
|
||
}
|
||
|
||
// ProvidePricingRemoteClient 创建定价数据远程客户端
|
||
// 从配置中读取代理设置,支持国内服务器通过代理访问 GitHub 上的定价数据
|
||
func ProvidePricingRemoteClient(cfg *config.Config) service.PricingRemoteClient {
|
||
return NewPricingRemoteClient(cfg.Update.ProxyURL, cfg.Security.ProxyFallback.AllowDirectOnError)
|
||
}
|
||
|
||
// ProvideSessionLimitCache 创建会话限制缓存
|
||
// 用于 Anthropic OAuth/SetupToken 账号的并发会话数量控制
|
||
func ProvideSessionLimitCache(rdb *redis.Client, cfg *config.Config) service.SessionLimitCache {
|
||
defaultIdleTimeoutMinutes := 5 // 默认 5 分钟空闲超时
|
||
if cfg != nil && cfg.Gateway.SessionIdleTimeoutMinutes > 0 {
|
||
defaultIdleTimeoutMinutes = cfg.Gateway.SessionIdleTimeoutMinutes
|
||
}
|
||
return NewSessionLimitCache(rdb, defaultIdleTimeoutMinutes)
|
||
}
|
||
|
||
// ProvideSchedulerCache 创建调度快照缓存,并注入快照分块参数。
|
||
func ProvideSchedulerCache(rdb *redis.Client, cfg *config.Config) service.SchedulerCache {
|
||
mgetChunkSize := defaultSchedulerSnapshotMGetChunkSize
|
||
writeChunkSize := defaultSchedulerSnapshotWriteChunkSize
|
||
if cfg != nil {
|
||
if cfg.Gateway.Scheduling.SnapshotMGetChunkSize > 0 {
|
||
mgetChunkSize = cfg.Gateway.Scheduling.SnapshotMGetChunkSize
|
||
}
|
||
if cfg.Gateway.Scheduling.SnapshotWriteChunkSize > 0 {
|
||
writeChunkSize = cfg.Gateway.Scheduling.SnapshotWriteChunkSize
|
||
}
|
||
}
|
||
return newSchedulerCacheWithChunkSizes(rdb, mgetChunkSize, writeChunkSize)
|
||
}
|
||
|
||
// ProviderSet is the Wire provider set for all repositories
|
||
var ProviderSet = wire.NewSet(
|
||
NewUserRepository,
|
||
NewAPIKeyRepository,
|
||
NewGroupRepository,
|
||
NewAccountRepository,
|
||
NewScheduledTestPlanRepository, // 定时测试计划仓储
|
||
NewScheduledTestResultRepository, // 定时测试结果仓储
|
||
NewProxyRepository,
|
||
NewRedeemCodeRepository,
|
||
NewPromoCodeRepository,
|
||
NewAnnouncementRepository,
|
||
NewAnnouncementReadRepository,
|
||
NewUsageLogRepository,
|
||
NewUsageBillingRepository,
|
||
NewIdempotencyRepository,
|
||
NewUsageCleanupRepository,
|
||
NewDashboardAggregationRepository,
|
||
NewSettingRepository,
|
||
NewOpsRepository,
|
||
NewUserSubscriptionRepository,
|
||
NewUserAttributeDefinitionRepository,
|
||
NewUserAttributeValueRepository,
|
||
NewUserGroupRateRepository,
|
||
NewErrorPassthroughRepository,
|
||
NewTLSFingerprintProfileRepository,
|
||
NewChannelRepository,
|
||
NewChannelMonitorRepository,
|
||
|
||
// Cache implementations
|
||
NewGatewayCache,
|
||
NewBillingCache,
|
||
NewAPIKeyCache,
|
||
NewTempUnschedCache,
|
||
NewTimeoutCounterCache,
|
||
NewInternal500CounterCache,
|
||
ProvideConcurrencyCache,
|
||
ProvideSessionLimitCache,
|
||
NewRPMCache,
|
||
NewUserMsgQueueCache,
|
||
NewDashboardCache,
|
||
NewEmailCache,
|
||
NewIdentityCache,
|
||
NewRedeemCache,
|
||
NewUpdateCache,
|
||
NewGeminiTokenCache,
|
||
ProvideSchedulerCache,
|
||
NewSchedulerOutboxRepository,
|
||
NewProxyLatencyCache,
|
||
NewTotpCache,
|
||
NewRefreshTokenCache,
|
||
NewErrorPassthroughCache,
|
||
NewTLSFingerprintProfileCache,
|
||
|
||
// Encryptors
|
||
NewAESEncryptor,
|
||
|
||
// Backup infrastructure
|
||
NewPgDumper,
|
||
NewS3BackupStoreFactory,
|
||
|
||
// HTTP service ports (DI Strategy A: return interface directly)
|
||
NewTurnstileVerifier,
|
||
ProvidePricingRemoteClient,
|
||
ProvideGitHubReleaseClient,
|
||
NewProxyExitInfoProber,
|
||
NewClaudeUsageFetcher,
|
||
NewClaudeOAuthClient,
|
||
NewHTTPUpstream,
|
||
NewOpenAIOAuthClient,
|
||
NewGeminiOAuthClient,
|
||
NewGeminiCliCodeAssistClient,
|
||
NewGeminiDriveClient,
|
||
|
||
ProvideEnt,
|
||
ProvideSQLDB,
|
||
ProvideRedis,
|
||
)
|
||
|
||
// ProvideEnt 为依赖注入提供 Ent 客户端。
|
||
//
|
||
// 该函数是 InitEnt 的包装器,符合 Wire 的依赖提供函数签名要求。
|
||
// Wire 会在编译时分析依赖关系,自动生成初始化代码。
|
||
//
|
||
// 依赖:config.Config
|
||
// 提供:*ent.Client
|
||
func ProvideEnt(cfg *config.Config) (*ent.Client, error) {
|
||
client, _, err := InitEnt(cfg)
|
||
return client, err
|
||
}
|
||
|
||
// ProvideSQLDB 从 Ent 客户端提取底层的 *sql.DB 连接。
|
||
//
|
||
// 某些 Repository 需要直接执行原生 SQL(如复杂的批量更新、聚合查询),
|
||
// 此时需要访问底层的 sql.DB 而不是通过 Ent ORM。
|
||
//
|
||
// 设计说明:
|
||
// - Ent 底层使用 sql.DB,通过 Driver 接口可以访问
|
||
// - 这种设计允许在同一事务中混用 Ent 和原生 SQL
|
||
//
|
||
// 依赖:*ent.Client
|
||
// 提供:*sql.DB
|
||
func ProvideSQLDB(client *ent.Client) (*sql.DB, error) {
|
||
if client == nil {
|
||
return nil, errors.New("nil ent client")
|
||
}
|
||
// 从 Ent 客户端获取底层驱动
|
||
drv, ok := client.Driver().(*entsql.Driver)
|
||
if !ok {
|
||
return nil, errors.New("ent driver does not expose *sql.DB")
|
||
}
|
||
// 返回驱动持有的 sql.DB 实例
|
||
return drv.DB(), nil
|
||
}
|
||
|
||
// ProvideRedis 为依赖注入提供 Redis 客户端。
|
||
//
|
||
// Redis 用于:
|
||
// - 分布式锁(如并发控制)
|
||
// - 缓存(如用户会话、API 响应缓存)
|
||
// - 速率限制
|
||
// - 实时统计数据
|
||
//
|
||
// 依赖:config.Config
|
||
// 提供:*redis.Client
|
||
func ProvideRedis(cfg *config.Config) *redis.Client {
|
||
return InitRedis(cfg)
|
||
}
|