feat(user-secret): 代理白名单一键添加(极客/青果)并前置默认渠道

- 客户端设置面板新增「白名单」区块:自动获取出口 IP、可手改;加入前先同步未上报的代理配置,避免拿服务端旧 Key 代加
- 后端新增 POST /api/user-secrets/proxy-whitelist:先查后加;极客用套餐 ID+套餐 key,青果用已保存提取链接里的 key,重复添加不报错
- 极客套餐 key 加密存 biz_user_proxy_plan.jikip_plan_key(V181),回读只给掩码;换套餐 ID 时必须重填
- 白名单接口地址走配置(AIIMAGE_USER_SECRET_JIKIP/QINGGUO_WHITE_LIST_*),日志不落 key 与完整 URL
- 贞贞/极客等默认选项前置;catch 棘轮 7 处逐条记名并入基线(含 79b04afd 的 AdminApiGuardFilter 一枚)
This commit is contained in:
2026-10-30 11:05:55 +08:00
parent 79b04afdd9
commit 43ae12f722
30 changed files with 1206 additions and 40 deletions
@@ -82,6 +82,12 @@ AIIMAGE_MODULE_CLEANUP_MODULE_TYPES=DEDUPE,SPLIT,CONVERT,DELETE_BRAND
# 示例:AIIMAGE_USER_SECRET_JIKIP_PLANS=111:222;333:444
# 留空 = 不查余量(巡检会按天 WARN 提示未启用)
AIIMAGE_USER_SECRET_JIKIP_PLANS=
# 客户端「极客 → 加入白名单」代调接口(一般无需改;自建代理时才覆盖)
AIIMAGE_USER_SECRET_JIKIP_WHITE_LIST_CHECK_URL=https://api.jikip.com/whiteList-check
AIIMAGE_USER_SECRET_JIKIP_WHITE_LIST_ADD_URL=https://api.jikip.com/whiteList-addition
# 青果(全球HTTP)白名单接口(Key 取代理提取链接里的 key)
AIIMAGE_USER_SECRET_QINGGUO_WHITE_LIST_CHECK_URL=https://overseas-api.proxy.qg.net/whitelist/query
AIIMAGE_USER_SECRET_QINGGUO_WHITE_LIST_ADD_URL=https://overseas-api.proxy.qg.net/whitelist/add
AIIMAGE_NOTIFICATION_JIKIP_PROBE_ENABLED=true
# 用户级余量巡检(跟随密钥巡检):低于阈值推用户站内通知
AIIMAGE_USER_SECRET_PROXY_BALANCE_CHECK_MAX_ROWS=2000
@@ -578,6 +578,12 @@ aiimage:
# 检测出口代理提取链接:留空=直连;配置后检测优先经代理、失败回退直连
check-proxy-extract-url: ${AIIMAGE_USER_SECRET_CHECK_PROXY_EXTRACT_URL:}
jikip-balance-url: ${AIIMAGE_USER_SECRET_JIKIP_BALANCE_URL:https://api.jikip.com/find-balance}
# 客户端「加入白名单」:按用户自填的套餐 ID + 套餐 key 代调 jikip 白名单接口
jikip-white-list-check-url: ${AIIMAGE_USER_SECRET_JIKIP_WHITE_LIST_CHECK_URL:https://api.jikip.com/whiteList-check}
jikip-white-list-add-url: ${AIIMAGE_USER_SECRET_JIKIP_WHITE_LIST_ADD_URL:https://api.jikip.com/whiteList-addition}
# 青果(全球HTTP)白名单:Key 取用户已保存的代理提取链接里的 key
qingguo-white-list-check-url: ${AIIMAGE_USER_SECRET_QINGGUO_WHITE_LIST_CHECK_URL:https://overseas-api.proxy.qg.net/whitelist/query}
qingguo-white-list-add-url: ${AIIMAGE_USER_SECRET_QINGGUO_WHITE_LIST_ADD_URL:https://overseas-api.proxy.qg.net/whitelist/add}
# 多个套餐/账号:planId:userId;planId:userId(分号或逗号分隔);留空=不查余量
jikip-plans: ${AIIMAGE_USER_SECRET_JIKIP_PLANS:}
# 用户级余量巡检:跟随密钥巡检一起跑(find-balance 免费);低于阈值推该用户站内通知
@@ -0,0 +1,19 @@
-- V181: 用户级 jikip 套餐增加「白名单密钥」(套餐 key)
--
-- 背景(2026-10-30 用户拍板):
-- 极客(jikip) 支持通过白名单 API 给套餐添加调用方出口 IP:
-- https://api.jikip.com/whiteList-check?id=套餐id&ip=...
-- https://api.jikip.com/whiteList-addition?id=套餐id&ip=...&key=套餐key
-- 客户端代理默认走白名单授权(mode=1),用户换网络/公网 IP 变化后需要重新加白,
-- 否则提取代理会被供应商拒绝。让用户在客户端填一次套餐 key,服务端代为调用加白接口。
--
-- 存储口径:
-- 套餐 key 属于凭据,按 biz_user_api_secret 同款 AES 加密后落库(ShopCredentialCryptoService),
-- 接口只回传掩码;计划 ID / 用户 ID 仍明文(只用于查余量,不是凭据)。
--
-- 回滚(手工):
-- ALTER TABLE `biz_user_proxy_plan` DROP COLUMN `jikip_plan_key`;
ALTER TABLE `biz_user_proxy_plan`
ADD COLUMN `jikip_plan_key` VARCHAR(2048) NULL
COMMENT 'jikip 套餐 key 密文(仅用于白名单添加;空=未配置)' AFTER `jikip_user_id`;