UDP隧道项目技术文档

1. 安装指南

系统要求

• 具备预付费SIM卡的手机，能够共享互联网
• 可以连接到完整互联网连接的Linux或OSX系统

安装步骤

• 对于OSX系统，可能需要安装tuntap模块。可以从tuntaposx获取。
• 下载项目源码，并编译。

2. 项目使用说明

使用前提

• 确定具有完整互联网连接的机器的公网IP地址 <public_address>
• 选择一个公用密码 <your_password>

使用步骤

服务器端（具备完整互联网连接的Linux系统）

运行以下命令启动服务器：

./server 53 <your_password>

客户端（具有限制互联网访问的OSX系统）

运行以下命令连接到服务器：

./client <public_address> 53 <your_password>

注意事项

• 如果OSX客户端出现open: No such file or directory错误，请确保已安装tuntap模块。
• 建立连接后，将会有一些速度损失，测试下载速度为0.210 MBPS。

3. 项目API使用文档

本项目不提供传统意义上的API，而是通过UDP隧道传输TCP、UDP和ICMP数据包。数据包的传输结构如下：

PC到互联网：
PC -> 手机 -> 限制互联网 -> 服务器 -> 互联网

互联网到PC：
互联网 -> 服务器 -> 限制互联网 -> 手机 -> PC

UDP数据包的有效负载格式：

|-----------|----------|--------------------------------------------|
|PACKET_TYPE| PACKET_CMD|                 数据内容                    |
|（1字节）  |（1字节） |                 （可变长度）                  |
|-----------|----------|--------------------------------------------|

数据包类型分为两种：

• CONTROL：用于身份验证和通知
• TRAFFIC：用于传输其他数据包（TCP/UDP/ICMP）。

4. 项目安装方式

请遵循以下步骤进行项目安装：

1. 克隆项目代码到本地。
2. 确保系统中已安装必要的编译工具和依赖库。
3. 编译项目源码。
4. 根据使用说明配置并运行服务器和客户端。

以上步骤完成之后，您应该能够通过UDP隧道实现限制网络环境下的完整互联网访问。