Skip to content

hatful/Ladder

Repository files navigation

GFW 绕过工具知识库

全面记录翻墙工具技术演进的开源知识库 | 数据驱动 | 可视化展示 | 持续更新

许可证 贡献欢迎 最后更新


📖 项目简介

本项目致力于创建一个全面、结构化、可视化的 GFW 绕过工具知识库,记录从"翻墙"这件事诞生以来的所有重要工具、协议、技术演进和历史事件。

🎯 项目目标

  • 📚 完整记录: 系统整理 25+ 年的翻墙技术演进历史
  • 📊 数据驱动: 结构化数据支持查询、对比和可视化
  • 🌐 在线展示: 可转换为交互式网站,提供友好的浏览体验
  • 🔄 持续更新: 跟踪最新技术发展和工具状态
  • 🧪 实测验证: 提供真实环境的测试数据和使用指南

✨ 核心特性

  • ✅ 每个工具独立文档,包含历史、技术、配置、最佳实践
  • ✅ 标准化的元数据格式,便于程序化处理
  • ✅ 时间线可视化,清晰展示技术演进脉络
  • ✅ 多维度对比分析(性能、安全性、隐蔽性等)
  • ✅ 实测性能数据,真实网络环境测试结果
  • ✅ 详细的配置示例和故障排查指南

📁 项目结构

BestPracticeSite/
├── config/              # 配置文件
│   ├── site.yml        # 网站配置
│   ├── navigation.yml  # 导航结构
│   └── metadata-schema.json  # 数据模型定义
├── data/                # 结构化数据
│   ├── tools.json      # 工具索引
│   ├── timeline.json   # 时间线数据
│   └── comparisons/    # 对比数据
├── tools/               # 工具详细文档
│   ├── xray/           # 示例:Xray 完整文档
│   ├── shadowsocks/
│   └── ...
├── protocols/           # 协议文档
├── concepts/            # 技术概念
├── guides/              # 使用指南
└── ...

详细结构请参阅 PROJECT_STRUCTURE.md


🚀 快速开始

浏览内容

  1. 工具文档: 查看 tools/ 目录下的各个工具

    • 每个工具包含:概述、历史、技术原理、配置指南、最佳实践
    • 示例:tools/xray/index.md
  2. 时间线: 查看 data/timeline.json 了解完整历史

  3. 对比分析: 查看对比数据和推荐方案

贡献内容

欢迎贡献!请查看 CONTRIBUTING.md 了解如何:

  • 添加新工具文档
  • 更新现有内容
  • 补充测试数据
  • 改进文档结构

📊 当前状态

已收录工具

工具 世代 状态 中国可用性 推荐度 文档状态
Xray 4 ✅ 活跃 🟢 高 ⭐⭐⭐⭐⭐ ✅ 完整
Trojan 4 ✅ 活跃 🟢 高 ⭐⭐⭐⭐⭐ ✅ 完整
Hysteria 2 4 ✅ 活跃 🟢 高 ⭐⭐⭐⭐⭐ ✅ 完整
V2Ray 4 ✅ 维护中 🟡 中 ⭐⭐⭐⭐ ✅ 完整
NaiveProxy 4 ✅ 活跃 🟢 高 ⭐⭐⭐⭐ ✅ 完整
Shadowsocks 3 ⚠️ 已废弃 🔴 低 ⭐⭐ ✅ 完整

统计数据

  • 总工具数: 6
  • 完整文档: 6
  • 推荐工具: 4 (Xray, Trojan, Hysteria 2, NaiveProxy)
  • 时间线事件: 16
  • 协议数: 待补充
  • 测试报告: 1

🎨 未来计划

Phase 1: 内容完善 ✅ 进行中

  • 设计项目结构
  • 创建数据模型
  • 完成 Xray 示例文档
  • 补充 10+ 核心工具文档
  • 完善时间线数据
  • 创建对比分析

Phase 2: 网站开发 📅 计划中

  • 选择静态网站生成器 (VitePress/Docusaurus)
  • 实现工具详情页
  • 实现时间线可视化
  • 实现对比功能
  • 集成搜索功能

Phase 3: 功能增强 📅 未来

  • 多语言支持
  • 评论系统
  • 性能对比图表
  • 自动化测试集成
  • PWA 支持

🔍 核心工具列表(规划)

第一代:代理时代 (1990s-2008)

  • HTTP/HTTPS Proxy
  • SOCKS Proxy

第二代:VPN 时代 (2000-2012)

  • PPTP
  • L2TP/IPSec
  • OpenVPN

第三代:混淆代理 (2011-2017)

  • Shadowsocks ⭐
  • ShadowsocksR

第四代:现代混淆 (2017-至今)

  • V2Ray ⭐⭐⭐⭐
  • Trojan ⭐⭐⭐⭐⭐
  • Xray ⭐⭐⭐⭐⭐
  • Hysteria ⭐⭐⭐⭐
  • NaiveProxy ⭐⭐⭐⭐

第五代:插件化混淆 (2016-至今)

  • Obfs4
  • v2ray-plugin

第六代:去中心化 (2019-至今)

  • Tor
  • Outline

🧪 测试环境

本项目包含真实环境的测试数据:

  • 测试地点: 中国大陆(主要)
  • 测试网络: 家庭宽带、移动网络
  • 测试指标: 速度、延迟、稳定性、隐蔽性
  • 更新频率: 季度更新

查看 testing/ 目录了解测试方法和结果。


📚 推荐阅读顺序

新手用户

  1. 快速入门指南 🚧
  2. 如何选择工具 🚧
  3. 2024 推荐方案 🚧
  4. Xray 快速部署

技术用户

  1. 项目结构说明
  2. GFW 技术原理 🚧
  3. 协议技术对比 🚧
  4. 性能优化指南 🚧

研究人员

  1. 完整时间线
  2. 技术演进分析
  3. 学术论文集 🚧
  4. 测试方法论 🚧

🤝 贡献指南

我们欢迎各种形式的贡献:

内容贡献

  • 📝 补充工具文档
  • 🧪 提供测试数据
  • 📖 改进文档质量
  • 🌍 翻译内容

技术贡献

  • 💻 网站开发
  • 📊 数据可视化
  • 🔧 工具脚本
  • 🐛 Bug 修复

其他贡献

  • ⭐ Star 本项目
  • 📢 分享给更多人
  • 💡 提出建议和意见
  • 🔗 提供参考资源

贡献步骤:

  1. Fork 本仓库
  2. 创建特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 开启 Pull Request

⚖️ 免责声明

  • 本项目仅供技术研究和学习使用
  • 所有内容为客观技术描述,不构成使用建议
  • 使用者需遵守所在地区法律法规
  • 作者不对任何使用后果负责
  • 请尊重网络服务提供商的服务条款

📄 许可证

本项目采用 MIT 许可证


🔗 相关资源

官方文档

社区资源

学术研究


📮 联系方式


🌟 致谢

感谢所有为互联网自由做出贡献的开发者、研究者和用户。

特别感谢:

  • clowwindy (Shadowsocks)
  • V2Ray 项目
  • XTLS 团队
  • 所有开源贡献者

📊 项目状态

GitHub stars GitHub forks GitHub issues GitHub pull requests

最后更新: 2024-12-04


⭐ 如果这个项目对你有帮助,请给我们一个 Star!

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published