20a4e41872
新增 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)
|
|
}
|