README
¶
Freedom
端到端数据流量伪装加密研究
仅供学习研究使用，请勿用于非法用途
⭐相关Repo
| 项目名称 | 简介 |
|---|---|
| freedomGo | Go实现，包含local端、remote端 |
| freedom4py | python3实现，包含local端、remote端 |
| freedomRust | Rust实现，包含local端、remote端 |
| freedom4j | java实现，包含local端、remote端 |
| freedom4NG | Android java实现，仅包含local端；单独使用可作为DNS、Host修改器 |
⭐一句话说明
将本地代理数据伪装成指向远程端的HTTP(S) WebSocket流量 或者 gRPC流量。
⭐简介
- 在配置正确的情况下，Go、python3、java、Android版本的local端和remote端可以配合使用。
- local端实现了HTTP(S)、SOCKS5代理，仅需一个端口，即可自动识别各种代理类型。
- local端HTTP(S)代理支持按域名分流，可将流量分为直连和走remote端两种。
- local端到remote端可以套上一层HTTP(S)，表现行为与Websocket/gRPC无异，经测试可过CDN与Nginx。
- local端到remote端可以使用http2协议，但是中间层可能会缓存相关请求，未能实现转发。
- local端到remote端可以使用http3协议，但不支持CDN。
- local端到remote端支持简单的用户名密码验证。
⭐缺陷
- 仅支持TCP，不支持UDP
⭐如何在Cloudflare Worker中使用该项目(remote端 + ws_real)
请参考cf.js
⭐如何在Web框架中使用该项目(remote端)
实现了较多的基础Handler func (w http.ResponseWriter, r *http.Request)
可以很方便地转化为其它框架的Handler，例如gin func (c *gin.Context)
基础http server示例
// 相关代码在 extend文件夹下，该文件夹的内容可以独立出来
func StartRemoteHTTPWebSocketProxyServer() {
// 在代码中初始化配置，或者设置环境变量也可。参考 extend/common.go
UseSSL = true
extend.Users = ...
extend.Salt = ...
extend.HttpPath = ...
extend.DnsResolver = ...
...
// 设置路由
http.HandleFunc(extend.HttpPath, extend.Handler)
addr := fmt.Sprintf("%s:%d", extend.BindHost, extend.BindPort)
var err error
if UseSSL {
err = http.ListenAndServeTLS(addr, extend.CertPath, extend.KeyPath, nil)
} else {
err = http.ListenAndServe(addr, nil)
}
panic(err)
}
⭐如何配置
local端配置
# socks5 http
ProxyType: http
# ws grpc http2 http3 ws_real
ProxyMode: grpc
BindHost: 127.0.0.1
BindPort: 1081
# 在非Window系统下生效,可为空
#DNSServer: 114.114.114.114:53
# 按域名分流将下面注释去掉即可
# 全局代理将下面注释掉即可
# GeoDomain:
# # 如果不匹配分流规则，那么就直连?
# DirectIfNotInRules: true
# # 同https://github.com/gfwlist/gfwlist
# GfwPath: data/gfwlist.txt
# # 将直连域名直接写入即可，每行一个
# DirectPath: data/direct_domains.txt
# 该值可以是ip或者域名
RemoteHost: 127.0.0.1
RemotePort: 443
# 和远端的连接是否经过TLS加密
RemoteSSL: true
Salt: salt
Username: username
Password: pwd
# 是否允许不安全的HTTPS连接
AllowInsecure: true
# WebSocket 模拟的HTTP请求Path
# 该值gRPC无效, 默认为 /{GrpcServiceName}/Pipe
HttpPath: /
GrpcServiceName: freedomGo.grpc.Freedom
# 如果连接是经过加密的,该值还是Client Hello消息里面的SNI
HttpDomain: www.baidu.com
HttpUserAgent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:86.0) Gecko/20100101 Firefox/86.0
remote端配置
# 可选模式为 grpc ws http2 http3 ws_real
ProxyMode: ws
BindHost: 127.0.0.1
BindPort: 443
Salt: salt
# 在非Window系统下生效,可为空
#DNSServer: 8.8.8.8:53
# ProxyMode为http3时生效，用来伪装成静态网站。为空时不做伪装。
HTTP3WebDir: D:\WWW\
# ProxyMode为http3时生效，生效路径。
HttpPath: /12345
UseSSL: true
# UseSSL为false时,下面三行可注释掉
SNI: www.baidu.com
CertPath: data/fullchain.pem
KeyPath: data/www.baidu.com.key
GrpcServiceName: freedomGo.grpc.Freedom
Users:
user1: pwd1
username: pwd
⭐如何运行
$: .\freedomGo.exe -help
Usage of D:\Workspace\freedomGo\freedomGo.exe:
-c string
配置文件路径 (default "./conf.local.yaml")
-t string
模式local/remote (default "local")
- 运行本地端
freedomGo -t local -c "配置文件路径"
- 运行远程端
freedomGo -t remote -c "配置文件路径"
Documentation
¶
There is no documentation for this package.
Source Files
Directories
Click to show internal directories.
Click to hide internal directories.