1
0
mirror of https://github.com/v2fly/v2ray-core.git synced 2024-09-29 15:26:29 -04:00
v2fly/spec/design.md

89 lines
2.6 KiB
Markdown
Raw Normal View History

2015-09-05 11:48:38 -04:00
# V2Ray 设计概要
## 目标
* V2Ray 自身提供基础的翻墙功能,单独使用可满足日常需求;
* V2Ray 可被用于二次开发,可为用户提供个性化的翻墙体验,从而也达到难以统一屏蔽之效果;
* V2Ray 为模块化设计,模块之间互相独立。每个模块可单独使用,也可和其它模块搭配使用。
## 架构
### 术语
2015-09-12 16:11:54 -04:00
* Point一个 V2Ray 服务器称为 VPoint
* Set本机上的一组 VPoint
* SuperSet多机环境中的多个 VSet
* Source用户所使用的需要翻墙的软件比如浏览器
* End用户需要访问的网站
* User一个受到 VPoint 认证的帐号
* [ID](https://github.com/V2Ray/v2ray-core/blob/master/spec/id.md):全局唯一的 ID类似于 UUID
2015-09-05 11:48:38 -04:00
### 工作流程
VPoint 可提收来自 VSource 或其它 VPoint 的请求,并将请求转发至配置中的下一个 VPoint或 VSet 或 VSuperSet 或目标网站,然后将所得到的应答回复给请求来源。
VPoint 采用白名单机制,只接受已认证帐号的请求。
### 通信协议
* VPoint 之间默认使用自有 VMess 协议,或第三方自定义协议。
* VPoint 和客户端之间可使用以下协议:
* HTTP Proxy
* SOCKS 5 Proxy
* PPTP / L2TP / SSTP 等 VPN 隧道
* 其它自定义协议
* VPoint 和目标网站之间使用以下协议:
* HTTP / HTTPS
* UDP (DNS)
#### VMess
VMess 为 V2Ray 的原生协议,设计用于两个 VPoint 之间的通信。[详细设计](https://github.com/V2Ray/v2ray-core/blob/master/spec/vmess.md)
2015-09-12 16:11:54 -04:00
### User
* 每个 User 有一个 ID
2015-09-05 11:48:38 -04:00
2015-09-12 16:11:54 -04:00
### Point
* 每个 Point 有一个 ID运行时生成
* 每个 Point 可使用独立的配置文件,或从 VSet 继承
* 一个 Point 监听主机上的一个特定端口(可配置),用于接收和发送数据
* 一个 Point 运行于一个独立的进程,可设定其使用的系统帐户
2015-09-05 11:48:38 -04:00
2015-09-12 16:11:54 -04:00
### Set
2015-09-05 11:48:38 -04:00
TODO
2015-09-12 16:11:54 -04:00
### SuperSet
2015-09-05 11:48:38 -04:00
TODO
2015-09-12 16:11:54 -04:00
## Point 详细设计
一个 Point 包含五个部分:
2015-09-05 11:48:38 -04:00
* 配置文件处理:读取和解析配置文件
* 输入:负责与客户端建立连接(如 TCP接收客户端的消息
* 控制中心:负责处理事件
* 加密解密
2015-09-12 16:11:54 -04:00
* Point 负载均衡
* Point 进程间通信
2015-09-05 11:48:38 -04:00
* 输出:负责向客户端发送消息
### 配置文件
配置文件使用 JSON / ProtoBuf 兼容格式,定义 TODO
### 加密
TODO
### 任务处理
TODO
### 控制中心
控制中心响应以下事件:
**INIT**
2015-09-12 16:11:54 -04:00
* 输入:用户 ID
* 输出:如果用户 ID 有效:"OK",否则关闭连接
2015-09-05 11:48:38 -04:00
**MSG**
* 输入VMess 消息
* 输出:对应的响应消息
**END**
2015-09-12 16:11:54 -04:00
* 输入:用户 ID
* 输出:如果用户 ID 有效:关闭连接
2015-09-05 11:48:38 -04:00
## 编程语言
暂定为 golang。