@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,285 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.RESTART_REQUIRED_KEYS = exports.SETTING_DEFS = void 0;
|
|
4
|
+
exports.resolveSettingsFile = resolveSettingsFile;
|
|
5
|
+
exports.normalizeSetting = normalizeSetting;
|
|
6
|
+
exports.createSettingsStore = createSettingsStore;
|
|
7
|
+
/*
|
|
8
|
+
* LocalSend 运行时设置
|
|
9
|
+
*
|
|
10
|
+
* 配置文件(ss.config.js)里的设置要改完再重启才生效,
|
|
11
|
+
* 而局域网里的这台机器未必方便远程登录去改文件。
|
|
12
|
+
* 这里把「允许运行时修改」的设置单独存成一份 JSON,
|
|
13
|
+
* 管理员在网页端验证身份后即可修改,改完立即生效。
|
|
14
|
+
*
|
|
15
|
+
* 优先级:配置文件 < 运行时设置。
|
|
16
|
+
*
|
|
17
|
+
* 若配置文件里的对应项被改过(与上次修改运行时设置时的基准值不同),
|
|
18
|
+
* 说明用户更希望以配置文件为准,此时自动放弃该项的运行时覆盖,
|
|
19
|
+
* 避免「改了配置文件却没生效」这种困惑。
|
|
20
|
+
*/
|
|
21
|
+
const node_fs_1 = require("node:fs");
|
|
22
|
+
const node_path_1 = require("node:path");
|
|
23
|
+
const config_1 = require("../config");
|
|
24
|
+
/** 各配置项的元信息,网页端按这份定义渲染表单 */
|
|
25
|
+
exports.SETTING_DEFS = {
|
|
26
|
+
token: {
|
|
27
|
+
label: '访问令牌',
|
|
28
|
+
kind: 'secret',
|
|
29
|
+
desc: '启用后,访问页面时需要输入令牌换取会话。令牌不再出现在地址栏里,修改后旧令牌立即失效。',
|
|
30
|
+
secret: true,
|
|
31
|
+
},
|
|
32
|
+
password: {
|
|
33
|
+
label: '管理员口令',
|
|
34
|
+
kind: 'secret',
|
|
35
|
+
desc: '删除文件、整理目录、撤销分享等危险操作需要它。留空表示不启用口令(回到开放模式)。',
|
|
36
|
+
secret: true,
|
|
37
|
+
},
|
|
38
|
+
visitorPassword: {
|
|
39
|
+
label: '访客口令',
|
|
40
|
+
kind: 'secret',
|
|
41
|
+
desc: '设置后,未登录的人必须输入该口令才能上传下载;留空则任何人都可以上传下载(删除与整理始终需要管理员口令)。',
|
|
42
|
+
secret: true,
|
|
43
|
+
},
|
|
44
|
+
sessionTtl: {
|
|
45
|
+
label: '会话有效期',
|
|
46
|
+
kind: 'number',
|
|
47
|
+
unit: '毫秒',
|
|
48
|
+
min: 60_000,
|
|
49
|
+
max: 30 * 24 * 60 * 60 * 1000,
|
|
50
|
+
desc: '登录后保持有效的时长,默认 24 小时。',
|
|
51
|
+
},
|
|
52
|
+
maxSize: {
|
|
53
|
+
label: '单文件大小上限',
|
|
54
|
+
kind: 'number',
|
|
55
|
+
unit: '字节',
|
|
56
|
+
min: 0,
|
|
57
|
+
max: 1024 * 1024 * 1024 * 1024,
|
|
58
|
+
desc: '单个文件允许上传的最大体积,0 表示不限制。',
|
|
59
|
+
},
|
|
60
|
+
maxTotalSize: {
|
|
61
|
+
label: '存储容量上限',
|
|
62
|
+
kind: 'number',
|
|
63
|
+
unit: '字节',
|
|
64
|
+
min: 0,
|
|
65
|
+
max: 1024 * 1024 * 1024 * 1024,
|
|
66
|
+
desc: '存储目录总容量上限,0 表示不限制。',
|
|
67
|
+
},
|
|
68
|
+
maxConcurrent: {
|
|
69
|
+
label: '并发上传数',
|
|
70
|
+
kind: 'number',
|
|
71
|
+
unit: '个/IP',
|
|
72
|
+
min: 0,
|
|
73
|
+
max: 100,
|
|
74
|
+
desc: '单个 IP 同时进行的上传数上限,0 表示不限制。',
|
|
75
|
+
},
|
|
76
|
+
rateLimit: {
|
|
77
|
+
label: '请求频率限制',
|
|
78
|
+
kind: 'rate',
|
|
79
|
+
desc: '单个 IP 在滑动窗口内的最大请求数,0 表示不限制。',
|
|
80
|
+
},
|
|
81
|
+
blockExtensions: {
|
|
82
|
+
label: '禁止上传的扩展名',
|
|
83
|
+
kind: 'numberList',
|
|
84
|
+
desc: '列出后缀名(如 .php),命中则拒绝上传。留空表示不拦截。',
|
|
85
|
+
},
|
|
86
|
+
trashDays: {
|
|
87
|
+
label: '回收站保留天数',
|
|
88
|
+
kind: 'number',
|
|
89
|
+
unit: '天',
|
|
90
|
+
min: 0,
|
|
91
|
+
max: 3650,
|
|
92
|
+
desc: '删除的文件在回收站保留多久,到期自动清理。',
|
|
93
|
+
},
|
|
94
|
+
autoCleanDays: {
|
|
95
|
+
label: '自动清理天数',
|
|
96
|
+
kind: 'number',
|
|
97
|
+
unit: '天',
|
|
98
|
+
min: 0,
|
|
99
|
+
max: 3650,
|
|
100
|
+
desc: '超过该天数的文件自动删除,0 表示关闭。',
|
|
101
|
+
},
|
|
102
|
+
autoCleanMaxSize: {
|
|
103
|
+
label: '自动清理容量上限',
|
|
104
|
+
kind: 'number',
|
|
105
|
+
unit: '字节',
|
|
106
|
+
min: 0,
|
|
107
|
+
max: 1024 * 1024 * 1024 * 1024,
|
|
108
|
+
desc: '存储目录超过该容量时,从最旧的文件开始删除,0 表示关闭。',
|
|
109
|
+
},
|
|
110
|
+
};
|
|
111
|
+
/** 需要重启服务才能生效的配置项(仅作展示,不可修改) */
|
|
112
|
+
exports.RESTART_REQUIRED_KEYS = ['dir', 'webdav'];
|
|
113
|
+
/** 运行时设置文件的默认位置:用户级配置目录下 */
|
|
114
|
+
function resolveSettingsFile() {
|
|
115
|
+
return process.env.SS_LOCALSEND_SETTINGS || (0, node_path_1.join)((0, config_1.getUserConfigDir)(), 'localsend-settings.json');
|
|
116
|
+
}
|
|
117
|
+
/**
|
|
118
|
+
* 校验并规范化一个配置项的取值。
|
|
119
|
+
* 返回 error 表示取值不合法;返回 value 表示规范化后的值。
|
|
120
|
+
*/
|
|
121
|
+
function normalizeSetting(key, raw) {
|
|
122
|
+
const def = exports.SETTING_DEFS[key];
|
|
123
|
+
switch (def.kind) {
|
|
124
|
+
case 'secret': {
|
|
125
|
+
if (raw === null || raw === undefined)
|
|
126
|
+
return { value: '' };
|
|
127
|
+
const text = String(raw);
|
|
128
|
+
if (text.length > 512)
|
|
129
|
+
return { error: `${def.label}过长(最多 512 个字符)` };
|
|
130
|
+
return { value: text };
|
|
131
|
+
}
|
|
132
|
+
case 'number': {
|
|
133
|
+
const num = Number(raw);
|
|
134
|
+
if (!Number.isFinite(num))
|
|
135
|
+
return { error: `${def.label}必须是数字` };
|
|
136
|
+
if (def.min !== undefined && num < def.min)
|
|
137
|
+
return { error: `${def.label}不能小于 ${def.min}` };
|
|
138
|
+
if (def.max !== undefined && num > def.max)
|
|
139
|
+
return { error: `${def.label}不能大于 ${def.max}` };
|
|
140
|
+
return { value: Math.floor(num) };
|
|
141
|
+
}
|
|
142
|
+
case 'numberList': {
|
|
143
|
+
if (raw === null || raw === undefined || raw === '')
|
|
144
|
+
return { value: [] };
|
|
145
|
+
const list = Array.isArray(raw) ? raw : String(raw).split(/[,,\s]+/);
|
|
146
|
+
const out = [];
|
|
147
|
+
for (const item of list) {
|
|
148
|
+
const text = String(item).trim().toLowerCase();
|
|
149
|
+
if (!text)
|
|
150
|
+
continue;
|
|
151
|
+
const ext = text.startsWith('.') ? text : `.${text}`;
|
|
152
|
+
if (!/^\.[a-z0-9]{1,16}$/.test(ext))
|
|
153
|
+
return { error: `「${text}」不是合法的扩展名` };
|
|
154
|
+
if (!out.includes(ext))
|
|
155
|
+
out.push(ext);
|
|
156
|
+
}
|
|
157
|
+
if (out.length > 100)
|
|
158
|
+
return { error: '最多允许 100 个扩展名' };
|
|
159
|
+
return { value: out };
|
|
160
|
+
}
|
|
161
|
+
case 'rate': {
|
|
162
|
+
const src = (raw || {});
|
|
163
|
+
const windowMs = Number(src.windowMs ?? 60_000);
|
|
164
|
+
const max = Number(src.max ?? 120);
|
|
165
|
+
if (!Number.isFinite(windowMs) || windowMs < 1000)
|
|
166
|
+
return { error: '频率限制的窗口不能小于 1000 毫秒' };
|
|
167
|
+
if (!Number.isFinite(max) || max < 0)
|
|
168
|
+
return { error: '频率限制的次数不能为负数' };
|
|
169
|
+
return { value: { windowMs: Math.floor(windowMs), max: Math.floor(max) } };
|
|
170
|
+
}
|
|
171
|
+
default:
|
|
172
|
+
return { error: '未知的配置项' };
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
/** 两个值是否相等(用于比较基准值) */
|
|
176
|
+
function sameValue(a, b) {
|
|
177
|
+
if (a === b)
|
|
178
|
+
return true;
|
|
179
|
+
if (a === undefined || a === null || b === undefined || b === null)
|
|
180
|
+
return !a && !b;
|
|
181
|
+
if (Array.isArray(a) && Array.isArray(b))
|
|
182
|
+
return a.length === b.length && a.every((v, i) => v === b[i]);
|
|
183
|
+
if (typeof a === 'object' && typeof b === 'object') {
|
|
184
|
+
const ka = Object.keys(a);
|
|
185
|
+
const kb = Object.keys(b);
|
|
186
|
+
if (ka.length !== kb.length)
|
|
187
|
+
return false;
|
|
188
|
+
return ka.every((k) => sameValue(a[k], b[k]));
|
|
189
|
+
}
|
|
190
|
+
return false;
|
|
191
|
+
}
|
|
192
|
+
function createSettingsStore(file = resolveSettingsFile()) {
|
|
193
|
+
let data = { updatedAt: 0, values: {}, bases: {} };
|
|
194
|
+
/** 把数据落盘(先写临时文件再改名,避免写一半被读到) */
|
|
195
|
+
function save() {
|
|
196
|
+
try {
|
|
197
|
+
if (!(0, node_fs_1.existsSync)((0, node_path_1.dirname)(file)))
|
|
198
|
+
(0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(file), { recursive: true });
|
|
199
|
+
const tmp = `${file}.tmp`;
|
|
200
|
+
(0, node_fs_1.writeFileSync)(tmp, JSON.stringify(data, null, 2), 'utf8');
|
|
201
|
+
(0, node_fs_1.renameSync)(tmp, file);
|
|
202
|
+
}
|
|
203
|
+
catch {
|
|
204
|
+
// 落盘失败不影响服务内存中的生效值
|
|
205
|
+
}
|
|
206
|
+
}
|
|
207
|
+
const store = {
|
|
208
|
+
file,
|
|
209
|
+
load() {
|
|
210
|
+
data = { updatedAt: 0, values: {}, bases: {} };
|
|
211
|
+
if (!(0, node_fs_1.existsSync)(file))
|
|
212
|
+
return;
|
|
213
|
+
try {
|
|
214
|
+
const parsed = JSON.parse((0, node_fs_1.readFileSync)(file, 'utf8'));
|
|
215
|
+
if (!parsed || typeof parsed !== 'object')
|
|
216
|
+
return;
|
|
217
|
+
const values = (parsed.values || {});
|
|
218
|
+
const bases = (parsed.bases || {});
|
|
219
|
+
for (const key of Object.keys(values)) {
|
|
220
|
+
if (!(key in exports.SETTING_DEFS))
|
|
221
|
+
continue;
|
|
222
|
+
data.values[key] = values[key];
|
|
223
|
+
data.bases[key] = bases[key];
|
|
224
|
+
}
|
|
225
|
+
data.updatedAt = Number(parsed.updatedAt) || 0;
|
|
226
|
+
}
|
|
227
|
+
catch {
|
|
228
|
+
// 文件损坏时按没有覆盖处理
|
|
229
|
+
data = { updatedAt: 0, values: {}, bases: {} };
|
|
230
|
+
}
|
|
231
|
+
},
|
|
232
|
+
apply(base) {
|
|
233
|
+
const out = { ...base };
|
|
234
|
+
let dropped = false;
|
|
235
|
+
for (const key of Object.keys(data.values)) {
|
|
236
|
+
if (!(key in exports.SETTING_DEFS))
|
|
237
|
+
continue;
|
|
238
|
+
// 配置文件里这一项被改过 → 以配置文件为准,放弃运行时覆盖
|
|
239
|
+
if (!sameValue(out[key], data.bases[key])) {
|
|
240
|
+
delete data.values[key];
|
|
241
|
+
delete data.bases[key];
|
|
242
|
+
dropped = true;
|
|
243
|
+
continue;
|
|
244
|
+
}
|
|
245
|
+
out[key] = data.values[key];
|
|
246
|
+
}
|
|
247
|
+
// 丢弃的覆盖项要同步落盘,避免下次启动重复判断
|
|
248
|
+
if (dropped)
|
|
249
|
+
save();
|
|
250
|
+
return out;
|
|
251
|
+
},
|
|
252
|
+
set(key, value, baseValue) {
|
|
253
|
+
if (value === undefined) {
|
|
254
|
+
store.clear(key);
|
|
255
|
+
return;
|
|
256
|
+
}
|
|
257
|
+
data.values[key] = value;
|
|
258
|
+
data.bases[key] = baseValue;
|
|
259
|
+
data.updatedAt = Date.now();
|
|
260
|
+
save();
|
|
261
|
+
},
|
|
262
|
+
clear(key) {
|
|
263
|
+
if (!(key in data.values))
|
|
264
|
+
return;
|
|
265
|
+
delete data.values[key];
|
|
266
|
+
delete data.bases[key];
|
|
267
|
+
data.updatedAt = Date.now();
|
|
268
|
+
save();
|
|
269
|
+
},
|
|
270
|
+
effective(base, key) {
|
|
271
|
+
const merged = store.apply(base);
|
|
272
|
+
return merged[key];
|
|
273
|
+
},
|
|
274
|
+
source(key) {
|
|
275
|
+
return key in data.values ? 'runtime' : 'config';
|
|
276
|
+
},
|
|
277
|
+
overridden() {
|
|
278
|
+
return Object.keys(data.values);
|
|
279
|
+
},
|
|
280
|
+
flush() {
|
|
281
|
+
save();
|
|
282
|
+
},
|
|
283
|
+
};
|
|
284
|
+
return store;
|
|
285
|
+
}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
/** 判断分享的文件能否内联打开 */
|
|
2
|
+
export declare function shareInlineType(rel: string): 'text' | 'image' | null;
|
|
3
|
+
/** 内联打开时使用的 Content-Type */
|
|
4
|
+
export declare function shareInlineMime(rel: string): string;
|
|
5
|
+
export interface ShareEntry {
|
|
6
|
+
/** 分享的相对路径列表,单个文件直接下载,多个文件打成 zip */
|
|
7
|
+
names: string[];
|
|
8
|
+
/** 创建时间 */
|
|
9
|
+
createdAt: number;
|
|
10
|
+
/** 过期时间戳 */
|
|
11
|
+
expiresAt: number;
|
|
12
|
+
/** 下载次数 */
|
|
13
|
+
hits: number;
|
|
14
|
+
}
|
|
15
|
+
export interface ShareStore {
|
|
16
|
+
/** 创建分享,返回令牌 */
|
|
17
|
+
create: (names: string[], ttlMs?: number) => {
|
|
18
|
+
token: string;
|
|
19
|
+
entry: ShareEntry;
|
|
20
|
+
};
|
|
21
|
+
/** 按令牌取分享,已过期返回 null */
|
|
22
|
+
get: (token: string) => ShareEntry | null;
|
|
23
|
+
/** 列出未过期的分享 */
|
|
24
|
+
list: () => {
|
|
25
|
+
token: string;
|
|
26
|
+
entry: ShareEntry;
|
|
27
|
+
}[];
|
|
28
|
+
/** 撤销某个分享 */
|
|
29
|
+
revoke: (token: string) => boolean;
|
|
30
|
+
/** 清理过期分享 */
|
|
31
|
+
cleanup: () => number;
|
|
32
|
+
/** 停止定时清理(进程退出或测试收尾时调用) */
|
|
33
|
+
stop: () => void;
|
|
34
|
+
}
|
|
35
|
+
export declare function createShareStore(): ShareStore;
|
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.shareInlineType = shareInlineType;
|
|
4
|
+
exports.shareInlineMime = shareInlineMime;
|
|
5
|
+
exports.createShareStore = createShareStore;
|
|
6
|
+
/*
|
|
7
|
+
* LocalSend 分享链接
|
|
8
|
+
*
|
|
9
|
+
* 生成带时效的一次性分享令牌,拿到链接的人无需访问令牌即可下载指定文件。
|
|
10
|
+
* 令牌只存在内存中,服务重启即失效;到期自动失效。
|
|
11
|
+
*/
|
|
12
|
+
const node_crypto_1 = require("node:crypto");
|
|
13
|
+
const node_path_1 = require("node:path");
|
|
14
|
+
/**
|
|
15
|
+
* 可以直接在浏览器里打开的文本类型。
|
|
16
|
+
*
|
|
17
|
+
* html / svg 刻意不在其中:内联返回会让对方页面里的脚本
|
|
18
|
+
* 以本站源执行(同源 XSS),文件仍走下载。
|
|
19
|
+
*/
|
|
20
|
+
const INLINE_TEXT_EXT = new Set([
|
|
21
|
+
'txt',
|
|
22
|
+
'md',
|
|
23
|
+
'markdown',
|
|
24
|
+
'json',
|
|
25
|
+
'log',
|
|
26
|
+
'csv',
|
|
27
|
+
'tsv',
|
|
28
|
+
'js',
|
|
29
|
+
'ts',
|
|
30
|
+
'css',
|
|
31
|
+
'xml',
|
|
32
|
+
'yml',
|
|
33
|
+
'yaml',
|
|
34
|
+
'ini',
|
|
35
|
+
'conf',
|
|
36
|
+
'env',
|
|
37
|
+
'sh',
|
|
38
|
+
'py',
|
|
39
|
+
'go',
|
|
40
|
+
'rs',
|
|
41
|
+
'sql',
|
|
42
|
+
'toml',
|
|
43
|
+
]);
|
|
44
|
+
/** 可以直接内联显示的图片类型 */
|
|
45
|
+
const INLINE_IMAGE_EXT = new Set(['png', 'jpg', 'jpeg', 'gif', 'webp', 'bmp', 'avif']);
|
|
46
|
+
/** 判断分享的文件能否内联打开 */
|
|
47
|
+
function shareInlineType(rel) {
|
|
48
|
+
const ext = (0, node_path_1.extname)(rel).slice(1).toLowerCase();
|
|
49
|
+
if (INLINE_TEXT_EXT.has(ext))
|
|
50
|
+
return 'text';
|
|
51
|
+
if (INLINE_IMAGE_EXT.has(ext))
|
|
52
|
+
return 'image';
|
|
53
|
+
return null;
|
|
54
|
+
}
|
|
55
|
+
/** 内联打开时使用的 Content-Type */
|
|
56
|
+
function shareInlineMime(rel) {
|
|
57
|
+
const ext = (0, node_path_1.extname)(rel).slice(1).toLowerCase();
|
|
58
|
+
const map = {
|
|
59
|
+
png: 'image/png',
|
|
60
|
+
jpg: 'image/jpeg',
|
|
61
|
+
jpeg: 'image/jpeg',
|
|
62
|
+
gif: 'image/gif',
|
|
63
|
+
webp: 'image/webp',
|
|
64
|
+
bmp: 'image/bmp',
|
|
65
|
+
avif: 'image/avif',
|
|
66
|
+
};
|
|
67
|
+
return map[ext] ?? 'text/plain; charset=utf-8';
|
|
68
|
+
}
|
|
69
|
+
function createShareStore() {
|
|
70
|
+
const shares = new Map();
|
|
71
|
+
const cleanup = () => {
|
|
72
|
+
const now = Date.now();
|
|
73
|
+
let count = 0;
|
|
74
|
+
for (const [token, entry] of shares) {
|
|
75
|
+
if (entry.expiresAt <= now) {
|
|
76
|
+
shares.delete(token);
|
|
77
|
+
count++;
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
return count;
|
|
81
|
+
};
|
|
82
|
+
// 每 10 分钟清理一次过期分享
|
|
83
|
+
const timer = setInterval(cleanup, 10 * 60 * 1000);
|
|
84
|
+
timer.unref?.();
|
|
85
|
+
return {
|
|
86
|
+
create(names, ttlMs = 24 * 60 * 60 * 1000) {
|
|
87
|
+
cleanup();
|
|
88
|
+
const token = (0, node_crypto_1.randomBytes)(16).toString('base64url');
|
|
89
|
+
const now = Date.now();
|
|
90
|
+
const entry = { names, createdAt: now, expiresAt: now + ttlMs, hits: 0 };
|
|
91
|
+
shares.set(token, entry);
|
|
92
|
+
return { token, entry };
|
|
93
|
+
},
|
|
94
|
+
get(token) {
|
|
95
|
+
const entry = shares.get(token);
|
|
96
|
+
if (!entry)
|
|
97
|
+
return null;
|
|
98
|
+
if (entry.expiresAt <= Date.now()) {
|
|
99
|
+
shares.delete(token);
|
|
100
|
+
return null;
|
|
101
|
+
}
|
|
102
|
+
entry.hits++;
|
|
103
|
+
return entry;
|
|
104
|
+
},
|
|
105
|
+
list() {
|
|
106
|
+
cleanup();
|
|
107
|
+
return [...shares.entries()].map(([token, entry]) => ({ token, entry }));
|
|
108
|
+
},
|
|
109
|
+
revoke(token) {
|
|
110
|
+
return shares.delete(token);
|
|
111
|
+
},
|
|
112
|
+
cleanup,
|
|
113
|
+
stop() {
|
|
114
|
+
clearInterval(timer);
|
|
115
|
+
},
|
|
116
|
+
};
|
|
117
|
+
}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
/** multer 落盘时的临时文件名(32 位十六进制) */
|
|
2
|
+
export declare const TEMP_FILE_RE: RegExp;
|
|
3
|
+
/** 判断是否为上传临时文件 */
|
|
4
|
+
export declare function isTempFileName(name: string): boolean;
|
|
5
|
+
/**
|
|
6
|
+
* 清理上传残留的临时文件。
|
|
7
|
+
* 只清理早于 minAge 的临时文件,避免误删正在上传中的文件。
|
|
8
|
+
* 返回被删除的文件名列表。
|
|
9
|
+
*/
|
|
10
|
+
export declare function cleanupTempFiles(target: string, minAge?: number): string[];
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.TEMP_FILE_RE = void 0;
|
|
4
|
+
exports.isTempFileName = isTempFileName;
|
|
5
|
+
exports.cleanupTempFiles = cleanupTempFiles;
|
|
6
|
+
/*
|
|
7
|
+
* LocalSend 上传临时文件处理
|
|
8
|
+
*
|
|
9
|
+
* multer 落盘时会先写入一个 32 位十六进制的随机临时文件,成功后再重命名为用户文件名。
|
|
10
|
+
* 若客户端中途断开或改名失败,这些临时文件会残留在存储目录里,
|
|
11
|
+
* 并且会作为"文件"出现在文件列表中(无扩展名、名字是一串哈希)。
|
|
12
|
+
*/
|
|
13
|
+
const node_fs_1 = require("node:fs");
|
|
14
|
+
const node_path_1 = require("node:path");
|
|
15
|
+
/** multer 落盘时的临时文件名(32 位十六进制) */
|
|
16
|
+
exports.TEMP_FILE_RE = /^[0-9a-f]{32}$/i;
|
|
17
|
+
/** 判断是否为上传临时文件 */
|
|
18
|
+
function isTempFileName(name) {
|
|
19
|
+
return exports.TEMP_FILE_RE.test(name);
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* 清理上传残留的临时文件。
|
|
23
|
+
* 只清理早于 minAge 的临时文件,避免误删正在上传中的文件。
|
|
24
|
+
* 返回被删除的文件名列表。
|
|
25
|
+
*/
|
|
26
|
+
function cleanupTempFiles(target, minAge = 60 * 60 * 1000) {
|
|
27
|
+
const removed = [];
|
|
28
|
+
if (!(0, node_fs_1.existsSync)(target))
|
|
29
|
+
return removed;
|
|
30
|
+
const now = Date.now();
|
|
31
|
+
for (const name of (0, node_fs_1.readdirSync)(target)) {
|
|
32
|
+
if (!isTempFileName(name))
|
|
33
|
+
continue;
|
|
34
|
+
const full = (0, node_path_1.join)(target, name);
|
|
35
|
+
try {
|
|
36
|
+
const stat = (0, node_fs_1.statSync)(full);
|
|
37
|
+
if (!stat.isFile() || now - stat.mtimeMs < minAge)
|
|
38
|
+
continue;
|
|
39
|
+
(0, node_fs_1.rmSync)(full);
|
|
40
|
+
removed.push(name);
|
|
41
|
+
}
|
|
42
|
+
catch {
|
|
43
|
+
// 文件可能刚被清理或正在写入,跳过
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
return removed;
|
|
47
|
+
}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
/** 票据用途 */
|
|
2
|
+
export type TicketScope = 'download' | 'preview' | 'zip' | 'events';
|
|
3
|
+
/** 一张票据 */
|
|
4
|
+
export interface TicketEntry {
|
|
5
|
+
/** 票据令牌 */
|
|
6
|
+
token: string;
|
|
7
|
+
/** 用途 */
|
|
8
|
+
scope: TicketScope;
|
|
9
|
+
/** 允许访问的文件相对路径;事件流为空数组 */
|
|
10
|
+
names: string[];
|
|
11
|
+
/** 过期时间戳 */
|
|
12
|
+
expiresAt: number;
|
|
13
|
+
}
|
|
14
|
+
export interface TicketStoreOptions {
|
|
15
|
+
/** 文件类票据的有效期(毫秒),默认 2 分钟 */
|
|
16
|
+
ttl?: number;
|
|
17
|
+
/** 事件流票据的有效期(毫秒),默认 30 分钟 */
|
|
18
|
+
eventsTtl?: number;
|
|
19
|
+
/** 同时存在的票据上限,超过后淘汰最早过期的 */
|
|
20
|
+
max?: number;
|
|
21
|
+
}
|
|
22
|
+
export interface TicketStore {
|
|
23
|
+
/** 签发一张票据 */
|
|
24
|
+
issue: (scope: TicketScope, names?: string[], ttlMs?: number) => TicketEntry;
|
|
25
|
+
/** 取票据;用途不匹配或已过期返回 null */
|
|
26
|
+
get: (token: string, scope?: TicketScope) => TicketEntry | null;
|
|
27
|
+
/** 票据是否允许访问该文件 */
|
|
28
|
+
allows: (entry: TicketEntry, rel: string) => boolean;
|
|
29
|
+
/** 清理过期票据,返回清理数量 */
|
|
30
|
+
cleanup: () => number;
|
|
31
|
+
/** 当前票据数量(用于测试与诊断) */
|
|
32
|
+
size: () => number;
|
|
33
|
+
/** 停止定时清理 */
|
|
34
|
+
stop: () => void;
|
|
35
|
+
}
|
|
36
|
+
/** 文件类票据默认有效期:够页面加载资源,又不足以被反复利用 */
|
|
37
|
+
export declare const TICKET_TTL: number;
|
|
38
|
+
/** 事件流票据有效期:EventSource 会长时间挂着,需要比文件票据长 */
|
|
39
|
+
export declare const TICKET_EVENTS_TTL: number;
|
|
40
|
+
export declare function createTicketStore(options?: TicketStoreOptions): TicketStore;
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.TICKET_EVENTS_TTL = exports.TICKET_TTL = void 0;
|
|
4
|
+
exports.createTicketStore = createTicketStore;
|
|
5
|
+
/*
|
|
6
|
+
* LocalSend 短期访问票据
|
|
7
|
+
*
|
|
8
|
+
* 下载、预览、打包、事件流这几类请求没法带自定义请求头:
|
|
9
|
+
* <img src>、<video src>、<a download>、EventSource 都只能给一个 URL。
|
|
10
|
+
* 之前的做法是把会话令牌拼在 URL 上(?session=),于是一个「复制链接」动作
|
|
11
|
+
* 就把自己的会话发给了别人,URL 还会留在浏览器历史与网关日志里。
|
|
12
|
+
*
|
|
13
|
+
* 这里改为「先换票、再用票访问」:
|
|
14
|
+
* - 票据只对指定的几个文件(或事件流)有效,不能拿去访问别的路径
|
|
15
|
+
* - 有效期很短(默认 2 分钟;事件流 30 分钟),过期即失效
|
|
16
|
+
* - 票据不携带任何身份信息,泄露的影响面远小于会话令牌
|
|
17
|
+
* - 不消费(可重复使用),因为视频拖动进度条、断点下载都会多次请求同一 URL
|
|
18
|
+
*/
|
|
19
|
+
const node_crypto_1 = require("node:crypto");
|
|
20
|
+
/** 文件类票据默认有效期:够页面加载资源,又不足以被反复利用 */
|
|
21
|
+
exports.TICKET_TTL = 2 * 60 * 1000;
|
|
22
|
+
/** 事件流票据有效期:EventSource 会长时间挂着,需要比文件票据长 */
|
|
23
|
+
exports.TICKET_EVENTS_TTL = 30 * 60 * 1000;
|
|
24
|
+
/** 同时存在的票据上限 */
|
|
25
|
+
const MAX_TICKETS = 1000;
|
|
26
|
+
function createTicketStore(options = {}) {
|
|
27
|
+
const ttl = options.ttl ?? exports.TICKET_TTL;
|
|
28
|
+
const eventsTtl = options.eventsTtl ?? exports.TICKET_EVENTS_TTL;
|
|
29
|
+
const max = options.max ?? MAX_TICKETS;
|
|
30
|
+
const tickets = new Map();
|
|
31
|
+
/** 清掉过期票据;数量超限时按插入顺序淘汰最旧的 */
|
|
32
|
+
const cleanup = () => {
|
|
33
|
+
const now = Date.now();
|
|
34
|
+
let removed = 0;
|
|
35
|
+
for (const [token, entry] of tickets) {
|
|
36
|
+
if (entry.expiresAt <= now) {
|
|
37
|
+
tickets.delete(token);
|
|
38
|
+
removed += 1;
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
while (tickets.size > max) {
|
|
42
|
+
const oldest = tickets.keys().next();
|
|
43
|
+
if (oldest.done)
|
|
44
|
+
break;
|
|
45
|
+
tickets.delete(oldest.value);
|
|
46
|
+
removed += 1;
|
|
47
|
+
}
|
|
48
|
+
return removed;
|
|
49
|
+
};
|
|
50
|
+
// 每分钟清理一次:票据数量不大,不需要更频繁
|
|
51
|
+
const timer = setInterval(cleanup, 60 * 1000);
|
|
52
|
+
timer.unref?.();
|
|
53
|
+
return {
|
|
54
|
+
issue(scope, names = [], ttlMs) {
|
|
55
|
+
const token = (0, node_crypto_1.randomBytes)(18).toString('base64url');
|
|
56
|
+
const lifetime = ttlMs ?? (scope === 'events' ? eventsTtl : ttl);
|
|
57
|
+
const entry = {
|
|
58
|
+
token,
|
|
59
|
+
scope,
|
|
60
|
+
names: names.slice(0, 500),
|
|
61
|
+
expiresAt: Date.now() + lifetime,
|
|
62
|
+
};
|
|
63
|
+
tickets.set(token, entry);
|
|
64
|
+
// 插入后再清理:既回收过期票据,也保证数量不超上限(淘汰最旧的)
|
|
65
|
+
cleanup();
|
|
66
|
+
return entry;
|
|
67
|
+
},
|
|
68
|
+
get(token, scope) {
|
|
69
|
+
const entry = tickets.get(String(token || ''));
|
|
70
|
+
if (!entry)
|
|
71
|
+
return null;
|
|
72
|
+
if (entry.expiresAt <= Date.now()) {
|
|
73
|
+
tickets.delete(entry.token);
|
|
74
|
+
return null;
|
|
75
|
+
}
|
|
76
|
+
if (scope && entry.scope !== scope)
|
|
77
|
+
return null;
|
|
78
|
+
return entry;
|
|
79
|
+
},
|
|
80
|
+
allows(entry, rel) {
|
|
81
|
+
// 事件流不针对具体文件
|
|
82
|
+
if (entry.scope === 'events')
|
|
83
|
+
return true;
|
|
84
|
+
// 没有限定文件时不允许访问任何文件,避免票据变成万能钥匙
|
|
85
|
+
if (!entry.names.length)
|
|
86
|
+
return false;
|
|
87
|
+
return entry.names.includes(rel);
|
|
88
|
+
},
|
|
89
|
+
cleanup,
|
|
90
|
+
size() {
|
|
91
|
+
return tickets.size;
|
|
92
|
+
},
|
|
93
|
+
stop() {
|
|
94
|
+
clearInterval(timer);
|
|
95
|
+
tickets.clear();
|
|
96
|
+
},
|
|
97
|
+
};
|
|
98
|
+
}
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
export interface TrashOptions {
|
|
2
|
+
/** 存储目录 */
|
|
3
|
+
dir: string;
|
|
4
|
+
/** 回收站保留时长(毫秒),默认 24 小时。传入函数表示运行时取值 */
|
|
5
|
+
ttl?: number | (() => number);
|
|
6
|
+
/** 清理检查间隔(毫秒),默认 1 小时 */
|
|
7
|
+
intervalMs?: number;
|
|
8
|
+
}
|
|
9
|
+
export interface TrashEntry {
|
|
10
|
+
/** 回收条目 ID */
|
|
11
|
+
id: string;
|
|
12
|
+
/** 原始相对路径(含子目录) */
|
|
13
|
+
name: string;
|
|
14
|
+
/** 文件大小(字节) */
|
|
15
|
+
size: number;
|
|
16
|
+
/** 删除时间戳 */
|
|
17
|
+
deletedAt: number;
|
|
18
|
+
/** 保留到期时间戳 */
|
|
19
|
+
expiresAt: number;
|
|
20
|
+
}
|
|
21
|
+
export interface Trash {
|
|
22
|
+
/** 移入回收站,返回条目信息 */
|
|
23
|
+
add(relPath: string): TrashEntry | null;
|
|
24
|
+
/** 还原到原位置,返回还原后的相对路径 */
|
|
25
|
+
restore(id: string): string | null;
|
|
26
|
+
/** 彻底删除 */
|
|
27
|
+
remove(id: string): boolean;
|
|
28
|
+
/** 清空回收站,返回删除数量 */
|
|
29
|
+
empty(): number;
|
|
30
|
+
/** 列出回收站条目(按删除时间倒序) */
|
|
31
|
+
list(): TrashEntry[];
|
|
32
|
+
/** 立即执行一次过期清理 */
|
|
33
|
+
cleanup(): number;
|
|
34
|
+
/** 停止定时清理 */
|
|
35
|
+
stop(): void;
|
|
36
|
+
}
|
|
37
|
+
/** 回收站目录名 */
|
|
38
|
+
export declare const TRASH_DIR_NAME = ".trash";
|
|
39
|
+
export declare function createTrash(options: TrashOptions): Trash;
|