im0o
c5ac59ecf9
顺序是刻意的。前端一行测试都没有，直接挪代码挪坏了 bun test 不会红，所以先把纯逻辑 抽到能被测试的位置并补上用例，最后才动组件。测试从 37 条增加到 77 条。 抽出来的四块： - shared/outbound-chain.ts 「这个端口现在走哪条线」的链路解析，带防环，9 条测试 - web/delay-test.ts 延迟测试失败时说什么，6 个分支原本一条测试都没有 - web/runtime.ts 运行时状态的模块级单例，照 prefs.ts 已有的模式 - web/components/InboundList.vue 入站列表 出站的文本原本散成四份（读一份、显示一份、写回一份、表单又抄一份），加一种出站模式 要同时改四处，漏一个就是显示与写回不一致。合并成 OUTBOUND_PRESETS 一张表。 给认证和透传白名单补了 20 条测试。两者都是安全边界、都是纯函数、都不需要内核在线， 之前却只靠需要活内核的冒烟脚本间接覆盖。其中「形似但不是健康检查的路径」几条确认了 正则没写松。 另外：配置快照不再把整份文件原文下发（前端从不读，白白让响应体积翻倍）； yaml-cosmetics 的测试改走生产路径，之前它自己拼了一遍三步流程，落盘链路漏掉其中一步 测试照样会绿。
255 lines
9.5 KiB
TypeScript
255 lines
9.5 KiB
TypeScript
/**
|
||
* 配置文件的读写，以及改动落盘时的那条保护链路。
|
||
*
|
||
* 这个文件存在的全部理由是一句话：**配置写坏了要能把用户救回来**。
|
||
* 一台跑着 mihomo 的机器，配置一旦被写成内核起不来的样子，用户很可能连
|
||
* SSH 都得绕路才能进去修。所以落盘不是「写文件」这一个动作，而是一串顺序
|
||
* 严格的动作，每一步都要留好退路。
|
||
*
|
||
* 顺序是：
|
||
* 读当前文件 → 检查是否被外部改过 → 生成新内容 → 自己检查一遍
|
||
* → 写到临时文件 → mihomo -t 校验 → 备份原文件 → 写入 → 通知内核重载
|
||
* 最后两步中任何一步出问题，都从备份还原并让内核载回原样。
|
||
*
|
||
* 「自己检查一遍」不能省。实测 v1.19.29：入站的 `proxy:` 指向一个不存在的
|
||
* 出站时，`mihomo -t` 会通过、重载会成功，直到有流量走到那个入站才在日志里
|
||
* 报错。这类错误只有 Patchbay 自己查得出来。
|
||
*/
|
||
import { copyFile, mkdir, readdir, readFile, rm, unlink, writeFile } from 'node:fs/promises'
|
||
import { basename, dirname, join } from 'node:path'
|
||
import {
|
||
openDocument,
|
||
replaceDocumentData,
|
||
validateDocument,
|
||
} from '../vendor/config-editor/index.ts'
|
||
import type { ConfigDiagnostic, ConfigObject } from '../vendor/config-editor/index.ts'
|
||
import { restoreInlineCommentAlignment } from '../shared/yaml-cosmetics.ts'
|
||
import { validateConfigFile, reloadConfig } from './kernel.ts'
|
||
import type { Env } from './env.ts'
|
||
|
||
/** 备份保留的份数。再多没有意义——真要回到很久以前的版本，那是版本控制的活。 */
|
||
const KEEP_BACKUPS = 10
|
||
|
||
export interface ConfigSnapshot {
|
||
/** 解析出来的配置数据 */
|
||
data: ConfigObject
|
||
/**
|
||
* 内容指纹。客户端改完提交时要带上它，服务端据此判断这份改动
|
||
* 是不是基于最新的文件——中途有人 SSH 上去手改过就会对不上。
|
||
*/
|
||
revision: string
|
||
/** 解析和引用检查的结果，含只是提醒的项 */
|
||
diagnostics: ConfigDiagnostic[]
|
||
}
|
||
|
||
export type ApplyOutcome =
|
||
| { ok: true; snapshot: ConfigSnapshot; reloaded: boolean; reloadMessage: string }
|
||
| { ok: false; stage: ApplyFailureStage; message: string; hint: string; restored: boolean }
|
||
|
||
/** 失败发生在哪一步。界面据此决定说什么，而不是把原始错误直接甩给用户。 */
|
||
export type ApplyFailureStage =
|
||
| 'stale' // 文件被外部改过，这份改动的基准已经过时
|
||
| 'self-check' // Patchbay 自己的检查没过
|
||
| 'kernel-check' // mihomo -t 没过
|
||
| 'write' // 写文件失败
|
||
| 'reload' // 文件写进去了，但内核没能重新加载
|
||
|
||
/** 内部用的完整读取，带原文。原文只在生成新内容时需要，不下发给前端。 */
|
||
interface ConfigDocument extends ConfigSnapshot {
|
||
yaml: string
|
||
}
|
||
|
||
async function readDocument(env: Env): Promise<ConfigDocument> {
|
||
const yaml = await readFile(env.configPath, 'utf8')
|
||
const doc = openDocument(yaml)
|
||
return {
|
||
data: doc.data,
|
||
yaml: doc.yaml,
|
||
revision: doc.revision,
|
||
diagnostics: [...doc.diagnostics, ...validateDocument(doc.data)],
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 读当前配置。
|
||
*
|
||
* 不含文件原文：前端从来不读它，带上只会让每次请求的响应体积翻倍。要原文的地方
|
||
* 在这个文件内部，用 readDocument。
|
||
*/
|
||
export async function readConfig(env: Env): Promise<ConfigSnapshot> {
|
||
const { yaml: _yaml, ...snapshot } = await readDocument(env)
|
||
return snapshot
|
||
}
|
||
|
||
/**
|
||
* 把新的配置数据写成 YAML 文本。
|
||
*
|
||
* 单独导出是为了让测试能走**生产用的这一条**路径。之前测试自己拼了
|
||
* 「解析 → 替换 → 还原对齐」三步，于是如果有人在落盘链路里漏掉最后那步，
|
||
* 那些专为守护它而写的测试照样全绿。
|
||
*/
|
||
export function rewriteYaml(currentYaml: string, nextData: ConfigObject): string {
|
||
const rewritten = replaceDocumentData(openDocument(currentYaml), nextData)
|
||
// 把只是丢了对齐空格的行还原成原样，否则没被改动的段落也会出现在 diff 里，见 ORIGIN.md
|
||
return restoreInlineCommentAlignment(currentYaml, rewritten.yaml)
|
||
}
|
||
|
||
/**
|
||
* 把一份新的配置数据落盘。
|
||
*
|
||
* `baseRevision` 是客户端读到这份配置时拿到的指纹。传 undefined 表示
|
||
* 「不管别人改没改，以我为准」，仅用于还原备份这类明确要覆盖的场景。
|
||
*/
|
||
export async function applyConfig(
|
||
env: Env,
|
||
nextData: ConfigObject,
|
||
baseRevision?: string,
|
||
): Promise<ApplyOutcome> {
|
||
const current = await readDocument(env)
|
||
|
||
if (baseRevision !== undefined && baseRevision !== current.revision) {
|
||
return {
|
||
ok: false,
|
||
stage: 'stale',
|
||
message: '配置文件在你编辑期间被改动过',
|
||
hint: '刷新页面重新载入当前配置，再把你的改动做一遍。直接覆盖会丢掉别人的改动。',
|
||
restored: false,
|
||
}
|
||
}
|
||
|
||
const nextYaml = rewriteYaml(current.yaml, nextData)
|
||
|
||
// 内容没变就不要走后面那一串——不必要的备份和重载只会制造噪音。
|
||
if (nextYaml === current.yaml) {
|
||
const { yaml: _yaml, ...snapshot } = current
|
||
return { ok: true, snapshot, reloaded: false, reloadMessage: '内容没有变化' }
|
||
}
|
||
|
||
const problems = validateDocument(nextData).filter((d) => d.severity === 'error')
|
||
if (problems.length > 0) {
|
||
return {
|
||
ok: false,
|
||
stage: 'self-check',
|
||
message: problems.map((p) => `${p.path.join('.')}：${p.message}`).join('\n'),
|
||
hint: '这些问题内核未必会拦下来，但会让配置在运行时出错，所以这里先拦住了。',
|
||
restored: false,
|
||
}
|
||
}
|
||
|
||
// 先写到临时文件交给内核校验，别碰真文件。
|
||
const tempPath = join(dirname(env.configPath), `.patchbay-check-${String(Date.now())}.yaml`)
|
||
try {
|
||
await writeFile(tempPath, nextYaml, 'utf8')
|
||
const checked = await validateConfigFile(env, tempPath)
|
||
if (!checked.ok) {
|
||
return {
|
||
ok: false,
|
||
stage: 'kernel-check',
|
||
message: checked.message,
|
||
hint: '内核拒绝了这份配置，真文件一个字节都没动，你可以直接继续改。',
|
||
restored: false,
|
||
}
|
||
}
|
||
} finally {
|
||
await rm(tempPath, { force: true })
|
||
}
|
||
|
||
// 校验过了才动真文件。备份放在写入之前。
|
||
const backupPath = await createBackup(env)
|
||
try {
|
||
await writeFile(env.configPath, nextYaml, 'utf8')
|
||
} catch (error) {
|
||
return {
|
||
ok: false,
|
||
stage: 'write',
|
||
message: String(error),
|
||
hint: '文件没能写进去，配置还是原来的样子。检查一下这个进程对配置文件有没有写权限。',
|
||
restored: false,
|
||
}
|
||
}
|
||
|
||
const reloaded = await reloadConfig(env, env.configPath)
|
||
if (!reloaded.ok) {
|
||
// 文件已经写进去了但内核没接受。把文件还原，再让内核载回原样，
|
||
// 避免留下「文件是新的、内核跑的是旧的」这种最难排查的状态。
|
||
let restored = false
|
||
try {
|
||
await copyFile(backupPath, env.configPath)
|
||
await reloadConfig(env, env.configPath)
|
||
restored = true
|
||
} catch {
|
||
restored = false
|
||
}
|
||
return {
|
||
ok: false,
|
||
stage: 'reload',
|
||
message: reloaded.message,
|
||
hint: restored
|
||
? '已经把配置还原成改动前的样子，内核也载回去了。改动没有生效。'
|
||
: `还原也失败了。改动前的配置留在 ${backupPath}，需要手动拷回 ${env.configPath}。`,
|
||
restored,
|
||
}
|
||
}
|
||
|
||
await pruneBackups(env)
|
||
return {
|
||
ok: true,
|
||
snapshot: await readConfig(env),
|
||
reloaded: true,
|
||
reloadMessage: '',
|
||
}
|
||
}
|
||
|
||
/** 备份文件名形如 `config.yaml.bak-20260810-024900`。 */
|
||
function backupName(configPath: string, at: Date): string {
|
||
const p = (n: number, w = 2) => String(n).padStart(w, '0')
|
||
const stamp =
|
||
`${String(at.getFullYear())}${p(at.getMonth() + 1)}${p(at.getDate())}` +
|
||
`-${p(at.getHours())}${p(at.getMinutes())}${p(at.getSeconds())}`
|
||
return `${basename(configPath)}.bak-${stamp}`
|
||
}
|
||
|
||
async function backupDir(env: Env): Promise<string> {
|
||
const dir = join(dirname(env.configPath), '.patchbay-backups')
|
||
await mkdir(dir, { recursive: true })
|
||
return dir
|
||
}
|
||
|
||
async function createBackup(env: Env): Promise<string> {
|
||
const dir = await backupDir(env)
|
||
const path = join(dir, backupName(env.configPath, new Date()))
|
||
await copyFile(env.configPath, path)
|
||
return path
|
||
}
|
||
|
||
/** 备份文件按名字排序就是按时间排序，因为时间戳是定长的。 */
|
||
export async function listBackups(env: Env): Promise<string[]> {
|
||
const dir = await backupDir(env)
|
||
const prefix = `${basename(env.configPath)}.bak-`
|
||
const entries = await readdir(dir)
|
||
return entries.filter((name) => name.startsWith(prefix)).sort().reverse()
|
||
}
|
||
|
||
async function pruneBackups(env: Env): Promise<void> {
|
||
const dir = await backupDir(env)
|
||
const stale = (await listBackups(env)).slice(KEEP_BACKUPS)
|
||
await Promise.all(stale.map((name) => unlink(join(dir, name)).catch(() => {})))
|
||
}
|
||
|
||
/** 把某个备份恢复成当前配置。走的是和普通改动同一条保护链路。 */
|
||
export async function restoreBackup(env: Env, name: string): Promise<ApplyOutcome> {
|
||
const dir = await backupDir(env)
|
||
// 只接受 listBackups 列出来的名字，避免有人拿路径穿越读到别的文件。
|
||
if (!(await listBackups(env)).includes(name)) {
|
||
return {
|
||
ok: false,
|
||
stage: 'self-check',
|
||
message: `没有这个备份：${name}`,
|
||
hint: '刷新一下备份列表再试。',
|
||
restored: false,
|
||
}
|
||
}
|
||
const yaml = await readFile(join(dir, name), 'utf8')
|
||
return applyConfig(env, openDocument(yaml).data)
|
||
}
|