CircleCI actions workflow Badge

使用 C++20协程 通过编写为数不多的代码,实现具有极高性能且支持标准 socks4/socks4a/socks5/http/https 的 server/client proxy 实现,该项目不仅可以直接作为 proxy 服务端/客户端来使用,并且也可以作为您的网络程序支持代理的开发库来使用。

该项目可以组织出绝大部分代理的使用场景,并且 client 与 server 之间可配置通过 ssl 加密通信,也可配置多级代理,如下架构:

 +--------------+ | +--------------+
 browser/app --> | proxy server | ---ssl---> | proxy server | --> target server
 +--------------+ | +--------------+
 local Firewall remote

上图中 proxy server 即可以作为 local 端的客户端,也可以作为 remote 端的服务端,它可以同时支持多种代理协议以及普通 http/https 协议的支持.

您不必担心你的代理服务器被他人探测,因为探测只会得到它是一个 nginx error page 服务的结果,这是因为在探测者不知 proxy auth 认证信息的情况下认证会失败,这时的 proxy server 将自动伪装成一个 nginx 服务,返回一个 nginx error page 页面信息。

 | +--------------+
 browser/app --> https proxy ---> | proxy server | --> target server
 | +--------------+
 local Firewall remote

proxy server 同时能接收 socks 或 http 代理请求(http 代理使用 CONNECT),它能将所有功能(socks、http)可运行在同一服务端口上,服务端能自动甄别协议的类型,它通过处理请求协议的前几个字节判定为 socks 或 http 请求,从而实现支持不同协议运行在同一服务端口。

将不同服务运行在同一端口之上,也能达到混淆该服务上的流量特征的目的,通过灵活的取舍配置所需要的协议,这可以让服务具有更强的抗审查能力。

proxy server 也能同时接受正常 http 请求(请求 http 静态文件),这时它和一个正常的静态 web 文件服务器是完全相同的功能,并且它支持配置 http 访问认证。

要求操作系统安装以下工具:

版本控制: git
C++ 编译器: Linux 平台 gcc 11 以上,或 clang 14 以上,windows 平台要求 visual studio 2022 或以上。
构建工具: cmake 3.5 以上。
如果希望使用 docker 编译,应当安装好 docker 环境。

首先执行 git 克隆源码(源码无任何外部依赖)

git clone <source url>

克隆源码完代码后,就可以开始编译项目了。

进入源码目录,执行如下操作:

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release

在 cmake 命令成功执行完成后,开始输入以下命令编译:

cmake --build build

通常编译过程不会出现问题,如果出现任何问题,请联系作者,并将完整的错误信息保留并报告给作者。

成功编译后,生成的可执行程序将在 bin 目录下,其它相关 lib 的编译结果 .a 文件将在相应项目名称的目录下。

在源码目录运行:

docker build . -t proxy:v1

即可自动编译,编译完成后,可执行程序 proxy_server 可以在 docker 镜像的 /usr/local/bin/ 目录下找到。

proxy server 它提供了较完整的功能,它可以非常完美的作为 tun2socks 后级用于全局代理上网等事宜,example 目录则主要用于编程示例。

proxy server 提供了以下参数,参数除 config 之外,即可于配置文件也可用于命令行:

作为一个 proxy 服务器,它主要实现了 socks5/socks4/http/https 等协议的代理功能,示例如下:

./proxy_server --server_listen 0.0.0.0:1080

上述示例中,proxy_server 监听在 0.0.0.0:1080 端口,客户端可以通过 socks5/socks4/http/https 等协议连接到 proxy_server 进行代理,请注意,默认情况下需要认证才能连接,认证信息为 jack:1111,若需要设置为无需要认证代理模式,必须置 auth_users 参数为 "",如:

./proxy_server --server_listen 0.0.0.0:1080 --auth_users ""

若是需要作为中间级联服务时,proxy_pass 指定上游代理服务地址,格式为 url 格式,如果有认证信息并必须包含认证信息,如: https://jack:1111@example.com:1080/,则必须在 proxy_pass 中包含认证信息,否则将连接失败,示例如下:

./proxy_server --server_listen 0.0.0.0:1080 --proxy_pass https://jack:1111@example.com:1080/

上游代理服务若是 socks5 协议且需要使用 ssl 加密传输时,url 的 scheme 必须以 s 结尾,如: socks5s://jack:1111@example.com:1080/。

当作为服务器启用 SSL 加密传输时,需要配置 ssl_certificate_dir 参数指定证书密钥等文件目录,这样客户端就可以通过 https/socks5s 加密协议连接到 proxy_server 进行代理,示例如下:

./proxy_server --server_listen 0.0.0.0:1080 --ssl_certificate_dir /path/to/ssl/cert

若是运行在路由器作为全局代理,proxy_server 支持 TPROXY 透明代理功能,示例如下:

./proxy_server --transparent true --server_listen 0.0.0.0:1080 --proxy_pass https://jack:1111@example.com:1080/

上面示例中,proxy_server 监听在 0.0.0.0:1080 端口, 通过在路由器上配置 TPROXY 到 0.0.0.0:1080 端口,将需要代理的 IP 通过 TPROXY 的方式连接到 proxy_server,proxy_server 会将客户端请求通过 https://jack:1111@example.com:1080/ 进行代理,客户端无需做任何配置。

代理隧道功能主要实现了 proxytunnel 它的功能,具体使用方式示例如下,在 .ssh 目录中的 config 配置文件中添加如:

Host example
	HostName xxx.xxx.xxx.xxx
	IdentityFile /root/.ssh/id_rsa
	User root
	ProxyCommand /path/to/proxy_server --stdio %h:%p --proxy_pass https://user:pass@proxy.server:8443

然后当使用 ssh 连接主机 example 时将会按上述配置文件中参数创建 proxy_server 代理隧道,通过 proxy_pass 指定的代理服务器连接目标 HostName 所指的服务器。

proxy_server 支持使用 PAM 模块进行认证(仅支持 pam 的 linux 平台,编译 proxy_server 时需要在 cmake 中添加 -DENABLE_USE_PAM_AUTH=ON 选项以启用 PAM 模块认证功能),具体使用方法如下:

1. 配置 PAM 服务,如将 doc 目录下 pam.example 下的文件 proxy-service 复制到 /etc/pam.d/ 目录中,文件名即为 PAM 服务名称。
2. 在 proxy_server 中指定 PAM 服务名称,如 --pam_auth proxy-service。
3. 使用 linux 命令添加用户到 PAM 服务中,如 useradd jack,其中 jack 为用户名,使用 passwd jack 设置密码如 1111。
4. 测试认证是否生效,如 curl -x http://jack:1111@localhost:1080/ https://google.com,如果返回 200 OK 则说明认证生效。

PAM 模块认证可以使用 linux 命令添加或管理用户,可以极大的方便 proxy_server 的用户管理,而不必依赖复杂的数据库系统,当然如果你是开发人员,也可以开发一个支持数据库认证的 PAM 的 so 模块(可参考 doc 下 pam.example 的 pam_sqlite.c 如何实现 PAM 认证模块),或者使用 PAM 模块认证来实现 LDAP 认证等等各种方式。

proxy server 不仅是一个 proxy 服务器,同时还可以做为一个真实的静态文件 http 服务,且支持 http range,所以也可以作为 http 音视频文件服务器,播放器播放 http 音视频文件时通过 http 的 bytes range 协议进行 seek(快进快退),使用方法如下

./proxy_server --autoindex true --http_doc /user/music --server_listen 0.0.0.0:1080

在目录 /user/music 中添加音乐文件(以及.lrc歌词文件),复制本项目中 example/music 下的 index.html 放入 /user/music 目录中,然后使用浏览器打开地址 http://localhost:1080/ 运行效果(浏览器打开):

image

当然,如果你希望只有你自己可以访问,那么在上面命令行添加参数 --htpasswd true 并通过参数 --auth_users 配置登陆用户名和密码,打开页面时就会要求验证登陆。

本人的 blog 就是直接运行在 proxy_server 上的静态页面(由 jekyll 生成),它同时也是我的代理服务,还是我的 音乐播放器

在路由器上配置全局代理科学上网

有任何问题可加tg账号: https://t.me/jackarain 或tg群组: https://t.me/joinchat/C3WytT4RMvJ4lqxiJiIVhg