Skip to content

Latest commit

 

History

History
86 lines (69 loc) · 6.44 KB

README_zh.md

File metadata and controls

86 lines (69 loc) · 6.44 KB
Raw

Hin2n

README | 中文文档

n2n 是一个支持内网穿透 p2p 的 VPN 项目，最初由 ntop.org 大神 Luca Deri [email protected]，Richard Andrews [email protected] 开发并开源的项目，后由 meyerd 大神继续做优化工作。我们的目的是为 n2n 提供 手机版本 的支持。

gradle API license GitHub release Github All Releases Travis branch

原版的 n2n 支持很多平台，包括 Windows，Linux，OSX，BSD，OpenWrt，Raspberry Pie 等，唯独缺少对手机（非root）的支持。因此，我们开发了 Hin2n 项目。

Hin2n 是什么

  • Hin2n 是支持 n2n 协议的手机 VPN 软件
  • 该 APP 不需要 root 手机
  • 该 APP 暂时只支持安卓手机，后续会发开 iPhone 版本
  • 该项目现处于持续开发阶段，后续会提供更完善的功能
  • 该项目现已支持全部 v1/v2s/v2/v3 协议

Hin2n 最新版本 CHANGELOG

Hin2n 最新版本可在 Release 地址 下载。

Hin2n 开发计划

详细开发计划请见 Projects。 大家如果有新需求和想法，任何意见建议均可提交在 Issues 中，我们将会酌情安排开发计划。您的关注就是我们的动力。

技术原理

  • VPNService

Hin2n 基于安卓原生提供的 VPNService，通过 VPNService 建立 tun 虚拟网卡，与 supernode 和 edge 通讯。

  • tun2tap

安卓上层仅支持建立 tun 虚拟网卡，仅是 TCP/IP 网络层，而 n2n 协议依赖 tap 虚拟网卡，需要对数据链路层的支持，因此我们模拟了数据链路层，并实现了 ARP 协议。

  • n2n protocol

Hin2n 对 n2n 协议的支持是采用 jni 的方式，native 方法可以尽量复用原 n2n 项目的代码。

n2n 协议版本

n2n 项目现有四个主流版本

关于 v2s 版本

v2s 版本是N2N交流QQ群(5804301)中对 meyerd 大神维护的v2版本(又称v2.1)的命名，即v2升级版，该版本与 ntop.org 大神们维护的v2版本并不互通，为避免混淆，群友们对该项目另行命名。

项目开发/编译说明

Hin2n 在 Linux 系统下的编译方法

你需要先安装好 Java 和 Android SDK。

  • git clone https://github.com/switch-iot/hin2n.git --depth=1 --recurse-submodules # 下载源码
  • cd hin2n/Hin2n_android # Hin2n_android 目录即是 hin2n 项目安卓源码目录
  • ./gradlew assemble # 开始编译（你也可以使用 ./gradlew assembleNormalAllarchDebug 来编译其中一个文件）。如果你要使用 Android Studio 来编译，请选择 Import Project，选择 Hin2n_android 目录，然后再选择编译 app。编译好的文件在 hin2n/Hin2n_android/app/build/outputs/apk/
  • 切换分支时，需要执行 git submodule update 来同步 submodule 的代码

Windows 系统下的编译方法

你需要先安装好 Java 和 Android SDK，并设置 git 兼容符号链接。

  • 打开 gpedit.msc，将当前账户加入设置 计算机配置/Windows 设置/安全设置/本地策略/用户权限分配/创建符号链接 中。
  • 或以管理员用户运行 git-cmd，并执行下述命令
  • git clone -c core.symlinks=true https://github.com/switch-iot/hin2n.git --depth=1 --recurse-submodules && cd hin2n && link.bat
  • cd Hin2n_android # Hin2n_android 目录即是 hin2n 项目安卓源码目录
  • gradlew assemble # 开始编译（你也可以使用 gradlew assembleNormalAllarchDebug 来编译其中一个文件）。如果你要使用 Android Studio 来编译，请选择 Import Project，选择 Hin2n_android 目录，然后再选择编译 app。编译好的文件在 hin2n\Hin2n_android\app\build\outputs\apk\
  • 切换分支时，需要执行 git submodule update 来同步 submodule 的代码

关于开源协议

该项目以 GPLv3 协议进行开源，与 n2n 原有开源协议保持一致，也希望大家支持并遵守本项目的开源协议。

为 Hin2n 做贡献

Hin2n 是一个免费且开源的 n2n 项目，我们欢迎任何人为其开发和进步贡献力量。

  • 在使用过程中出现任何问题，可以通过 Issues 来反馈
  • Bug的修复可以直接提交 Pull Request 到 android_dev分支
  • 如果是增加新的功能特性，请先创建一个 Issues 并做简单描述以及大致的实现方法，提议被采纳后，就可以创建一个实现新特性的 Pull Request
  • 欢迎对说明文档做出改善，帮助更多的人使用 Hin2n，特别是英文文档
  • 如果您觉得 Hin2n 对您有帮助，欢迎您关注该项目，并给项目点个 Star！

鸣谢

交流群

  • Hin2n交流群：769731491 (QQ群号)
  • N2N交流群：256572040 (QQ群号)