froest2012 / pegasocks

A lightweight proxy client written in C, intends to support multiple protocols(trojan etc.)

pegasocks

是一个基于 socks5 协议的代理客户端，意图在于支持多种类型的代理服务。 C 语言编写，轻量，支持类 unix 系统。

⚠️ 这是一个正在开发中的项目，请自行考虑使用成本和风险。

特点

与其他大多数支持多协议的客户端不同，pegasocks 不依赖各种第三方 core(比如 v2ray-core 等)，而是真的去实现相关协议的拆装，并且尽可能的照顾性能。因此它

1. 🍃 足够轻量，没有 QT 或是 boost 或是其他第三方二进制的依赖。
2. 🚀 性能优先，默认多个 worker 线程，因此理论上吞吐量会比较高（待benchmark）
3. 🚥 这是一个 learn by doing 项目，欢迎大家 review 代码，提供优化思路和 C 语言编程相关的指导。
4. ❌ 没有 GUI，可以直接配合 systemd, launchd, rc 或是各种自定义脚本配置开机启动。后期计划开发一个简单的 tray indicator，在系统的托盘里显示，并且提供一些简单的交互，总之重型的 GUI 是不在考虑范围内的。

依赖

• openssl 1.1.1
• libevent2
• json-c

编译

mkdir build && cd build

cmake .. && make

运行

pegas -c config.json -t 4

• -c 指定配置文件，默认会依次尝试 $XDG_CONFIG_HOME/.pegasrc 或者 $XDG_CONFIG_HOME/pegas/config
• -t 指定工作线程数量，默认为 4

配置

见配置文档

交互

程序启动后，默认监听 /tmp/pegas.sock(可以配置，同时支持 TCP 端口和 unix socket)，通过 unix socket 可以和主程序进行交互。支持的命令有：

• GET SERVERS，将返回服务器的信息
• SET SERVER $idx，设置当前服务器

在 linux 下 socat 演示

另外，支持系统托盘，见下

系统托盘

默认编译二进制文件不带 GUI，带上参数 -DWITH_APPLET=1 开启系统托盘功能。

cmake -DCMAKE_BUILD_TYPE=Release -DWITH_APPLET=1 .. && make

Linux

从命令行启动时，将 icon.svg 放到 pegas 同级目录，然后正常使用即可。

OSX

从命令行运行时，将 icon.png 放到 pegas 同级目录，然后正常使用即可。

构建流程

在 OSX 平台有打包成 app bundle 的脚本，在完成上面的 build 步骤，确认有 build/pegas 文件

然后

cd .. && ./bundle.sh

build 目录下会出现 pegas.app，最后在用户目录下创建 ~/.pegasrc，写入 json 格式的配置文件。

更多参数修改可以手动修改 bundle.sh 作出适合自己的调整。

如果遇到无法启动的状况，请确认系统安装了 libevent 和 json-c (brew install libevent json-c)

开发计划

• 多种协议支持
  • trojan
    • trojan-gfw
    • trojan-go
  • v2ray
    • vmess
    • tcp
    • websocket
    • tls + websocket
• 平台适配
  • linux
  • osx
  • *BSD（大部分 BSD 应该都可以支持，只在 OpenBSD 下做了测试）
    • OpenBSD
    • [?] FreeBSD
    • [?] NetBSD