@lzwme/sserver 0.0.11 → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.MD +71 -108
- package/dist/assets/assets/localsend/style.css +2 -0
- package/dist/assets/assets/localsend/vendor/qr-code-styling.js +2 -0
- package/dist/assets/localsend/style.css +2 -0
- package/dist/assets/localsend/vendor/qr-code-styling.js +2 -0
- package/dist/cli.js +9 -6
- package/dist/config.d.ts +38 -1
- package/dist/config.js +54 -9
- package/dist/lib/get-cert.js +1 -1
- package/dist/lib/merge-config.d.ts +9 -0
- package/dist/lib/merge-config.js +66 -0
- package/dist/lib/utils.d.ts +27 -1
- package/dist/lib/utils.js +94 -14
- package/dist/localsend/audit.d.ts +36 -0
- package/dist/localsend/audit.js +104 -0
- package/dist/localsend/auth.d.ts +94 -0
- package/dist/localsend/auth.js +227 -0
- package/dist/localsend/cache.d.ts +34 -0
- package/dist/localsend/cache.js +269 -0
- package/dist/localsend/chunk.d.ts +114 -0
- package/dist/localsend/chunk.js +475 -0
- package/dist/localsend/cleaner.d.ts +19 -0
- package/dist/localsend/cleaner.js +80 -0
- package/dist/localsend/client/app.js +4131 -0
- package/dist/localsend/client/crypto.js +233 -0
- package/dist/localsend/client/favicon.png +0 -0
- package/dist/localsend/client/icons/icon-192.png +0 -0
- package/dist/localsend/client/icons/icon-512.png +0 -0
- package/dist/localsend/client/index.html +451 -0
- package/dist/localsend/client/manifest.webmanifest +33 -0
- package/dist/localsend/client/sw.js +128 -0
- package/dist/localsend/guard.d.ts +58 -0
- package/dist/localsend/guard.js +210 -0
- package/dist/localsend/index.d.ts +52 -0
- package/dist/localsend/index.js +1771 -0
- package/dist/localsend/manage.d.ts +96 -0
- package/dist/localsend/manage.js +304 -0
- package/dist/localsend/metrics.d.ts +26 -0
- package/dist/localsend/metrics.js +58 -0
- package/dist/localsend/paste.d.ts +72 -0
- package/dist/localsend/paste.js +125 -0
- package/dist/localsend/path.d.ts +33 -0
- package/dist/localsend/path.js +151 -0
- package/dist/localsend/query.d.ts +78 -0
- package/dist/localsend/query.js +147 -0
- package/dist/localsend/secret.d.ts +31 -0
- package/dist/localsend/secret.js +96 -0
- package/dist/localsend/settings.d.ts +53 -0
- package/dist/localsend/settings.js +285 -0
- package/dist/localsend/share.d.ts +35 -0
- package/dist/localsend/share.js +117 -0
- package/dist/localsend/temp.d.ts +10 -0
- package/dist/localsend/temp.js +47 -0
- package/dist/localsend/ticket.d.ts +40 -0
- package/dist/localsend/ticket.js +98 -0
- package/dist/localsend/trash.d.ts +39 -0
- package/dist/localsend/trash.js +261 -0
- package/dist/localsend/webdav.d.ts +50 -0
- package/dist/localsend/webdav.js +530 -0
- package/dist/localsend/zip.d.ts +20 -0
- package/dist/localsend/zip.js +186 -0
- package/dist/proxy/php-proxy.js +31 -20
- package/dist/static-server.js +10 -3
- package/package.json +13 -5
- package/dist/localsend/index.html +0 -531
- package/dist/localsend.d.ts +0 -19
- package/dist/localsend.js +0 -217
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.AUDIT_MAX_BYTES = void 0;
|
|
4
|
+
exports.createAuditLog = createAuditLog;
|
|
5
|
+
/*
|
|
6
|
+
* LocalSend 操作审计
|
|
7
|
+
*
|
|
8
|
+
* 局域网共享盘最常被问的问题是「谁把文件删了」「谁改了口令」。
|
|
9
|
+
* 这里只记录**改了东西的操作**(删除、整理、回收站、分享、设置、认证),
|
|
10
|
+
* 不记录浏览与下载,避免日志被正常使用刷满。
|
|
11
|
+
*
|
|
12
|
+
* 几个刻意的设计:
|
|
13
|
+
* - JSON Lines:一行一条,追加写入,坏一行不影响其它行
|
|
14
|
+
* - 写在用户配置目录,**不进存储目录**:因此不会被文件列表、配额、自动清理、
|
|
15
|
+
* WebDAV 看到,也不会被「清空回收站」一并带走
|
|
16
|
+
* - 绝不记录口令/令牌/会话,只记角色与动作
|
|
17
|
+
* - 任何写入失败都吞掉:审计不能反过来影响正常请求
|
|
18
|
+
*/
|
|
19
|
+
const node_fs_1 = require("node:fs");
|
|
20
|
+
const node_path_1 = require("node:path");
|
|
21
|
+
/** 默认单文件上限:5MB 约可容纳数万条记录 */
|
|
22
|
+
exports.AUDIT_MAX_BYTES = 5 * 1024 * 1024;
|
|
23
|
+
/** 默认返回条数 */
|
|
24
|
+
const DEFAULT_RECENT = 100;
|
|
25
|
+
/** 单条记录里 target 的最大长度,避免超长路径把日志撑大 */
|
|
26
|
+
const MAX_TARGET_LEN = 500;
|
|
27
|
+
function createAuditLog(options) {
|
|
28
|
+
const file = options.file;
|
|
29
|
+
const maxBytes = options.maxBytes ?? exports.AUDIT_MAX_BYTES;
|
|
30
|
+
/** 内存中维护当前大小,避免每条都 stat */
|
|
31
|
+
let size = 0;
|
|
32
|
+
try {
|
|
33
|
+
if ((0, node_fs_1.existsSync)(file))
|
|
34
|
+
size = (0, node_fs_1.statSync)(file).size;
|
|
35
|
+
}
|
|
36
|
+
catch {
|
|
37
|
+
size = 0;
|
|
38
|
+
}
|
|
39
|
+
/** 轮转:当前文件改名为 .1,更早的直接丢弃(只保留一份历史) */
|
|
40
|
+
function rotate() {
|
|
41
|
+
try {
|
|
42
|
+
const backup = `${file}.1`;
|
|
43
|
+
(0, node_fs_1.rmSync)(backup, { force: true });
|
|
44
|
+
(0, node_fs_1.renameSync)(file, backup);
|
|
45
|
+
}
|
|
46
|
+
catch {
|
|
47
|
+
// 轮转失败就继续写当前文件,至少不丢记录
|
|
48
|
+
}
|
|
49
|
+
size = 0;
|
|
50
|
+
}
|
|
51
|
+
return {
|
|
52
|
+
file,
|
|
53
|
+
record(entry) {
|
|
54
|
+
const line = {
|
|
55
|
+
ts: entry.ts ?? Date.now(),
|
|
56
|
+
ip: entry.ip || 'unknown',
|
|
57
|
+
role: entry.role || 'guest',
|
|
58
|
+
action: entry.action,
|
|
59
|
+
target: entry.target ? String(entry.target).slice(0, MAX_TARGET_LEN) : undefined,
|
|
60
|
+
extra: entry.extra,
|
|
61
|
+
};
|
|
62
|
+
try {
|
|
63
|
+
if (!(0, node_fs_1.existsSync)((0, node_path_1.dirname)(file)))
|
|
64
|
+
(0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(file), { recursive: true });
|
|
65
|
+
if (size >= maxBytes)
|
|
66
|
+
rotate();
|
|
67
|
+
const text = `${JSON.stringify(line)}\n`;
|
|
68
|
+
(0, node_fs_1.appendFileSync)(file, text, 'utf8');
|
|
69
|
+
size += Buffer.byteLength(text);
|
|
70
|
+
}
|
|
71
|
+
catch {
|
|
72
|
+
// 审计写入失败不影响请求
|
|
73
|
+
}
|
|
74
|
+
},
|
|
75
|
+
recent(limit = DEFAULT_RECENT) {
|
|
76
|
+
if (!(0, node_fs_1.existsSync)(file))
|
|
77
|
+
return [];
|
|
78
|
+
let text = '';
|
|
79
|
+
try {
|
|
80
|
+
text = (0, node_fs_1.readFileSync)(file, 'utf8');
|
|
81
|
+
}
|
|
82
|
+
catch {
|
|
83
|
+
return [];
|
|
84
|
+
}
|
|
85
|
+
const lines = text.split('\n').filter(Boolean);
|
|
86
|
+
const out = [];
|
|
87
|
+
// 从文件尾部往前取,坏行直接跳过
|
|
88
|
+
for (let i = lines.length - 1; i >= 0 && out.length < limit; i--) {
|
|
89
|
+
try {
|
|
90
|
+
const parsed = JSON.parse(lines[i]);
|
|
91
|
+
if (parsed && typeof parsed.ts === 'number' && parsed.action)
|
|
92
|
+
out.push(parsed);
|
|
93
|
+
}
|
|
94
|
+
catch {
|
|
95
|
+
// 忽略损坏的行
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
return out;
|
|
99
|
+
},
|
|
100
|
+
size() {
|
|
101
|
+
return size;
|
|
102
|
+
},
|
|
103
|
+
};
|
|
104
|
+
}
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
import { SECRET_ITERATIONS, type SecretInfo, type SecretKind } from './secret';
|
|
2
|
+
/** 权限角色 */
|
|
3
|
+
export type Role = 'admin' | 'visitor' | 'guest' | 'open';
|
|
4
|
+
/** 会话来源:口令登录 / 访问令牌登录 */
|
|
5
|
+
export type SessionVia = 'password' | 'token';
|
|
6
|
+
/** 已登录会话 */
|
|
7
|
+
export interface Session {
|
|
8
|
+
/** 会话令牌 */
|
|
9
|
+
token: string;
|
|
10
|
+
/** 该会话的权限角色 */
|
|
11
|
+
role: Role;
|
|
12
|
+
/** 会话来源 */
|
|
13
|
+
via: SessionVia;
|
|
14
|
+
/** 创建时间 */
|
|
15
|
+
createdAt: number;
|
|
16
|
+
/** 过期时间戳 */
|
|
17
|
+
expiresAt: number;
|
|
18
|
+
}
|
|
19
|
+
export interface AuthOptions {
|
|
20
|
+
/** 管理员口令。设置后危险操作需要登录 */
|
|
21
|
+
password?: string;
|
|
22
|
+
/** 访客口令(可选)。设置后未登录用户必须输入该口令才能上传下载;留空则允许未登录用户上传下载 */
|
|
23
|
+
visitorPassword?: string;
|
|
24
|
+
/** 访问令牌(可选)。设置后需要输入令牌才能访问 */
|
|
25
|
+
token?: string;
|
|
26
|
+
/** 会话有效期(毫秒),默认 24 小时 */
|
|
27
|
+
sessionTtl?: number;
|
|
28
|
+
}
|
|
29
|
+
export interface Auth {
|
|
30
|
+
/** 是否为开放模式(未配置任何口令) */
|
|
31
|
+
readonly open: boolean;
|
|
32
|
+
/** 是否配置了管理员口令 */
|
|
33
|
+
readonly hasAdmin: boolean;
|
|
34
|
+
/** 是否配置了访客口令 */
|
|
35
|
+
readonly hasVisitor: boolean;
|
|
36
|
+
/** 是否配置了访问令牌 */
|
|
37
|
+
readonly hasToken: boolean;
|
|
38
|
+
/** 各密钥的公开盐值信息,供客户端派生摘要 */
|
|
39
|
+
secrets: () => SecretInfo[];
|
|
40
|
+
/** 校验口令或令牌摘要并建立会话,匹配不上返回 null */
|
|
41
|
+
login: (digests: {
|
|
42
|
+
password?: string;
|
|
43
|
+
visitorPassword?: string;
|
|
44
|
+
token?: string;
|
|
45
|
+
}) => Session | null;
|
|
46
|
+
/** 校验访问令牌摘要并建立会话,匹配不上返回 null */
|
|
47
|
+
loginByToken: (digest: string) => Session | null;
|
|
48
|
+
/** 注销会话,返回是否确实注销了 */
|
|
49
|
+
logout: (token: string) => boolean;
|
|
50
|
+
/** 取会话,已过期返回 null */
|
|
51
|
+
get: (token: string) => Session | null;
|
|
52
|
+
/** 判定某个会话令牌对应的角色 */
|
|
53
|
+
roleOf: (token: string) => Role;
|
|
54
|
+
/**
|
|
55
|
+
* 运行时更新口令、令牌与会话有效期。
|
|
56
|
+
*
|
|
57
|
+
* 口令一旦变更,此前签发的会话全部失效(keepToken 指定的当前会话保留),
|
|
58
|
+
* 避免口令泄露后旧会话仍能继续使用;
|
|
59
|
+
* 访问令牌变更只作废「用令牌换来的会话」,口令登录的会话不受影响。
|
|
60
|
+
*/
|
|
61
|
+
update: (options: {
|
|
62
|
+
password?: string;
|
|
63
|
+
visitorPassword?: string;
|
|
64
|
+
token?: string;
|
|
65
|
+
sessionTtl?: number;
|
|
66
|
+
}, keepToken?: string) => void;
|
|
67
|
+
/** 校验管理员口令摘要 */
|
|
68
|
+
verifyAdmin: (digest: string) => boolean;
|
|
69
|
+
/** 校验明文口令(WebDAV Basic Auth 这类只能传明文的场景),返回匹配的密钥种类 */
|
|
70
|
+
verifyPlain: (plaintext: string) => SecretKind | null;
|
|
71
|
+
/** 明文口令对应的角色 */
|
|
72
|
+
plainRole: (plaintext: string) => Role | null;
|
|
73
|
+
/** 校验访问令牌摘要(请求头 X-Localsend-Key) */
|
|
74
|
+
verifyToken: (digest: string) => boolean;
|
|
75
|
+
/** 校验访问令牌:同时接受明文与摘要两种形式 */
|
|
76
|
+
verifyTokenValue: (presented: string) => boolean;
|
|
77
|
+
/** 清理过期会话,返回清理数量 */
|
|
78
|
+
cleanup: () => number;
|
|
79
|
+
/** 停止定时清理 */
|
|
80
|
+
stop: () => void;
|
|
81
|
+
}
|
|
82
|
+
export declare function createAuth(options?: AuthOptions): Auth;
|
|
83
|
+
/** 角色是否允许执行危险操作(删除、整理、撤销分享等) */
|
|
84
|
+
export declare function canManage(role: Role): boolean;
|
|
85
|
+
/**
|
|
86
|
+
* 角色是否允许写入(上传、粘贴、创建分享等)。
|
|
87
|
+
*
|
|
88
|
+
* 未登录(guest)能否写入取决于是否配置了访客口令:
|
|
89
|
+
* - 没有配置访客口令:允许任何人上传下载,删除与整理仍需管理员口令
|
|
90
|
+
* - 配置了访客口令:未登录时必须先输入口令登录,才能上传下载
|
|
91
|
+
*/
|
|
92
|
+
export declare function canWrite(role: Role, visitorConfigured?: boolean): boolean;
|
|
93
|
+
export type { SecretKind };
|
|
94
|
+
export { SECRET_ITERATIONS };
|
|
@@ -0,0 +1,227 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.SECRET_ITERATIONS = void 0;
|
|
4
|
+
exports.createAuth = createAuth;
|
|
5
|
+
exports.canManage = canManage;
|
|
6
|
+
exports.canWrite = canWrite;
|
|
7
|
+
/*
|
|
8
|
+
* LocalSend 身份与权限
|
|
9
|
+
*
|
|
10
|
+
* 之前只有站点级的访问令牌(token):要么全站都要 key,要么全站敞开,
|
|
11
|
+
* 进来的人一律是管理员,删除、清理、撤销分享这些危险操作没有任何身份校验。
|
|
12
|
+
*
|
|
13
|
+
* 这里在令牌之下加一层身份,把危险动作的权限收回来:
|
|
14
|
+
*
|
|
15
|
+
* - 管理员(admin):用管理员口令登录,可以删除文件、整理目录、撤销分享
|
|
16
|
+
* - 访客(visitor):用访客口令登录,可以上传下载,但不能删除与整理
|
|
17
|
+
* - 只读(guest):未登录。没有配置访客口令时可以上传下载;
|
|
18
|
+
* 配置了访客口令则必须先输入口令
|
|
19
|
+
* - 开放(open):没有配置任何口令时的兼容模式,行为与以前完全一致
|
|
20
|
+
*
|
|
21
|
+
* 口令与令牌都不再走明文:客户端用服务端公开的盐值派生出摘要后提交,
|
|
22
|
+
* 服务端只保存摘要(见 secret.ts)。会话只存在内存里,服务重启即失效。
|
|
23
|
+
*/
|
|
24
|
+
const node_crypto_1 = require("node:crypto");
|
|
25
|
+
const secret_1 = require("./secret");
|
|
26
|
+
Object.defineProperty(exports, "SECRET_ITERATIONS", { enumerable: true, get: function () { return secret_1.SECRET_ITERATIONS; } });
|
|
27
|
+
function createAuth(options = {}) {
|
|
28
|
+
let password = options.password || '';
|
|
29
|
+
let visitorPassword = options.visitorPassword || '';
|
|
30
|
+
let token = options.token || '';
|
|
31
|
+
let ttl = options.sessionTtl ?? 24 * 60 * 60 * 1000;
|
|
32
|
+
/** 口令与令牌的摘要库 */
|
|
33
|
+
const secrets = (0, secret_1.createSecretStore)();
|
|
34
|
+
secrets.refresh('password', password);
|
|
35
|
+
secrets.refresh('visitorPassword', visitorPassword);
|
|
36
|
+
secrets.refresh('token', token);
|
|
37
|
+
/** token -> 会话 */
|
|
38
|
+
const sessions = new Map();
|
|
39
|
+
const cleanup = () => {
|
|
40
|
+
const now = Date.now();
|
|
41
|
+
let count = 0;
|
|
42
|
+
for (const [key, session] of sessions) {
|
|
43
|
+
if (session.expiresAt <= now) {
|
|
44
|
+
sessions.delete(key);
|
|
45
|
+
count += 1;
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
return count;
|
|
49
|
+
};
|
|
50
|
+
// 每 10 分钟清理一次过期会话
|
|
51
|
+
const timer = setInterval(cleanup, 10 * 60 * 1000);
|
|
52
|
+
timer.unref?.();
|
|
53
|
+
/** 未登录时的基础角色:没配置任何口令时是开放模式 */
|
|
54
|
+
const baseRole = () => (!password && !visitorPassword ? 'open' : 'guest');
|
|
55
|
+
/**
|
|
56
|
+
* 是否「完全不需要认证」。
|
|
57
|
+
*
|
|
58
|
+
* 访问令牌也算一种认证手段:只配了令牌时,所有接口都要求先验证令牌,
|
|
59
|
+
* 此时再说「开放模式,无需登录」就是自相矛盾。
|
|
60
|
+
*/
|
|
61
|
+
const isOpen = () => !password && !visitorPassword && !token;
|
|
62
|
+
/** 建立会话 */
|
|
63
|
+
const issue = (role, via) => {
|
|
64
|
+
const now = Date.now();
|
|
65
|
+
const session = { token: (0, node_crypto_1.randomBytes)(24).toString('base64url'), role, via, createdAt: now, expiresAt: now + ttl };
|
|
66
|
+
sessions.set(session.token, session);
|
|
67
|
+
return session;
|
|
68
|
+
};
|
|
69
|
+
return {
|
|
70
|
+
get open() {
|
|
71
|
+
return isOpen();
|
|
72
|
+
},
|
|
73
|
+
get hasAdmin() {
|
|
74
|
+
return !!password;
|
|
75
|
+
},
|
|
76
|
+
get hasVisitor() {
|
|
77
|
+
return !!visitorPassword;
|
|
78
|
+
},
|
|
79
|
+
get hasToken() {
|
|
80
|
+
return !!token;
|
|
81
|
+
},
|
|
82
|
+
secrets: () => secrets.list(),
|
|
83
|
+
login(digests) {
|
|
84
|
+
const input = digests || {};
|
|
85
|
+
// 管理员口令优先
|
|
86
|
+
if (input.password && secrets.verify('password', input.password))
|
|
87
|
+
return issue('admin', 'password');
|
|
88
|
+
if (input.visitorPassword && secrets.verify('visitorPassword', input.visitorPassword))
|
|
89
|
+
return issue('visitor', 'password');
|
|
90
|
+
// 访问令牌也走同一个入口:前端只显示一个输入框,
|
|
91
|
+
// 用户不必先分辨自己手里拿的是口令还是令牌
|
|
92
|
+
if (input.token && secrets.verify('token', input.token))
|
|
93
|
+
return issue(baseRole(), 'token');
|
|
94
|
+
return null;
|
|
95
|
+
},
|
|
96
|
+
loginByToken(digest) {
|
|
97
|
+
if (!secrets.verify('token', String(digest || '')))
|
|
98
|
+
return null;
|
|
99
|
+
// 令牌是站点级大门锁:没有配置口令时等同管理员,否则按访客口径
|
|
100
|
+
return issue(baseRole(), 'token');
|
|
101
|
+
},
|
|
102
|
+
logout(key) {
|
|
103
|
+
return sessions.delete(key);
|
|
104
|
+
},
|
|
105
|
+
get(key) {
|
|
106
|
+
if (!key)
|
|
107
|
+
return null;
|
|
108
|
+
const session = sessions.get(key);
|
|
109
|
+
if (!session)
|
|
110
|
+
return null;
|
|
111
|
+
if (session.expiresAt <= Date.now()) {
|
|
112
|
+
sessions.delete(key);
|
|
113
|
+
return null;
|
|
114
|
+
}
|
|
115
|
+
return session;
|
|
116
|
+
},
|
|
117
|
+
roleOf(key) {
|
|
118
|
+
// 没有配置任何认证手段时保持开放模式,行为与以前完全一致
|
|
119
|
+
if (isOpen())
|
|
120
|
+
return 'open';
|
|
121
|
+
const session = this.get(key);
|
|
122
|
+
if (!session)
|
|
123
|
+
return 'guest';
|
|
124
|
+
return session.role;
|
|
125
|
+
},
|
|
126
|
+
update(next, keepToken) {
|
|
127
|
+
let secretChanged = false;
|
|
128
|
+
let tokenChanged = false;
|
|
129
|
+
if (next.password !== undefined && next.password !== password) {
|
|
130
|
+
password = next.password || '';
|
|
131
|
+
secrets.refresh('password', password);
|
|
132
|
+
secretChanged = true;
|
|
133
|
+
}
|
|
134
|
+
if (next.visitorPassword !== undefined && next.visitorPassword !== visitorPassword) {
|
|
135
|
+
visitorPassword = next.visitorPassword || '';
|
|
136
|
+
secrets.refresh('visitorPassword', visitorPassword);
|
|
137
|
+
secretChanged = true;
|
|
138
|
+
}
|
|
139
|
+
if (next.token !== undefined && next.token !== token) {
|
|
140
|
+
token = next.token || '';
|
|
141
|
+
secrets.refresh('token', token);
|
|
142
|
+
tokenChanged = true;
|
|
143
|
+
}
|
|
144
|
+
if (next.sessionTtl !== undefined && next.sessionTtl > 0) {
|
|
145
|
+
ttl = next.sessionTtl;
|
|
146
|
+
}
|
|
147
|
+
// 口令变了:此前的会话全部失效,当前会话(keepToken)保留
|
|
148
|
+
if (secretChanged) {
|
|
149
|
+
for (const key of [...sessions.keys()]) {
|
|
150
|
+
if (key === keepToken)
|
|
151
|
+
continue;
|
|
152
|
+
sessions.delete(key);
|
|
153
|
+
}
|
|
154
|
+
}
|
|
155
|
+
// 令牌变了:只作废「用令牌换来的会话」,口令登录的会话继续有效
|
|
156
|
+
if (tokenChanged) {
|
|
157
|
+
for (const [key, session] of [...sessions.entries()]) {
|
|
158
|
+
if (key === keepToken)
|
|
159
|
+
continue;
|
|
160
|
+
if (session.via === 'token')
|
|
161
|
+
sessions.delete(key);
|
|
162
|
+
}
|
|
163
|
+
}
|
|
164
|
+
},
|
|
165
|
+
verifyAdmin(digest) {
|
|
166
|
+
if (!password)
|
|
167
|
+
return true;
|
|
168
|
+
return secrets.verify('password', String(digest || ''));
|
|
169
|
+
},
|
|
170
|
+
verifyPlain(plaintext) {
|
|
171
|
+
const value = String(plaintext ?? '');
|
|
172
|
+
if (!value)
|
|
173
|
+
return null;
|
|
174
|
+
if (secrets.verify('password', secrets.digestOf('password', value)))
|
|
175
|
+
return 'password';
|
|
176
|
+
if (secrets.verify('visitorPassword', secrets.digestOf('visitorPassword', value)))
|
|
177
|
+
return 'visitorPassword';
|
|
178
|
+
if (secrets.verify('token', secrets.digestOf('token', value)))
|
|
179
|
+
return 'token';
|
|
180
|
+
return null;
|
|
181
|
+
},
|
|
182
|
+
plainRole(plaintext) {
|
|
183
|
+
const kind = this.verifyPlain(plaintext);
|
|
184
|
+
if (kind === 'password')
|
|
185
|
+
return 'admin';
|
|
186
|
+
if (kind === 'visitorPassword')
|
|
187
|
+
return 'visitor';
|
|
188
|
+
if (kind === 'token')
|
|
189
|
+
return baseRole();
|
|
190
|
+
return null;
|
|
191
|
+
},
|
|
192
|
+
verifyToken(digest) {
|
|
193
|
+
return secrets.verify('token', String(digest || ''));
|
|
194
|
+
},
|
|
195
|
+
verifyTokenValue(presented) {
|
|
196
|
+
const value = String(presented || '');
|
|
197
|
+
if (!value)
|
|
198
|
+
return false;
|
|
199
|
+
// 摘要形式(脚本客户端)
|
|
200
|
+
if (secrets.verify('token', value))
|
|
201
|
+
return true;
|
|
202
|
+
// 明文形式(WebDAV 客户端只能传明文)
|
|
203
|
+
return secrets.verify('token', secrets.digestOf('token', value));
|
|
204
|
+
},
|
|
205
|
+
cleanup,
|
|
206
|
+
stop() {
|
|
207
|
+
clearInterval(timer);
|
|
208
|
+
},
|
|
209
|
+
};
|
|
210
|
+
}
|
|
211
|
+
/** 角色是否允许执行危险操作(删除、整理、撤销分享等) */
|
|
212
|
+
function canManage(role) {
|
|
213
|
+
return role === 'admin' || role === 'open';
|
|
214
|
+
}
|
|
215
|
+
/**
|
|
216
|
+
* 角色是否允许写入(上传、粘贴、创建分享等)。
|
|
217
|
+
*
|
|
218
|
+
* 未登录(guest)能否写入取决于是否配置了访客口令:
|
|
219
|
+
* - 没有配置访客口令:允许任何人上传下载,删除与整理仍需管理员口令
|
|
220
|
+
* - 配置了访客口令:未登录时必须先输入口令登录,才能上传下载
|
|
221
|
+
*/
|
|
222
|
+
function canWrite(role, visitorConfigured = false) {
|
|
223
|
+
if (role === 'admin' || role === 'visitor' || role === 'open')
|
|
224
|
+
return true;
|
|
225
|
+
// guest:没有访客口令时开放上传
|
|
226
|
+
return !visitorConfigured;
|
|
227
|
+
}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
import { type FileEntry } from './path';
|
|
2
|
+
export interface ListCacheOptions {
|
|
3
|
+
/** 存储目录 */
|
|
4
|
+
dir: string;
|
|
5
|
+
/** 缓存有效期(毫秒)。超过后强制全量重扫,默认 5 分钟 */
|
|
6
|
+
ttl?: number;
|
|
7
|
+
/** 是否启用 fs.watch 增量更新,默认开启 */
|
|
8
|
+
watchEnabled?: boolean;
|
|
9
|
+
/** 过滤函数:返回 false 的条目不进入缓存 */
|
|
10
|
+
filter?: (relPath: string) => boolean;
|
|
11
|
+
/** 变更回调:文件新增或内容变化时触发,参数为发生变化的相对路径 */
|
|
12
|
+
onChange?: (names: string[]) => void;
|
|
13
|
+
}
|
|
14
|
+
export interface ListCache {
|
|
15
|
+
/** 获取文件列表(命中缓存则直接返回) */
|
|
16
|
+
list(): FileEntry[];
|
|
17
|
+
/** 强制刷新缓存 */
|
|
18
|
+
refresh(): FileEntry[];
|
|
19
|
+
/** 使缓存失效,下次访问时重新扫描 */
|
|
20
|
+
invalidate(): void;
|
|
21
|
+
/** 启动目录监听(用于主动感知变更,不依赖列表请求) */
|
|
22
|
+
startWatch(): void;
|
|
23
|
+
/** 缓存统计信息 */
|
|
24
|
+
stats(): {
|
|
25
|
+
entries: number;
|
|
26
|
+
hits: number;
|
|
27
|
+
misses: number;
|
|
28
|
+
watching: boolean;
|
|
29
|
+
lastScan: number;
|
|
30
|
+
};
|
|
31
|
+
/** 停止监听 */
|
|
32
|
+
stop(): void;
|
|
33
|
+
}
|
|
34
|
+
export declare function createListCache(options: ListCacheOptions): ListCache;
|