订阅健康检查默认开启,编辑支持改名

内核没有默认的健康检查地址,url 为空时检查根本不会运行
(adapter/provider/healthcheck.go:196-199),所以默认值必须写全;
开关只翻 enable,手写的 url/interval 留着下次开启时还用。
改名和策略组 use: 的引用同步收在同一次变换里,链式副本由保存
链路的 syncGenerated 按新名字重建,缓存路径刻意不动——file 类型
的数据本体和副本认亲都靠它。
This commit is contained in:
2026-08-12 17:30:07 +08:00
parent b28fc572f7
commit d6942c5702
6 changed files with 237 additions and 49 deletions
+79 -3
View File
@@ -6,8 +6,8 @@
* 这个模块只操作用户订阅;副本的增删由 `inbound-groups.ts` 的 applySetup/pruneGenerated 负责,
* 写配置的链路(页面里的 commit)每次都会跑它们,所以这里改完不用补同步。
*
* 订阅不提供改名:名字被策略组的 `use:` 和生成的副本引用,改名等于改一个被引用的
* 标识符,要同步更新所有引用,漏一处就是断引用。删了重建更简单。
* 改名必须走 renameSubscription:名字被策略组的 `use:` 和生成的副本引用,改名和
* 同步引用要在同一次变换里完成,散开做漏一处就是断引用。
*/
import type { ConfigObject } from '../vendor/config-editor/index.ts'
import { isGenerated, providerCachePath } from './inbound-groups.ts'
@@ -15,6 +15,19 @@ import { isGenerated, providerCachePath } from './inbound-groups.ts'
/** 新增订阅时的默认更新间隔,秒。一天一次。 */
export const DEFAULT_INTERVAL = 86400
/**
* 新增订阅或开启健康检查时写入的默认值。
*
* `url` 必须写:内核没有默认检查地址,为空时 interval 被强制归零、检查不会运行
* (内核源码 adapter/provider/healthcheck.go:196-199)。`interval` 与内核在
* enable 时的默认一致(adapter/provider/parser.go:66-68),写死一个更稳。
*/
export const DEFAULT_HEALTH_CHECK = {
enable: true,
url: 'https://www.gstatic.com/generate_204',
interval: 300,
}
/** 一个用户订阅在界面上的样子。只读配置文件的 `proxy-providers` 段(决策记录 0004)。 */
export interface Subscription {
name: string
@@ -104,6 +117,7 @@ export function addSubscription(
url,
path: providerCachePath(name),
...(interval !== null ? { interval } : {}),
'health-check': { ...DEFAULT_HEALTH_CHECK },
},
}
return next
@@ -137,7 +151,11 @@ export function addFileSubscription(data: ConfigObject, name: string): ConfigObj
const next = { ...data }
next['proxy-providers'] = {
...providersOf(data),
[name]: { type: 'file', path: providerCachePath(name) },
[name]: {
type: 'file',
path: providerCachePath(name),
'health-check': { ...DEFAULT_HEALTH_CHECK },
},
}
return next
}
@@ -162,6 +180,64 @@ export function updateSubscription(
return next
}
/**
* 开关一个订阅的健康检查。
*
* 关闭写 `enable: false` 而不是删掉整个键:用户手写的 url/interval 要留着,
* 下次开启时还用它们。开启时缺的字段用默认值补齐——url 不能缺,内核没有默认
* 检查地址(见 DEFAULT_HEALTH_CHECK 的注)。
*/
export function setSubscriptionHealthCheck(
data: ConfigObject,
name: string,
enable: boolean,
): ConfigObject {
const entry = providersOf(data)[name]
if (!isPlainObject(entry)) return data
const existing = isPlainObject(entry['health-check']) ? entry['health-check'] : null
// 本来就没写又要关闭,不必写一个 enable: false 的完整声明进去
if (!enable && existing === null) return data
const next = { ...data }
next['proxy-providers'] = {
...providersOf(data),
[name]: { ...entry, 'health-check': { ...DEFAULT_HEALTH_CHECK, ...existing, enable } },
}
return next
}
/**
* 改订阅的名字,并同步所有策略组 `use:` 里的引用。
*
* 缓存路径 `path` 保持不变:file 类型的数据本体就在旧路径上,链式代理的副本靠
* 「和原订阅同一个 path」认来源(见 inbound-groups.ts),路径一动这两件事都得另做迁移。
* 生成的副本这里不碰:写配置的链路每次都跑 syncGenerated/pruneGenerated,
* 会按新名字重建副本、清掉旧的。
*/
export function renameSubscription(
data: ConfigObject,
oldName: string,
newName: string,
): ConfigObject {
const providers = providersOf(data)
if (oldName === newName || !(oldName in providers) || newName in providers) return data
const next = { ...data }
// 逐项重建以保住条目在映射里的位置,diff 才不会把整段重排
next['proxy-providers'] = Object.fromEntries(
Object.entries(providers).map(([name, entry]) => [name === oldName ? newName : name, entry]),
)
if (Array.isArray(data['proxy-groups'])) {
next['proxy-groups'] = data['proxy-groups'].map((group) => {
if (!isPlainObject(group) || !Array.isArray(group.use)) return group
if (!group.use.includes(oldName)) return group
return { ...group, use: group.use.map((item) => (item === oldName ? newName : item)) }
})
}
return next
}
/** 删除一个订阅。删到最后一个时把整个键去掉,不在文件里留空映射。 */
export function removeSubscription(data: ConfigObject, name: string): ConfigObject {
const providers = { ...providersOf(data) }