Files
agent/app/server/auth.js
T
kicer 54aa56fefd 任务文件支持选择文件夹打包下载:目录头勾选整选,选中项含文件夹时后端打包 zip 流式下载
- index.html:目录行加勾选框(整文件夹作为一个选中项,d: 前缀存储);全选/勾选状态按目录树折叠归一化(effectiveSelection);批量下载含文件夹时走 zip-token 签名直链,纯文件仍逐文件下载;批量删除支持目录整体删除
- routes/files.js:纯 Node 手拼 zip(STORE 不压缩 + CRC32,两遍读文件磁盘流发送,不整包进内存);新增 GET /:id/files/zip-token 签发 5 分钟打包下载链接、GET /:id/files/zip[-name/*] 流式返回
- auth.js:签名下载白名单认 zip 两种 URL 形态
- style.css:目录头勾选框选中态样式
2026-09-08 07:37:39 +08:00

220 lines
10 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) {
if (PUBLIC_EXACT.has(p)) return true;
if (p.startsWith('/css/')) return true; // 登录页复用 style.css
if (p === '/favicon.ico') return true;
return false;
}
// 带签名 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}], secret?, ttl_ms? }
// users 为空则整个认证关闭(cfg.auth 为 null)。
function createAuth(cfg) {
const router = express.Router();
const users = (cfg.auth && cfg.auth.users) || [];
if (!users.length) {
return { enabled: false, middleware: (req, res, next) => next(), router };
}
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;
const 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;
}
// ----- 登录/登出 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) => {
res.json({ user: sessionUser(req) });
});
// ----- 登录页 / 登出跳转 -----
router.get('/login', (req, res) => {
if (sessionUser(req)) return res.redirect('/');
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 fromBasic = basicAuthUser(req, users);
const user = fromBasic || sessionUser(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: '未登录' });
return res.redirect('/login');
};
return { enabled: true, middleware, router };
}
module.exports = { createAuth, COOKIE_NAME };