调研报告：tproxy-server 完整深度分析（Comprehensive Research Report, zh-CN）

[cy1234561]

这是什么

一份对 tproxy-server 仓库的完整深度调研报告（中文，1391 行），已作为 RESEARCH_REPORT.zh-CN.md 添加到仓库根目录。调研覆盖全部 49 个受版本控制文件（逐行精读）、23 个 git 提交、GitHub 仓库元数据、全部 14 个 issue/PR，并在本地实测了全部 Go 测试与 go vet。

报告目录（20 章）

1. 执行摘要
2. 仓库概况与元数据（含 12 条“看不见”的仓库事实：仓库重写史、无 LICENSE、无 CI、被删除的演示网站等）
3. 项目背景与定位（WEB proxy 抗审查原理、4 种载波模式对比）
4. 完整文件清单（49/49）
5. Git 历史与演化时间线（23 提交全表）
6. 系统架构总览（部署拓扑、数据面、Go 包职责、并发模型）
7. 协议规范深度解析（PROTOCOL.md 全量拆解：capability 派生与测试向量、两种边界、CSP 执行档案、四种载波请求/重试/关闭语义、9 种帧、流生命周期、全部数值界）
8. Go 服务端源码逐文件精读（main/frame/config/token/manager/session/server/secrets/site/bridge——含 ProcessUp/Poll 状态机、流控信用、墓碑环、预算三函数、防探测扫描算法）
9. Bridge 前端 JavaScript 逐段精读（重试引擎、四载波实现、DDoS 修复细节、双边界校验）
10. 部署体系逐文件精读（install/update/ensure-key/refresh/Caddyfile/nft/全部 systemd 单元）
11. 安全设计专项分析（15 项威胁×防线矩阵、密码学清单、5 条文档坦白的安全取舍）
12. 资源限制与配额体系全表
13. 性能模型与吞吐量上界
14. 测试体系全量盘点（77 个测试函数按主题分组）
15. 客户端平台文档要点（ANDROID/IOS）
16. 社区状态：全部 14 个 Issue 与 PR（含 umask 缺陷族分析）
17. 代码质量与安全评估（6 优点 11 风险）
18. 本地验证记录（本次调研实测，全部测试通过）
19. 结论与建议
20. 附录：常量速查表 / 术语表 / 复现命令

验证

• go test ./... 全部 5 个包通过（frame 0.003s / config 0.009s / bridge 0.183s / session 0.048s / server 1.302s，Go 1.26.5）
• go vet ./... 零告警
• 报告本身为纯文档新增，不影响任何产品代码

注：因令牌对上游仓库无直接推送权限，采用 Fork + PR 方式将报告呈现在该仓库。