// Copyright (c) 2026 Ivan Vasilev // This source code is licensed under the MIT license found in the // LICENSE file in the root directory of this source tree. import express, { Request, Response, NextFunction } from "express"; import path from "path"; import fs from "fs"; import crypto from "crypto"; import axios from "axios"; import Database from "better-sqlite3"; import { createSub } from "./sub"; import { createNodes } from "./nodes"; const app = express(); const PORT = Number(process.env.PORT) || 8080; const UI_USER = process.env.UI_USER ?? "admin"; const UI_PASS = process.env.UI_PASS ?? ""; const JWT_SECRET = process.env.JWT_SECRET ?? crypto.randomBytes(32).toString("hex"); const CTRL = `http://127.0.0.1:${process.env.AWGCTRL_PORT ?? "3005"}`; // Имя панели, канал и версия. В проде их прокидывает CLI (он читает .env в // корне проекта и cli.env); при самостоятельном запуске `npm run server` // читаем тот же .env сами, чтобы дев-режим показывал то же, что прод. function envFromFile(file: string, key: string): string { try { const m = fs.readFileSync(file, "utf8").match(new RegExp(`^\\s*${key}\\s*=\\s*(.*)$`, "m")); return m ? m[1].trim() : ""; } catch { return ""; } } const ROOT_ENV = path.join(__dirname, "..", ".env"); const BRAND = process.env.BRAND || envFromFile(ROOT_ENV, "BRAND") || "Forgetting"; const CHANNEL = process.env.CHANNEL || envFromFile(ROOT_ENV, "CHANNEL") || "Beta"; const VERSION = process.env.VERSION || envFromFile(ROOT_ENV, "VERSION") || ""; const INTERNAL_AUTH_KEY_FILE = process.env.INTERNAL_AUTH_KEY_FILE ?? path.join(__dirname, "internal_auth_private.key"); let internalAuthKey: crypto.KeyObject | null = null; try { internalAuthKey = crypto.createPrivateKey(fs.readFileSync(INTERNAL_AUTH_KEY_FILE)); } catch { console.warn("ui: приватный ключ внутренней авторизации не найден: " + INTERNAL_AUTH_KEY_FILE + " — запросы к awg-ctrl будут отклоняться"); } function mintInternalToken(): string { if (!internalAuthKey) throw new Error("приватный ключ внутренней авторизации не загружен"); const now = Math.floor(Date.now() / 1000); const h = Buffer.from('{"alg":"EdDSA","typ":"JWT"}').toString("base64url"); const p = Buffer.from(JSON.stringify({ iss: "awg-ui", iat: now, exp: now + 60 })).toString("base64url"); const sig = crypto.sign(null, Buffer.from(`${h}.${p}`), internalAuthKey).toString("base64url"); return `${h}.${p}.${sig}`; } const revoked = new Set(); // ── Ключи внешнего API (/api/v1) ─────────────────────────────────────────── // Живут в собственной БД awg-ui: awg-ctrl про них ничего не знает. Открытое // значение ключа не хранится — только SHA-256 и префикс для показа в панели. interface ApiKeyRow { id: number; label: string; key_hash: string; prefix: string; server_id: number; created_at: number; last_used: number | null; } const UI_DB_FILE = process.env.UI_DB_FILE || path.join(__dirname, "ui.db"); const uidb = new Database(UI_DB_FILE); uidb.pragma("journal_mode = WAL"); uidb.exec(` CREATE TABLE IF NOT EXISTS api_keys ( id INTEGER PRIMARY KEY AUTOINCREMENT, label TEXT NOT NULL, key_hash TEXT NOT NULL UNIQUE, prefix TEXT NOT NULL, server_id INTEGER NOT NULL DEFAULT 0, created_at INTEGER NOT NULL, last_used INTEGER ); -- Какие серверы видит ключ: на них он заводит vpn://-пользователей и в их пределах -- управляет мастер-ключами. api_keys.server_id — сервер по умолчанию для /api/v1/users, -- всегда входит в набор. CREATE TABLE IF NOT EXISTS api_key_servers ( key_id INTEGER NOT NULL REFERENCES api_keys(id) ON DELETE CASCADE, server_id INTEGER NOT NULL, PRIMARY KEY (key_id, server_id) ); -- Ключи со времён одного сервера: набор — их server_id. INSERT OR IGNORE INTO api_key_servers (key_id, server_id) SELECT id, server_id FROM api_keys WHERE id NOT IN (SELECT key_id FROM api_key_servers); `); const keyStmts = { list: uidb.prepare("SELECT id, label, prefix, server_id, created_at, last_used FROM api_keys ORDER BY id"), insert: uidb.prepare("INSERT INTO api_keys (label, key_hash, prefix, server_id, created_at) VALUES (?, ?, ?, ?, ?)"), delete: uidb.prepare<[number]>("DELETE FROM api_keys WHERE id = ?"), byId: uidb.prepare<[number]>("SELECT * FROM api_keys WHERE id = ?"), setDefault: uidb.prepare<[number, number]>("UPDATE api_keys SET server_id = ? WHERE id = ?"), serversOf: uidb.prepare<[number]>("SELECT server_id FROM api_key_servers WHERE key_id = ? ORDER BY server_id"), serverAdd: uidb.prepare<[number, number]>("INSERT OR IGNORE INTO api_key_servers (key_id, server_id) VALUES (?, ?)"), serversClear: uidb.prepare<[number]>("DELETE FROM api_key_servers WHERE key_id = ?"), keysOnServer: uidb.prepare<[number]>( "SELECT k.id, k.label, k.server_id, (SELECT COUNT(*) FROM api_key_servers x WHERE x.key_id = k.id) AS n FROM api_keys k JOIN api_key_servers s ON s.key_id = k.id WHERE s.server_id = ?"), byHash: uidb.prepare<[string]>("SELECT * FROM api_keys WHERE key_hash = ?"), touch: uidb.prepare<[number, number]>("UPDATE api_keys SET last_used = ? WHERE id = ?"), }; const keyServers = (id: number) => (keyStmts.serversOf.all(id) as { server_id: number }[]).map(r => r.server_id); // Набор серверов ключа целиком. Сервер по умолчанию остаётся, если он в наборе, иначе — // наименьший из набора. function setKeyServers(id: number, ids: number[]) { const row = keyStmts.byId.get(id) as ApiKeyRow; uidb.transaction(() => { keyStmts.serversClear.run(id); for (const sid of ids) keyStmts.serverAdd.run(id, sid); if (!ids.includes(row.server_id)) keyStmts.setDefault.run(ids[0], id); })(); } // Набор серверов из тела запроса: непустой, без повторов, только существующие. function parseKeyServers(v: unknown): number[] | string { if (!Array.isArray(v) || v.length === 0) return "Нужен хотя бы один сервер"; const ids = [...new Set(v)]; if (!ids.every(id => Number.isInteger(id) && nodes.exists(id as number))) return "Такого сервера нет"; return (ids as number[]).sort((a, b) => a - b); } function hashKey(key: string): string { return crypto.createHash("sha256").update(key).digest("hex"); } function genApiKey(): { key: string; hash: string; prefix: string } { const key = "awgk_" + crypto.randomBytes(24).toString("base64url"); return { key, hash: hashKey(key), prefix: key.slice(0, 13) + "…" }; } function tokenSig(token: string): string { return token.split(".")[2] ?? token; } function sign(): string { const h = Buffer.from('{"alg":"HS256","typ":"JWT"}').toString("base64url"); const p = Buffer.from(JSON.stringify({ exp: Math.floor(Date.now() / 1000) + 86400 })).toString("base64url"); const s = crypto.createHmac("sha256", JWT_SECRET).update(`${h}.${p}`).digest("base64url"); return `${h}.${p}.${s}`; } function verify(token: string): boolean { try { if (revoked.has(tokenSig(token))) return false; const [h, p, s] = token.split("."); if (!h || !p || !s) return false; const expected = crypto.createHmac("sha256", JWT_SECRET).update(`${h}.${p}`).digest(); const actual = Buffer.from(s, "base64url"); if (actual.length !== expected.length) return false; if (!crypto.timingSafeEqual(actual, expected)) return false; const { exp } = JSON.parse(Buffer.from(p, "base64url").toString()) as { exp: number }; return exp > Math.floor(Date.now() / 1000); } catch { return false; } } function requireAuth(req: Request, res: Response, next: NextFunction) { const auth = (req.headers["authorization"] ?? "") as string; const token = auth.startsWith("Bearer ") ? auth.slice(7) : ""; if (!token || !verify(token)) { res.status(401).json({ error: "Unauthorized" }); return; } next(); } const RATE_LIMIT = 5; const RATE_WINDOW = 15 * 60 * 1000; interface RateEntry { count: number; resetAt: number; } const loginAttempts = new Map(); function checkRate(ip: string): { ok: boolean; retryAfter?: number } { const now = Date.now(); const entry = loginAttempts.get(ip); if (!entry || entry.resetAt < now) { loginAttempts.set(ip, { count: 1, resetAt: now + RATE_WINDOW }); return { ok: true }; } if (entry.count >= RATE_LIMIT) { return { ok: false, retryAfter: Math.ceil((entry.resetAt - now) / 1000) }; } entry.count++; return { ok: true }; } app.use(express.json()); app.post("/login", (req: Request, res: Response) => { const ip = req.socket.remoteAddress ?? "unknown"; const { ok, retryAfter } = checkRate(ip); if (!ok) { res.status(429).json({ error: `Слишком много попыток. Повтори через ${retryAfter} сек.` }); return; } const { user, pass } = req.body as { user?: string; pass?: string }; if (!UI_PASS || user !== UI_USER || pass !== UI_PASS) { res.status(401).json({ error: "Неверный логин или пароль" }); return; } loginAttempts.delete(ip); res.json({ token: sign() }); }); app.post("/logout", requireAuth, (req: Request, res: Response) => { const token = (req.headers["authorization"] as string).slice(7); revoked.add(tokenSig(token)); res.json({ ok: true }); }); // Единственный роут без авторизации: вордмарк нужен уже на экране логина, // до выдачи JWT. Наружу уходит только имя продукта и версия. app.get("/ui/brand", (_req: Request, res: Response) => { res.json({ brand: BRAND, channel: CHANNEL, version: VERSION }); }); // Управление ключами внешнего API — роуты самой awg-ui, в awg-ctrl не идут. app.get("/ui/apikeys", requireAuth, (_req: Request, res: Response) => { res.json({ keys: (keyStmts.list.all() as ApiKeyRow[]).map(k => ({ ...k, servers: keyServers(k.id) })) }); }); // servers — набор серверов ключа; без него — server_id (по-старому) или сервер по умолчанию. app.post("/ui/apikeys", requireAuth, (req: Request, res: Response) => { const { label, server_id, servers } = req.body as { label?: string; server_id?: number; servers?: unknown }; if (!label || !/^[\w \-]{1,40}$/.test(label)) { res.status(400).json({ error: "Метка: буквы, цифры, пробел, _ и -, до 40 символов" }); return; } const ids = parseKeyServers(servers ?? [server_id === undefined ? nodes.defaultId() : Number(server_id)]); if (typeof ids === "string") { res.status(400).json({ error: ids }); return; } const sid = server_id !== undefined && ids.includes(Number(server_id)) ? Number(server_id) : ids[0]; const { key, hash, prefix } = genApiKey(); let id = 0; uidb.transaction(() => { id = Number(keyStmts.insert.run(label, hash, prefix, sid, Math.floor(Date.now() / 1000)).lastInsertRowid); for (const s of ids) keyStmts.serverAdd.run(id, s); })(); // Открытое значение отдаётся один раз — дальше в БД только хэш. res.status(201).json({ id, label, prefix, key, server_id: sid, servers: ids }); }); // Сменить набор серверов, не перевыпуская ключ. app.patch("/ui/apikeys/:id", requireAuth, (req: Request, res: Response) => { const id = Number(req.params.id); if (!Number.isInteger(id) || !keyStmts.byId.get(id)) { res.status(404).json({ error: "Не найден" }); return; } const ids = parseKeyServers((req.body as { servers?: unknown } | undefined)?.servers); if (typeof ids === "string") { res.status(400).json({ error: ids }); return; } setKeyServers(id, ids); const row = keyStmts.byId.get(id) as ApiKeyRow; res.json({ id, server_id: row.server_id, servers: ids }); }); app.delete("/ui/apikeys/:id", requireAuth, (req: Request, res: Response) => { const id = Number(req.params.id); if (!Number.isInteger(id)) { res.status(400).json({ error: "Неверный id" }); return; } uidb.transaction(() => { keyStmts.serversClear.run(id); keyStmts.delete.run(id); })(); res.json({ success: true, id }); }); // Сервер, к которому относится запрос панели: заголовок X-Server-Id (0 — локальный // awg-ctrl, остальное — нода). Без заголовка — сервер по умолчанию. function serverIdOf(req: Request): number { const raw = req.headers["x-server-id"]; if (raw === undefined) return nodes.defaultId(); const n = Number(raw); return Number.isInteger(n) && n >= 0 ? n : nodes.defaultId(); } async function proxy(req: Request, res: Response) { try { const r = await nodes.ctrlFor(serverIdOf(req))(req.method, req.originalUrl, req.body); res.status(r.status).json(r.data); } catch { res.status(502).json({ error: "awg-ctrl недоступен" }); } } interface ExtRequest extends Request { apiKey?: ApiKeyRow; servers?: number[]; serverId?: number; } function requireApiKey(req: Request, res: Response, next: NextFunction) { const key = (req.headers["x-api-key"] as string) ?? ""; if (!key.startsWith("awgk_")) { res.status(401).json({ error: "API key required" }); return; } const row = keyStmts.byHash.get(hashKey(key)) as ApiKeyRow | undefined; if (!row) { res.status(401).json({ error: "Invalid API key" }); return; } keyStmts.touch.run(Math.floor(Date.now() / 1000), row.id); (req as ExtRequest).apiKey = row; (req as ExtRequest).servers = keyServers(row.id); next(); } // Сервер для /api/v1/users: X-Server-Id из набора ключа, без заголовка — сервер ключа по // умолчанию. Сервер вне набора — как несуществующий. function pickKeyServer(req: Request, res: Response, next: NextFunction) { const r = req as ExtRequest; const raw = req.headers["x-server-id"]; const id = raw === undefined ? r.apiKey!.server_id : Number(raw); if (!Number.isInteger(id) || !r.servers!.includes(id)) { res.status(404).json({ error: "Сервер не найден" }); return; } r.serverId = id; next(); } async function ctrl(method: string, urlPath: string, body?: unknown) { return axios({ method, url: CTRL + urlPath, headers: { Authorization: `Bearer ${mintInternalToken()}`, "Content-Type": "application/json" }, data: body, validateStatus: () => true, }); } // Внешний контракт: наружу отдаём только name/ip/gen/vpn_key — psk_key и pub_key // остаются внутри. gen — поколение AmneziaWG, на параметрах которого выдан ключ. interface ExtUser { name: string; ip: string; vpn_key: string; key_gen: string } const ext = express.Router(); ext.use(requireApiKey); // vpn://-пользователи живут на одном сервере — на выбранном pickKeyServer. ext.use("/users", pickKeyServer); const ctrlOf = (req: Request) => nodes.ctrlFor((req as ExtRequest).serverId ?? 0); // Express 4 не ловит отказы async-обработчиков: незакрытый reject (awg-ctrl не // отвечает, внутренний ключ не загружен) уронил бы весь процесс панели. Ответ // тот же, что у proxy() в такой ситуации. type Handler = (req: Request, res: Response) => Promise; const wrap = (fn: Handler) => (req: Request, res: Response) => { fn(req, res).catch(() => { res.status(502).json({ error: "awg-ctrl недоступен" }); }); }; ext.post("/users", wrap(async (req, res) => { const { name } = (req.body ?? {}) as { name?: string }; const r = await ctrlOf(req)("POST", "/api/users", { name }); if (r.status >= 400) { res.status(r.status).json(r.data); return; } const u = r.data as ExtUser; res.status(201).json({ name: u.name, ip: u.ip, gen: u.key_gen, vpn_key: u.vpn_key }); })); ext.get("/users", wrap(async (req, res) => { const r = await ctrlOf(req)("GET", "/api/users/stats"); res.status(r.status).json(r.data); })); ext.get("/users/:name", wrap(async (req, res) => { const r = await ctrlOf(req)("POST", `/api/users/${encodeURIComponent(req.params.name)}`); if (r.status >= 400) { res.status(r.status).json(r.data); return; } const u = r.data as ExtUser; res.json({ name: u.name, ip: u.ip, gen: u.key_gen, vpn_key: u.vpn_key }); })); ext.delete("/users/:name", wrap(async (req, res) => { const r = await ctrlOf(req)("DELETE", `/api/users/${encodeURIComponent(req.params.name)}`); res.status(r.status).json(r.data); })); // ВАЖНО: /api/v1 монтируется ДО JWT-прокси на /api — иначе прокси перехватит // его и потребует JWT вместо ключа. app.use("/api/v1", ext); // sen://-подписка: мастер-ключи и устройства (роуты панели, за JWT) и публичный // листенер /sub/v1 на своём порту SUB_PORT. Публичная часть сюда не монтируется. // Несколько серверов: core (эта панель) + ноды по исходящему WSS. Реестр — в ui.db. const nodes = createNodes({ uidb, ctrlLocal: ctrl, baseDir: __dirname, version: VERSION }); app.use("/ui/nodes", requireAuth, nodes.router); // sen://-подписка: мастер-ключ отдаёт набор серверов (локальный и/или ноды). const sub = createSub({ uidb, servers: nodes, baseDir: __dirname }); app.use("/ui/masterkeys", requireAuth, sub.masterKeys); app.use("/ui/devices", requireAuth, sub.devices); // Мастер-ключи во внешнем API — в пределах набора серверов API-ключа. ext уже смонтирован // на /api/v1 до JWT-прокси, роуты в нём можно добавлять и позже. ext.use("/masterkeys", sub.apiRouter(req => (req as ExtRequest).servers ?? [])); // Сервер удаляют из реестра: ключ API, для которого он единственный, — повод отказать // (ключ остался бы без серверов); у остальных он убирается из набора, когда сервер удалён. type KeyOnServer = { id: number; label: string; server_id: number; n: number }; nodes.beforeDelete(async id => { const only = (keyStmts.keysOnServer.all(id) as KeyOnServer[]).filter(k => k.n === 1).map(k => k.label); return only.length ? { error: `Это единственный сервер ключей API: ${only.join(", ")} — сначала удалите их или добавьте им другой сервер`, forcible: false } : null; }); nodes.afterDelete(id => { for (const k of keyStmts.keysOnServer.all(id) as KeyOnServer[]) setKeyServers(k.id, keyServers(k.id).filter(s => s !== id)); }); app.use(["/api", "/health", "/awg"], requireAuth, proxy); app.use(express.static(path.join(__dirname, "dist"))); app.get("*", (_req: Request, res: Response) => { res.sendFile(path.join(__dirname, "dist", "index.html")); }); app.listen(PORT, () => { console.log(`ui: listening on :${PORT}`); }); nodes.start(); sub.start();