GSNova 技术文档

1. 安装指南

请确保您的系统中安装有 go1.9 或更高版本。以下是获取 GSNova 的方法：

go get -t -u -v github.com/yinqiwen/gsnova

此外，GSNova 也提供了预编译的二进制发行版本，您可以从 这里 下载。

2. 项目的使用说明

GSNova 是一个私有代理解决方案和网络安全故障排除工具。以下是它的主要特性：

• 多种传输通道支持，包括 http/https、http2、websocket、tcp/tls、quic、kcp、ssh 等。
• 代理连接的复用。
• 简单的 PAC（Proxy Auto Config）。
• 支持多种加密算法，如 Chacha20Poly1305、Salsa20、AES128。
• 支持 HTTP/Socks4/Socks5 代理。
• 透明的 TCP/UDP 代理实现。
• 支持多跳代理。
• 支持 TLS 中间人（MITM）代理。
• 提供 HTTP(S) 数据包捕获功能，用于网页调试。
• 支持点对点（P2P）/点对服务器对点（P2S2P）代理。
• 支持内存受限环境。

3. 项目 API 使用文档

GSNova 的命令行使用方法如下：

Usage of ./gsnova:
  -admin string
    	Client Admin listen address
  -blackList value
    	Proxy blacklist item config
  -client
    	Launch gsnova as client.
  -cmd
    	Launch gsnova by command line without config file.
  -cnip string
    	China IP list. (default "./cnipset.txt")
  -conf string
    	Config file of gsnova.
  -forward value
    	Forward connection to specified address
  -hosts string
    	Hosts file of gsnova client. (default "./hosts.json")
  -httpdump.dst string
    	HTTP Dump destination file or http url
  -httpdump.filter value
    	HTTP Dump Domain Filter, eg:*.google.com
  -key string
    	Cipher key for transmission between local&remote. (default "809240d3a021449f6e67aa73221d42df942a308a")
  -listen value
    	Listen on address.
  -log string
    	Log file setting (default "color,gsnova.log")
  -mitm
    	Launch gsnova as a MITM Proxy
  -ots string
    	Online trouble shooting listen address
  -p2p string
    	P2P Token.
  -pid string
    	PID file (default ".gsnova.pid")
  -ping_interval int
    	Channel ping interval seconds. (default 30)
  -pprof string
    	PProf trouble shooting listen address
  -proxy string
    	Proxy setting to connect remote server.
  -remote value
    	Next remote proxy hop server to connect for client, eg:wss://xxx.paas.com
  -servable
    	Client as a proxy server for peer p2p client
  -server
    	Launch gsnova as server.
  -stream_idle int
    	Mux stream idle timout seconds. (default 10)
  -tls.cert string
    	TLS Cert file
  -tls.key string
    	TLS Key file
  -upnp int
    	UPNP port to expose for p2p.
  -user string
    	Username for remote server to authorize. (default "gsnova")
  -version
    	Print version.
  -whitelist value
    	Proxy whitelist item config
  -window string
    	Max mux stream window size, default 512K
  -window_refresh string
    	Mux stream window refresh size, default 32K

4. 项目安装方式

请参考上述“安装指南”部分获取 GSNova。如果您需要编译 Android 客户端，可以使用以下命令：

gomobile bind -target=android -a -v github.com/yinqiwen/gsnova/local/gsnova

这样就可以使用生成的 gsnova.aar 库在 Android 应用中集成 GSNova。