Files
mihomo-patchbay/server/routes.ts
T
im0o 7a764f5fe1 搭出前端骨架和入站列表
设计基调定为:层次靠底色和一像素描边而不是投影,一屏最多两层容器,间距给足。
tokens.css 顶部写了这三条规则,后面的组件都是它们的推论。

入站列表把两套写法合并成一张表:老式顶层端口字段(mixed-port 这些)和 listeners 数组。
只画 listeners 的话,一台只用 mixed-port 的机器打开会是空板,而那个端口正在跑——
这等于对用户撒谎。合并逻辑在 shared/inbounds.ts,带 10 个测试。

后端顺带能提供打包后的静态文件了,一个进程就能跑起来。
2026-08-10 04:10:17 +08:00

126 lines
5.2 KiB
TypeScript

/**
* HTTP 接口。
*
* 分成三类:
* /api/config* 配置文件的读写,走 config-store 那条保护链路
* /api/kernel/* 内核状态,以及对管理接口的只读透传
* /api/meta/* 静态数据,比如入站类型的字段表
*
* 透传只开放 GET。写操作(切换节点、关连接)属于运行时面板的功能,等做到那一步再单独开,
* 现在不留一个「什么都能转发」的口子。
*/
import listenerFields from '../shared/listener-fields.json' with { type: 'json' }
import { applyConfig, listBackups, readConfig, restoreBackup } from './config-store.ts'
import { kernelVersion, proxyGet } from './kernel.ts'
import { tokenFromRequest, tokenMatches } from './auth.ts'
import type { ConfigObject } from '../vendor/config-editor/index.ts'
import type { Env } from './env.ts'
/** 允许透传的管理接口路径。白名单而不是黑名单——多开一个口子要有意为之。 */
const READABLE_KERNEL_PATHS = new Set([
'/version',
'/configs',
'/proxies',
'/providers/proxies',
'/rules',
'/providers/rules',
'/connections',
'/memory',
])
function json(body: unknown, status = 200): Response {
return new Response(JSON.stringify(body), {
status,
headers: { 'Content-Type': 'application/json; charset=utf-8' },
})
}
/** 把落盘失败的结果翻译成 HTTP 响应。状态码按「谁的问题」分。 */
function applyFailureStatus(stage: string): number {
if (stage === 'stale') return 409 // 冲突,客户端该刷新重来
if (stage === 'self-check' || stage === 'kernel-check') return 422 // 内容不合法
return 500 // write / reload:服务端或内核的问题
}
/** 打包后的前端。开发时前端由 Vite 提供并把 /api 转发过来,走不到这里。 */
const WEB_DIST = new URL('../web-dist/', import.meta.url).pathname.replace(/^\/([A-Za-z]:)/, '$1')
/**
* 静态文件不需要令牌——它们只是一个空壳,所有数据都要带令牌才拿得到。
* 单页应用的路由由前端接管,所以找不到的路径一律回 index.html。
*/
async function serveStatic(path: string): Promise<Response> {
const target = Bun.file(WEB_DIST + (path === '/' ? 'index.html' : path.slice(1)))
if (await target.exists()) return new Response(target)
const shell = Bun.file(`${WEB_DIST}index.html`)
if (await shell.exists()) return new Response(shell)
return new Response('前端还没打包。先运行 bun run build,或者开发时用 bun run dev:web。', {
status: 404,
headers: { 'Content-Type': 'text/plain; charset=utf-8' },
})
}
export function createRouter(env: Env, token: string) {
return async function handle(req: Request): Promise<Response> {
const url = new URL(req.url)
const path = url.pathname
if (!path.startsWith('/api/')) return serveStatic(path)
if (!tokenMatches(token, tokenFromRequest(req))) {
return json({ error: '令牌不对。它在配置文件旁边的 .patchbay-token 里。' }, 401)
}
// ── 配置 ────────────────────────────────────────────
if (path === '/api/config' && req.method === 'GET') {
const snapshot = await readConfig(env)
return json(snapshot)
}
if (path === '/api/config' && req.method === 'PUT') {
const body = (await req.json()) as { data?: ConfigObject; baseRevision?: string }
if (!body.data || typeof body.data !== 'object') {
return json({ error: '请求里没有 data 字段' }, 400)
}
const result = await applyConfig(env, body.data, body.baseRevision)
return result.ok ? json(result) : json(result, applyFailureStatus(result.stage))
}
if (path === '/api/config/backups' && req.method === 'GET') {
return json({ backups: await listBackups(env) })
}
const restoreMatch = /^\/api\/config\/backups\/([^/]+)\/restore$/.exec(path)
if (restoreMatch && req.method === 'POST') {
const name = decodeURIComponent(restoreMatch[1]!)
const result = await restoreBackup(env, name)
return result.ok ? json(result) : json(result, applyFailureStatus(result.stage))
}
// ── 内核 ────────────────────────────────────────────
if (path === '/api/kernel' && req.method === 'GET') {
return json(await kernelVersion(env))
}
if (path.startsWith('/api/kernel/') && req.method === 'GET') {
const target = path.slice('/api/kernel'.length)
if (!READABLE_KERNEL_PATHS.has(target)) {
return json({ error: `不允许透传这个路径:${target}` }, 403)
}
const upstream = await proxyGet(env, target + url.search)
return new Response(upstream.body, {
status: upstream.status,
headers: { 'Content-Type': upstream.headers.get('Content-Type') ?? 'application/json' },
})
}
// ── 静态数据 ────────────────────────────────────────
if (path === '/api/meta/listener-fields' && req.method === 'GET') {
return json(listenerFields)
}
return json({ error: '没有这个接口' }, 404)
}
}