docs(fsys): 修正 README 缓存/兼容性措辞,测试页补 video Range 用例,审计报告勘误

This commit is contained in:
qing committed 2026-08-08 07:52:18 +00:00
1 parent b6a1cadf25
commit bb5e3b973f
4 files changed
+18 -2

No files matched your search

+2 -2
View File
@@ -2,7 +2,7 @@
基于 libhttp + libmsg 的 C++20 静态文件托管与前端页面服务,监听 `127.0.0.1:9200`。
Python/Flask `static` 模块的生产级 C++ 重写,接口 100% 兼容,前端零改动。
Python/Flask `static` 模块的生产级 C++ 重写,前端零改动兼容(改进性差异:上游状态码透传使前端 401 跳转首次生效,详见审计报告 D-1)。
## 架构
@@ -39,7 +39,7 @@ fsys :9200 (libhttp 异步多线程 + CORS)
|------|------|
| `POST /api/hash` | SHA-256 密码哈希(限速 20/min/IP) |
| `POST /api/check_user` | 检查用户是否已注册(限速 10/min/IP) |
| `GET /api/favicon?url=` | favicon SSRF 防护代理(512KB 上限,1 天缓存) |
| `GET /api/favicon?url=` | favicon SSRF 防护代理(512KB 上限,仅浏览器侧 Cache-Control 缓存 1 天,无服务端缓存) |
### dnfs2 代理路由
+12
View File
@@ -42,6 +42,7 @@
<tr data-t="filelist_sub"><td class="name">GET /api/filelist?path=test%2F(编码子目录)</td><td class="st pending">—</td><td class="detail"></td></tr>
<tr data-t="filelist_traverse"><td class="name">GET /api/filelist?path=..%2F..(遍历应 403)</td><td class="st pending">—</td><td class="detail"></td></tr>
<tr data-t="static_file"><td class="name">GET /test/hello.txt(静态文件)</td><td class="st pending">—</td><td class="detail"></td></tr>
<tr data-t="video_range"><td class="name">GET /video/test/sample.mp4(Range 206/416)</td><td class="st pending">—</td><td class="detail"></td></tr>
<tr data-t="download"><td class="name">GET /test/hello.txt?download=true(附件头)</td><td class="st pending">—</td><td class="detail"></td></tr>
<tr data-t="utf8_path"><td class="name">GET 中文文件名(URL 解码)</td><td class="st pending">—</td><td class="detail"></td></tr>
<tr data-t="hash"><td class="name">POST /api/hash(sha256("test123"))</td><td class="st pending">—</td><td class="detail"></td></tr>
@@ -109,6 +110,17 @@ const tests = {
const ok = res.status === 200 && text.includes('hello fsys');
setRow('static_file', ok, `HTTP ${res.status}, ${(res.headers.get('content-type') || '').split(';')[0]}`);
},
async video_range() {
const full = await fetch('/video/test/sample.mp4');
const partial = await fetch('/video/test/sample.mp4', { headers: { Range: 'bytes=0-99' } });
const bad = await fetch('/video/test/sample.mp4', { headers: { Range: 'bytes=999999-' } });
const cr = partial.headers.get('content-range') || '';
const ok = full.status === 200 && full.headers.get('accept-ranges') === 'bytes'
&& partial.status === 206 && cr.startsWith('bytes 0-99/')
&& partial.headers.get('content-length') === '100'
&& bad.status === 416;
setRow('video_range', ok, `full=${full.status}, range=${partial.status} ${cr}, bad=${bad.status}(期望 416)`);
},
async download() {
const { res } = await j('/test/hello.txt?download=true');
const cd = res.headers.get('content-disposition') || '';
Binary file not shown.