Files
agent/app/server/auth.js
T
kicer 53fa5da82b 新增语音输入(mcp_asr)与健康检查服务标识
语音输入:输入框为空时发送键变麦克风,进入语音模式后按住说话、松手转写并发送;套壳 App 走原生录音桥,浏览器走 MediaRecorder(需 HTTPS)。转写在 mcp_asr,经 /api/asr/transcribe 直达,不经过模型、不消耗 token。

/api/health 增加 service/api/auth_required 字段并设 no-store,供套壳 App 校验手填的服务器地址;免认证路径容忍尾斜杠,避免 /api/health/ 被中间件 401。

接线与文档:compose 新增 mcp_asr;init.sh 默认复用 BIGMODEL_KEY 作为 ASR_API_KEY;README/AGENTS/mcp 文档同步。版本 2.3.0 → 2.4.0。
2026-10-24 16:13:30 +08:00

272 lines
13 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// 多用户会话认证:用户名/明文密码配在 config.yml 的 auth.users,登录后签发 HMAC 签名 token,
// 以 HttpOnly cookie 下发(SameSite=Lax,浏览器在 XHR 与原生下载导航中都会自动携带)。
// 替代原先 nginx htpasswd 的 basic auth:手机浏览器原生下载不带 Basic 认证头,导致下载失败。
const express = require('express');
const crypto = require('crypto');
const path = require('path');
const { readConfigText, applyEditsToText, loadConfigFromText, writeConfigText } = require('./config');
const log = require('./log');
const COOKIE_NAME = 'agent_token';
const DEFAULT_TTL_MS = 30 * 24 * 3600 * 1000; // 30 天
function b64url(buf) {
return Buffer.from(buf).toString('base64url').replace(/=+$/, '');
}
function timingEqual(a, b) {
// 先哈希再定长比较:timingSafeEqual 要求等长 buffer,哈希后既定长又避免长度旁路
const ha = crypto.createHash('sha256').update(String(a)).digest();
const hb = crypto.createHash('sha256').update(String(b)).digest();
return crypto.timingSafeEqual(ha, hb);
}
// ---------- token:payloadB64url.signature(无状态,密钥变更/重启即失效) ----------
function signToken(username, expires, secret) {
const payload = b64url(Buffer.from(JSON.stringify({ u: username, exp: expires }), 'utf8'));
const sig = crypto.createHmac('sha256', secret).update(payload).digest('hex');
return payload + '.' + sig;
}
function readToken(token, secret) {
if (!token || typeof token !== 'string') return null;
const i = token.lastIndexOf('.');
if (i <= 0) return null;
const payload = token.slice(0, i);
const sig = token.slice(i + 1);
const expected = crypto.createHmac('sha256', secret).update(payload).digest('hex');
if (!timingEqual(sig, expected)) return null;
try {
const data = JSON.parse(Buffer.from(payload, 'base64url').toString('utf8'));
if (!data || typeof data.u !== 'string' || !Number.isFinite(data.exp) || data.exp < Date.now()) return null;
return { user: data.u };
} catch (_) { return null; }
}
// ---------- cookie / basic 凭据解析 ----------
function parseCookies(req) {
const out = {};
const raw = req.headers.cookie;
if (!raw) return out;
for (const part of raw.split(';')) {
const i = part.indexOf('=');
if (i > 0) out[part.slice(0, i).trim()] = decodeURIComponent(part.slice(i + 1).trim());
}
return out;
}
// Authorization: Basic 兼容层(curl / API 脚本用;浏览器页面下载走 cookie)
function basicAuthUser(req, users) {
const h = req.headers.authorization;
if (!h || !h.startsWith('Basic ')) return null;
let decoded;
try { decoded = Buffer.from(h.slice(6), 'base64').toString('utf8'); } catch (_) { return null; }
const i = decoded.indexOf(':');
if (i < 0) return null;
const name = decoded.slice(0, i);
const pass = decoded.slice(i + 1);
for (const u of users) {
if (timingEqual(u.user, name) && timingEqual(u.password, pass)) return u.user;
}
return null;
}
// ---------- 免认证路径(登录页自身需要的资源) ----------
const PUBLIC_EXACT = new Set(['/login', '/logout', '/api/login', '/api/logout', '/api/login_restore', '/api/health']);
function isPublicPath(p) {
// 尾斜杠容忍:客户端手动填服务器地址常多带一个 `/`(拼成 `/api/health/`),
// Express 路由本身能匹配,但这里若不规范化,中间件会先回 401——地址明明是对的却报未登录。
const norm = p.length > 1 ? p.replace(/\/+$/, '') : p;
if (PUBLIC_EXACT.has(norm)) return true;
if (p.startsWith('/css/')) return true; // 登录页复用 style.css
if (p === '/favicon.ico') return true;
return false;
}
// 登录成功后的回跳目标:只允许本站绝对路径,拦掉 //evil.com(协议相对)与反斜杠混淆,防开放重定向。
function safeNextUrl(u) {
const s = String(u || '');
if (!s.startsWith('/') || s.startsWith('//') || s.includes('\\')) return '/';
return s;
}
// 带签名 token 的临时下载链接(files.js 自己验签),此处放行由路由层拒绝伪造请求。
// URL 形态都要认:/files/download?path=…、/files/download-name/<名字>?path=…,
// 及打包下载 /files/zip?paths=…、/files/zip-name/<名字>?paths=…;
// 只认旧形态会让 APK 系统下载器(不带 cookie、依赖 token)对新链接拿 401。
function isSignedDownload(req) {
return req.method === 'GET' && /\/files\/(download(-name\/.+)?|zip(-name\/.+)?)$/.test(req.path) && !!req.query.t;
}
// cfg.auth = { users: [{user, password, role?, model?}], secret?, ttl_ms? }
// users 为空则整个认证关闭(cfg.auth 为 null)。
function createAuth(cfg) {
const router = express.Router();
let users = (cfg.auth && cfg.auth.users) || [];
if (!users.length) {
// 未启用认证 = 单用户自用:管理接口按「本机主人」放行,用户 CRUD 由 routes/users.js 自己拒绝。
return {
enabled: false,
middleware: (req, res, next) => next(),
router,
requireAdmin: (req, res, next) => next(),
refreshUsers: () => {},
isAdmin: () => false,
};
}
const secret = (cfg.auth.secret && String(cfg.auth.secret)) || crypto.randomBytes(32).toString('hex');
if (!cfg.auth.secret) {
log.warn('auth', '未配置 auth.secret,已使用随机密钥:进程重启后所有登录态失效');
}
const ttlMs = Number(cfg.auth.ttl_ms) || DEFAULT_TTL_MS;
let validUsers = new Map(users.map(u => [String(u.user), String(u.password)]));
function userRow(name) {
const n = String(name == null ? '' : name);
return users.find(u => String(u.user) === n) || null;
}
function isAdmin(name) {
const u = userRow(name);
return !!u && u.role === 'admin';
}
// 用户增删改后由 routes/users.js 调用:重建登录校验表(删除的用户旧 token 随即失效)。
function refreshUsers(next) {
users = Array.isArray(next) ? next : [];
validUsers = new Map(users.map(u => [String(u.user), String(u.password)]));
}
function setAuthCookie(res, username) {
const token = signToken(username, Date.now() + ttlMs, secret);
res.setHeader('Set-Cookie', COOKIE_NAME + '=' + encodeURIComponent(token)
+ '; Path=/; HttpOnly; SameSite=Lax; Max-Age=' + Math.floor(ttlMs / 1000));
return token;
}
function clearAuthCookie(res) {
res.setHeader('Set-Cookie', COOKIE_NAME + '=; Path=/; HttpOnly; SameSite=Lax; Max-Age=0');
}
function sessionUser(req) {
const token = parseCookies(req)[COOKIE_NAME];
const data = readToken(token, secret);
// 用户可能已从配置中删除:token 有效但用户不存在也视为未登录
if (data && validUsers.has(data.user)) return data.user;
return null;
}
// 统一身份解析:cookie 优先于 Authorization: Basic。
// cookie 是浏览器全局的(切号登录立即覆盖、SSE 导航下载都带它),而 Basic 头可能来自
// 旧标签页残留的 sessionStorage 凭据——两者取用时若 Basic 优先,会出现 /api/me(读 cookie)
// 与业务路由(读 Basic)身份分裂。统一 cookie 优先保证同一浏览器内所有请求认定同一用户,
// Basic 仅作为无 cookie 场景(curl / API 脚本)的兜底。
function authUser(req) {
return sessionUser(req) || basicAuthUser(req, users);
}
// ----- 登录/登出 API -----
router.post('/api/login', (req, res) => {
const { user, password } = req.body || {};
const expect = validUsers.get(String(user || ''));
if (expect == null || !timingEqual(expect, String(password == null ? '' : password))) {
log.warn('auth', '登录失败(用户名或密码错误):user=' + String(user || '-') + ' ip=' + (req.ip || '-'));
return res.status(401).json({ error: '用户名或密码错误' });
}
setAuthCookie(res, String(user));
// 用户进入系统的唯一关口:记一条 info,便于对照后续该用户的会话/消息日志
log.info('auth', '用户 ' + String(user) + ' 登录 ip=' + (req.ip || '-'));
// token 一并回给前端:WebView 封装 APK 杀进程后 cookie 可能没落盘,
// 前端存 localStorage,下次进登录页用 /api/login_restore 自动恢复。
res.json({ ok: true, user: String(user), token: signToken(String(user), Date.now() + ttlMs, secret) });
});
// 自动恢复登录态(主要是 WebView 封装场景):cookie 丢了但 localStorage 里的 token 还在,
// 携 Authorization: Bearer <token> 请求本接口,验签通过则重新下发 cookie。
router.post('/api/login_restore', (req, res) => {
const h = String(req.headers.authorization || '');
const data = readToken(h.startsWith('Bearer ') ? h.slice(7).trim() : '', secret);
if (!data || !validUsers.has(data.user)) return res.status(401).json({ error: '登录态已失效,请重新登录' });
setAuthCookie(res, data.user); // 重新签发,顺带续期
// APK 冷启动常触发,属自动恢复而非手动登录,记 debug 避免刷屏
log.debug('auth', '用户 ' + data.user + ' 恢复登录态(login_restore)');
res.json({ ok: true, user: data.user });
});
router.post('/api/logout', (req, res) => {
clearAuthCookie(res);
res.json({ ok: true });
});
// ----- 修改密码(设置页) -----
// 已登录即可改自己的密码(免输原密码) → 写回 config.yml(保留注释,校验失败不动文件)
// → 同步更新内存(users/validUsers),立即生效无需重启。
// 已签发的 token 不失效(HMAC 无状态);其他设备下次登录才需新密码。
// 注:本路由挂在认证中间件之前,需手动验登录态。
router.post('/api/password', (req, res) => {
try {
const me = sessionUser(req);
if (!me) return res.status(401).json({ error: '未登录' });
const newP = String((req.body && req.body.new_password == null ? '' : req.body.new_password));
if (newP.length < 6) return res.status(400).json({ error: '新密码至少 6 位' });
const idx = users.findIndex(u => String(u.user) === me);
if (idx < 0) return res.status(404).json({ error: '当前用户已不在配置中' });
if (newP === users[idx].password) return res.status(400).json({ error: '新密码与当前密码相同' });
const text = readConfigText(cfg);
if (text === null) return res.status(409).json({ error: '配置文件不存在,无法持久化新密码' });
let nextText;
try {
nextText = applyEditsToText(text, [{ path: ['auth', 'users', String(idx), 'password'], value: newP }]);
loadConfigFromText(nextText, cfg.config_path);
} catch (e) {
return res.status(400).json({ error: '写入配置失败:' + String(e && e.message || e) });
}
writeConfigText(cfg, nextText);
// 内存同步:users 与 engine.cfg 是同一对象,Basic 认证实时生效;cookie 登录查 validUsers
users[idx].password = newP;
validUsers.set(me, newP);
log.info('auth', '用户 ' + me + ' 修改了密码');
res.json({ ok: true });
} catch (e) {
res.status(500).json({ error: String(e && e.message || e) });
}
});
router.get('/api/me', (req, res) => {
// 与中间件同一解析顺序(cookie 优先),保证 /api/me 显示的用户与业务路由认定的用户一致
const name = authUser(req);
const row = name ? userRow(name) : null;
res.json({ user: name, role: row ? row.role : '', model: row ? (row.model || '') : '' });
});
// ----- 登录页 / 登出跳转 -----
router.get('/login', (req, res) => {
// 已登录直接放行:优先回跳 next 指定的原页面(中间件在 302 来 /login 时带上的)
if (sessionUser(req)) return res.redirect(safeNextUrl(req.query.next));
res.sendFile(path.join(__dirname, 'public', 'login.html'));
});
router.get('/logout', (req, res) => {
clearAuthCookie(res);
// 带标记:登录页据此清掉 localStorage 里的恢复 token,避免自动登录把用户“投回去”
res.redirect('/login?logged_out=1');
});
// ----- 全局认证中间件:cookie 或 Basic 任一通过;否则 API 回 401、页面跳登录页 -----
const middleware = (req, res, next) => {
const user = authUser(req);
if (user) { req.user = user; return next(); }
if (isPublicPath(req.path) || isSignedDownload(req)) return next();
if (req.path.startsWith('/api/')) return res.status(401).json({ error: '未登录' });
// 带上原始 URL(含 query),登录页成功后回跳,不再一律进首页
return res.redirect('/login?next=' + encodeURIComponent(req.originalUrl));
};
// 管理接口门禁(挂在 auth.middleware 之后):仅 admin 可进。
function requireAdmin(req, res, next) {
if (!req.user) return res.status(401).json({ error: '未登录' });
if (!isAdmin(req.user)) return res.status(403).json({ error: '需要管理员权限' });
next();
}
return { enabled: true, middleware, router, requireAdmin, refreshUsers, isAdmin };
}
module.exports = { createAuth, COOKIE_NAME };