v2ray_simple/proxy/doc.go

/*Package proxy defines necessary components for proxy.

Config Format  配置格式

一共有三种配置格式，极简模式，标准模式，兼容模式。

“极简模式”(即 verysimple mode)，入口和出口仅有一个，而且都是使用共享链接的url格式来配置.

标准模式使用toml格式。

兼容模式可以兼容v2ray现有json格式。（暂未实现）。

极简模式的理念是，配置文件的字符尽量少，尽量短小精悍;

还有个命令行模式，就是直接把极简模式的url 放到命令行参数中，比如:

	verysimple -L socks5://sfdfsaf -D direct://


Layer Discussion

目前认为，一个传输过程大概由四个部分组成，基础连接（udp/tcp），TLS（可选），中间层（ws、grpc、http等，可选），具体协议（socks5，vless，trojan等）.

其中，ws和grpc被认为是 高级应用层，http（伪装）属于 header 层.

TLS - Transport Layer Security 顾名思义TLS作用于传输层，第四层，但是我们tcp也是第四层，所以在本项目中，认为不需要“会话层”，且单独加一个专用于tls的层比较稳妥.

New Model - VSI 新的VSI 模型

那么我们提出一个 verysimple Interconnection Model， 简称vsi模型。1到4层与OSI相同（物理、链路、网络、传输).

把第五层替换成“加密层”，把TLS放进去；把第六层改为 http头(1.1) 层

第七层 改为高级应用层，ws/grpc/http2 属于这一层, 简称高级层；第八层定为 代理层，vless/trojan 在这层.

第九层为 承载数据层，承载的为 另一大串 第四层的数据.

不过有时比如 trojan-go 的 smux 和 v2ray 的 mux.cool ，实际上属于 高级层，那么它们就是 代理层里面又包了一层高级层.

一般来说，如果内层高级层是普通的协议的话，实际上是透明的, 不必单列出一个层级.

这里的关键地方是【内层多路复用】. 因为在内层多路复用时，一个连接会被抽象出多个子连接，在流量的走向方面开始分叉，所以确实有实质性不同。

内层多路复用的性质是，多路复用分离出一个个子协议后，子协议又是代理层。

所以第九层除了承载数据外, 还可以为 inner mux 层, 第十层可以为 inner proxy 层, 此时第11层才是承载数据.

我们verysimple 的架构 实际上是 基于 “层” 的架构，或称 可分层结构. 如下:


	11｜        --------------               （client real tcp/udp data)
	--------------------------------------------------------------------------------
	10｜        (simplesocks)           |    （inner proxy layer)
	--------------------------------------------------------------------------------
	9 ｜ [client real tcp/udp data]     or   [inner mux Layer]
	--------------------------------------------------------------------------------
	8 ｜      vless/trojan/socks5       ｜     proxy layer
	--------------------------------------------------------------------------------
	7 ｜          ws/grpc/quic          ｜     advanced layer
	--------------------------------------------------------------------------------
	6 ｜           http header          ｜     http layer
	--------------------------------------------------------------------------------
	5 ｜           tls                  ｜     tls layer
	--------------------------------------------------------------------------------
	4 ｜ tcp/udp/unix domain socket/kcp ｜     transport layer
	--------------------------------------------------------------------------------

另外，实际上quic属于一种超级协议，横跨传输层一直到高级层，不过为了分类方便，这里认为它也是一种 高级层。
也就是说，如果遇到横跨多个层的协议，我们认为它属于其中最高的层级。


基本上5-8层都是可控的.第四层也可以给出一些参数进行控制，比如在tproxy时。


对应的理想配置文件应该如下.

	{
		"layer3_settings": {	//or network_settings，
				//可以配置一些网络层分流（ip）
		},
		"layer4_settings": {	//or transportLayer_settings，
			"tcp":{}	//可以设置一些缓存大小等配置. 和传输层协议分流（tcp/udp）
		},
		"layer5_settings": {	//or tls_settings，
			"tls":{"insecure": true},
			"utls":{}
			// 可以配置tls 层分流/回落（sni 和 alpn）
		},
		"layer6_settings": {	//or http_settings
			//可以配置http path分流 /回落 or header分流/回落
		},
		"layer7_settings": {	//or advancedLayer_settings
			"ws":{},
			"grpc":{},
			"quic":{}
		},
		"layer8_settings": {	//or proxy_settings
			"vless":{},
			"trojan":{}
		},
		"layer9_settings": {	//or innerMux_settings
			"smux":{}
		},
		"layer10_settings": {	//or innerProxy_settings
			"simplesocks":{}
		},
	}

我们项目的文件夹，netLayer 第3，4层，tlsLayer文件夹代表第5层; httpLayer第六层，
advLayer文件夹 代表第七层, proxy文件夹代表第8层或第10层, 同时连带 处理了 第九层.


同级的ws和grpc是独占的，可以都放到一个layer里，然后比如第八层配置了一个vless一个trojan，那么排列组合就是4种，vless+ws, vless+ grpc, trojan+ws, trojan+grpc.


这就大大减轻了各种”一键脚本“的 使用需求，咱们只要选择自己喜欢的各个层，程序自动就为我们生成所有配置.

运行时，如果所有配置都要有，那么就需要多种端口；共用端口的话可以用nginx.

也可以程序指定一种 特定的情况，比如开始运行程序时，冒出交互界面，自己按项选择好后，就自动运行，然后自动生成客户端分享url.

可以在脑海里想象 “穿鞋带” 的画面，有很多洞可以经过，都穿好了 鞋带就系好了。或手机手势解锁的情况.

这种好处是，每次运行都可以采用不同的配置，不同的uuid，手机一扫码就能连上.

然而，这种“高级模式”是不容易实现、也不好理解的，目前初始阶段先不考虑。

目前的标准模式的配置文件中，整个一个节点的配置完全是扁平化的，所有的层的配置都会在同一级别中。比如tls的配置完全和节点本身的配置放在一起。

总之 verysimple 的思路就是，要不就完全扁平化，要不就完全分层。

本作认为，所有的代理是都可以有tls层、http层和ws/grpc这种advLayer 的，所以就统一嵌入所有的代理协议的配置当中,直接扁平化了.

Contents of proxy package - proxy包内容

接口 BaseInterface 和 结构 Base 给 这个架构定义了标准.

而 Client 和 Server 接口 是 具体利用该架构的 客户端 和 服务端，都位于VSI中的第八层.

使用 RegisterClient 和 RegisterServer 来注册新的实现（Creator）.

一般Client和Server都要内嵌Base结构，这样可以快速实现BaseInterface接口，然后自行实现Name方法以及

Client接口中的方法 和 Server接口中的方法

Server and Client

我们服务端和 客户端的程序，都是有至少一个入口和一个出口的。入口我们叫做 inServer ，出口我们叫做 outClient.

这两个词的含义和 v2ray的 inbound 和 outbound 是等价的.

在 inServer 中，我们负责监听未知连接；在 outClient 中，我们负责拨号特定目标服务器.

proxy中默认实现了 direct 和 reject 这两种 Client。默认实现了 reject Server

reject作为Client和Server 的作用基本是一致的，就是读取一下用户的请求，查看是否为 http请求，然后根据情况 返回 对应的 http1.1 的 4xx 响应，然后关闭连接。



Comparison

层级清晰、详细的好处就是 转发路径十分清晰，转发路径在读取完配置后就是确定的，性能可以得到提高。

与本作架构对立的架构是 支持转发链 或者说 “链式转发” 的架构，如gost。

实际上 v2ray的架构 更接近 gost 这种架构， 而本作的架构比较独特。

目前本作架构基本上无法实现链式转发，如果要支持，要进行一些重构。应该是可以做到的。
*/
package proxy