音频改走无扩展名的 /media 路由:IDM / 迅雷 这类下载管理器不再弹「下载文件信息」
玩家那边遇到的是:游戏放着 BGM,突然弹出下载管理器的「下载文件信息」框,有时还会把整条 音轨抢去下载。原因是这些工具会嗅探以媒体扩展名结尾的 XHR/fetch。改成客户端统一请求不带 扩展名的 `/media/<原路径去掉 .mp3>`,服务端再解析回 `public/assets/audio/…`。 - `public/js/media.js`:`mediaUrl()` 把 `/assets/audio/**.mp3` 换算成 `/media/**`,只处理同源、 且扩展名在名单内的地址;跨域、目录、`..`、点开头、不认识的扩展名一律原样返回。 - `server/index.js`:新增 `/media/` 路由。按 `AUDIO_EXTS` 顺序找 `.mp3/.m4a/.aac/.ogg/.oga/.opus/.wav`, 显式写了扩展名的以它为准;Range/ETag/Content-Type/缓存策略都复用 `serveFile`,所以和直接请求 `/assets/audio/…` 行为一致(一天缓存、支持 Range)。 - 直接请求 `/assets/audio/…` 仍然可用 —— 这是给不支持 `/media/` 的纯静态托管留的退路,客户端 在 `/media/` 404 时才回退到原地址。 安全:`/media/` 的路径只接受正常片段,`..`/`.` 直接 403,点开头或点结尾的片段 404,解析出的 绝对路径必须落在 `public/assets/audio` 之内,且只允许上面那几个音频扩展名 —— 不会变成任意文件读取。 测试: - `test/media-url.test.js`:`mediaUrl()` 的换算与各种「别动它」的边界。 - `test/lobby.test.js`:真实服务器上的 `/media` 路由(正常解析、显式扩展名优先、Range、HEAD、 目录与穿越请求被拒、客户端回退用到的 `/media/bgm.mp3` 仍 200)。 - `test/ui/audio.test.js`:音频管理器现在先请求无扩展名地址,404 才回退原地址;断言跟着 `mediaUrl()` 换算后再比对(原先拿 manifest 原地址比对,等于断言一个客户端永不请求的 URL)。
This commit is contained in:
1 parent
8cd6491e43
commit
a069be4538
6 files changed
+281
-14
No files matched your search
@@ -281,6 +281,44 @@ describe('static http server', () => {
|
||||
assert.equal(textRange.body.toString(), js.slice(0, 2));
|
||||
});
|
||||
|
||||
test('extension-less /media audio route (download managers sniff .mp3 URLs)', async () => {
|
||||
const direct = await httpReq(srv.port, '/assets/audio/bgm.mp3');
|
||||
const media = await httpReq(srv.port, '/media/bgm');
|
||||
assert.equal(media.status, 200);
|
||||
assert.equal(media.headers['content-type'], 'audio/mpeg', 'resolved from the real .mp3 on disk');
|
||||
assert.equal(media.headers['accept-ranges'], 'bytes');
|
||||
assert.deepEqual(media.body, mp3, 'same bytes as the direct URL');
|
||||
assert.equal(media.headers['cache-control'], direct.headers['cache-control'], 'same 1-day policy as /assets/…');
|
||||
assert.equal(media.headers.etag, direct.headers.etag, 'ETag is the file validator, not the URL');
|
||||
|
||||
const range = await httpReq(srv.port, '/media/bgm', { headers: { range: 'bytes=0-9' } });
|
||||
assert.equal(range.status, 206);
|
||||
assert.equal(range.headers['content-range'], `bytes 0-9/${mp3.length}`);
|
||||
assert.deepEqual(range.body, mp3.subarray(0, 10));
|
||||
const head = await httpReq(srv.port, '/media/bgm', { method: 'HEAD' });
|
||||
assert.equal(head.status, 200);
|
||||
assert.equal(head.body.length, 0);
|
||||
|
||||
// The extension may still be given, and the other audio extension resolves too.
|
||||
assert.equal((await httpReq(srv.port, '/media/bgm.mp3')).status, 200);
|
||||
const ogg = await httpReq(srv.port, '/media/bgm.ogg');
|
||||
assert.equal(ogg.status, 200);
|
||||
assert.equal(ogg.headers['content-type'], 'audio/ogg');
|
||||
assert.equal(ogg.body.length, 64);
|
||||
|
||||
// …and it only ever reaches public/assets/audio.
|
||||
for (const p of ['/media/nope', '/media/bgm/', '/media/', '/media/.hidden', '/media/bgm.mp3/nope', '/media/js/app']) {
|
||||
const r = await httpReq(srv.port, p);
|
||||
assert.equal(r.status, 404, `${p} → 404`);
|
||||
assert.doesNotMatch(r.body.toString(), /TOP-SECRET-CONTENT/, `${p} must not leak files outside public/assets/audio`);
|
||||
}
|
||||
for (const p of ['/media/..%2f..%2fsecret.txt', '/media/bgm/../..%2f..%2fsecret.txt']) {
|
||||
const r = await httpReq(srv.port, p);
|
||||
assert.equal(r.status, 403, `${p} → 403 (same as the rest of the server)`);
|
||||
assert.doesNotMatch(r.body.toString(), /TOP-SECRET-CONTENT/);
|
||||
}
|
||||
});
|
||||
|
||||
test('path traversal and dotfiles are blocked', async () => {
|
||||
const attempts = [
|
||||
'/../secret.txt', '/%2e%2e/secret.txt', '/..%2fsecret.txt', '/%2e%2e%2fsecret.txt', '/data/../../secret.txt',
|
||||
|
||||
Reference in new issue
Block a user