Go to file
KernelErr bff92738d5 Allow config path from FOURTH_CONFIG 2021-11-01 16:06:47 +08:00
.github/workflows Add publish CI and run fmt 2021-11-01 15:56:57 +08:00
src Allow config path from FOURTH_CONFIG 2021-11-01 16:06:47 +08:00
tests Add upstream scheme support 2021-10-31 19:21:32 +08:00
.gitignore First commit 2021-10-21 16:43:59 +08:00
Cargo.lock Add upstream scheme support 2021-10-31 19:21:32 +08:00
Cargo.toml Add upstream scheme support 2021-10-31 19:21:32 +08:00
LICENSE First commit 2021-10-21 16:43:59 +08:00
README-EN.md Allow config path from FOURTH_CONFIG 2021-11-01 16:06:47 +08:00
README.md Allow config path from FOURTH_CONFIG 2021-11-01 16:06:47 +08:00
example-config.yaml Add upstream scheme support 2021-10-31 19:21:32 +08:00

README.md

Fourth

这一波在第四层。

CI

English

积极开发中0.1版本迭代可能较快

Fourth是一个Rust实现的Layer 4代理用于监听指定端口TCP/KCP流量并根据规则转发到指定目标目前只支持TCP

功能

  • 监听指定端口代理到本地或远端指定端口
  • 监听指定端口通过TLS ClientHello消息中的SNI进行分流
  • 支持KCP入站警告未测试

安装方法

为了确保获得您架构下的最佳性能,请考虑自行编译,首选需要确保您拥有Rust工具链

$ cd fourth
$ cargo build --release

将在target/release/fourth生成二进制文件,您也可以使用cargo install --path . 来安装二进制文件。

或者您也可以使用Cargo直接安装

$ cargo install fourth

或者您也可以直接从Release中下载二进制文件。

配置

Fourth使用yaml格式的配置文件默认情况下会读取/etc/fourth/config.yaml,您也可以设置自定义路径到环境变量FOURTH_CONFIG,如下是一个最小有效配置:

version: 1
log: info

servers:
  proxy_server:
    listen:
      - "127.0.0.1:8081"
    default: remote

upstream:
  remote: "tcp://www.remote.example.com:8082" # proxy to remote address

内置两个的upstreamban立即中断连接、echo返回读到的数据。更详细的配置可以参考示例配置

性能测试

在4C2G的服务器上测试

使用Fourth代理到Nginx直连QPS 120000: ~70000req/s (测试命令:wrk -t200 -c1000 -d120s --latency http://proxy-server:8081

使用Fourth代理到本地iperf38Gbps

io_uring?

尽管经过了很多尝试我们发现目前一些Rust下面的io_uring实现存在问题我们使用的io_uring库实现尽管在吞吐量上可以做到单线程20Gbps相比之下Tokio仅有8Gbps但在QPS上存在性能损失较大的问题。因此在有成熟的io_uring实现之前我们仍然选择epoll。之后我们会持续关注相关进展。

可能以后会为Linux高内核版本的用户提供可选的io_uring加速。

感谢

协议

Fourth以Apache-2.0协议开源。