dsh-remote-panel 0.0.0-stage → 0.1.0

package/lib/allowlist.js

@@ -0,0 +1,101 @@
+/**
+ * 白名单编辑。
+ *
+ * 只改 Caddyfile 里那一行 `@lan remote_ip ...`，其余字符原样保留；
+ * 写前留 .bak，写后由调用方 reload。纯函数部分不碰磁盘，便于单测。
+ */
+
+import { chmodSync, copyFileSync, existsSync, readFileSync, renameSync, writeFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+
+const LINE = /^(\s*)@lan\s+remote_ip\s+(.+?)\s*$/
+
+/** 允许的条目：IPv4 / IPv6 / CIDR，不含空白。 */
+const ENTRY = /^[0-9A-Fa-f:.]{2,45}(?:\/\d{1,3})?$/
+
+/** 天然危险、需要二次确认的条目。 */
+const DANGEROUS = new Set(['0.0.0.0/0', '::/0', '0.0.0.0', '::'])
+
+/**
+ * @param {string} entry
+ * @param {{ force?: boolean }} [options]
+ */
+export function validateEntry(entry, { force = false } = {}) {
+	const value = String(entry ?? '').trim()
+	if (value === '') throw new Error('条目为空')
+	if (!ENTRY.test(value)) throw new Error(`条目格式不合法：${value}`)
+	if (DANGEROUS.has(value) && !force) throw new Error(`${value} 会放行全部来源，需要二次确认`)
+	return value
+}
+
+/**
+ * 解析当前的远程来源列表。
+ * @param {string} text Caddyfile 内容
+ * @returns {string[]}
+ */
+export function parseEntries(text) {
+	for (const line of String(text).split('\n')) {
+		const match = LINE.exec(line)
+		if (match !== null) return match[2].split(/\s+/).filter(Boolean)
+	}
+	return []
+}
+
+/**
+ * 增删一条，返回新的 Caddyfile 文本。
+ * @param {string} text
+ * @param {string} entry
+ * @param {'add'|'remove'} mode
+ */
+export function withEntry(text, entry, mode) {
+	const lines = String(text).split('\n')
+	const index = lines.findIndex((line) => LINE.test(line))
+	if (index === -1) throw new Error('Caddyfile 里找不到 @lan remote_ip 行')
+
+	const match = LINE.exec(lines[index])
+	const indent = match[1]
+	const current = match[2].split(/\s+/).filter(Boolean)
+	const next =
+		mode === 'add'
+			? current.includes(entry)
+				? current
+				: [...current, entry]
+			: current.filter((item) => item !== entry)
+
+	if (next.length === 0) throw new Error('白名单不能为空：至少保留本机 127.0.0.1')
+
+	// 每行最多 6 条，避免 Caddyfile 出现超长行
+	const chunks = []
+	for (let i = 0; i < next.length; i += 6) chunks.push(next.slice(i, i + 6))
+	lines[index] = chunks.map((chunk) => `${indent}@lan remote_ip ${chunk.join(' ')}`).join('\n')
+	return lines.join('\n')
+}
+
+/** 默认路径。 */
+export function caddyfilePath(home = homedir()) {
+	return join(home, '.config', 'caddy', 'Caddyfile')
+}
+
+/**
+ * 读 → 校验 → 写（原子）→ 留备份。
+ * @param {{ entry: string, mode: 'add'|'remove', force?: boolean, home?: string }} input
+ */
+export function mutateAllowlist({ entry, mode, force = false, home }) {
+	const value = validateEntry(entry, { force })
+	if (mode !== 'add' && mode !== 'remove') throw new Error('mode 必须是 add 或 remove')
+
+	const path = caddyfilePath(home)
+	if (!existsSync(path)) throw new Error(`Caddyfile 不存在：${path}（先完成部署）`)
+
+	const before = readFileSync(path, 'utf8')
+	const after = withEntry(before, value, mode)
+	if (after === before) return { changed: false, entries: parseEntries(after), path }
+
+	copyFileSync(path, `${path}.bak`)
+	const temp = `${path}.tmp`
+	writeFileSync(temp, after, 'utf8')
+	renameSync(temp, path)
+	chmodSync(path, 0o644)
+	return { changed: true, entries: parseEntries(after), path }
+}

package/lib/api.js

@@ -0,0 +1,107 @@
+/**
+ * 控制面的纯逻辑：请求体读取、默认值探测、口令生成。
+ * 与 HTTP 服务解耦，方便单测。
+ */
+
+import { randomBytes } from 'node:crypto'
+import { createServer } from 'node:net'
+import { homedir, networkInterfaces, userInfo } from 'node:os'
+
+import { renderDeploy } from './deploy/render.js'
+
+/** 客户端输入有问题（回 400，而不是 500）。 */
+export class BadRequest extends Error {}
+
+const MAX_BODY_BYTES = 64 * 1024
+
+/**
+ * 读取并解析 JSON 请求体。
+ * @param {AsyncIterable<Buffer|string>} req
+ * @returns {Promise<Record<string, unknown>>}
+ */
+export async function readJson(req) {
+	const chunks = []
+	let size = 0
+	for await (const chunk of req) {
+		const buffer = typeof chunk === 'string' ? Buffer.from(chunk) : chunk
+		size += buffer.length
+		if (size > MAX_BODY_BYTES) throw new BadRequest('请求体过大')
+		chunks.push(buffer)
+	}
+	if (size === 0) throw new BadRequest('请求体为空')
+	try {
+		const parsed = JSON.parse(Buffer.concat(chunks).toString('utf8'))
+		if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+			throw new BadRequest('请求体必须是 JSON 对象')
+		}
+		return parsed
+	} catch (error) {
+		if (error instanceof BadRequest) throw error
+		throw new BadRequest(`JSON 解析失败：${error instanceof Error ? error.message : String(error)}`)
+	}
+}
+
+/** 取第一个非回环 IPv4 的 CIDR 作为局域网白名单；探测不到时给常见默认值。 */
+export function detectLanCidr() {
+	for (const entries of Object.values(networkInterfaces())) {
+		for (const entry of entries ?? []) {
+			if (entry.family === 'IPv4' && !entry.internal && entry.cidr !== null) return entry.cidr
+		}
+	}
+	return '192.168.1.0/24'
+}
+
+/** 端口是否可绑定（127.0.0.1 上试听一次）。 */
+export function isPortFree(port) {
+	return new Promise((resolve) => {
+		const server = createServer()
+		server.once('error', () => resolve(false))
+		server.listen(port, '127.0.0.1', () => server.close(() => resolve(true)))
+	})
+}
+
+/** 从 start 起找第一个空闲端口，最多试 tries 个。 */
+export async function findFreePort(start = 8710, tries = 50) {
+	for (let offset = 0; offset < tries; offset += 1) {
+		const candidate = start + offset
+		if (candidate > 65535) break
+		if (await isPortFree(candidate)) return candidate
+	}
+	throw new BadRequest(`从 ${start} 起连续 ${tries} 个端口都被占用，请手动指定`)
+}
+
+/** 生成符合服务端校验的随机口令（base64url，去掉 =）。 */
+export function suggestToken(length = 24) {
+	return randomBytes(48).toString('base64url').replace(/=+$/, '').slice(0, length)
+}
+
+/** 向导打开时的默认值。 */
+export async function defaults(version) {
+	return {
+		ok: true,
+		version,
+		user: userInfo().username,
+		home: homedir(),
+		port: await findFreePort(8710),
+		upstreamPort: 3080,
+		lanCidr: detectLanCidr(),
+		etVersion: '2.6.4',
+		accessKey: suggestToken(24),
+		networkSecret: suggestToken(32),
+		networkName: 'dsh-remote',
+	}
+}
+
+/**
+ * 渲染向导结果。
+ * @param {Record<string, unknown>} body
+ * @param {string} version
+ */
+export function render(body, version) {
+	try {
+		const result = renderDeploy({ ...body, version })
+		return { ok: true, ...result }
+	} catch (error) {
+		throw new BadRequest(error instanceof Error ? error.message : String(error))
+	}
+}