https://github.com/frkn-dev/pony
Platfrom to manage xray/wireguard/hysteria2
https://github.com/frkn-dev/pony
Last synced: 2 months ago
JSON representation
Platfrom to manage xray/wireguard/hysteria2
- Host: GitHub
- URL: https://github.com/frkn-dev/pony
- Owner: frkn-dev
- License: gpl-3.0
- Created: 2024-10-10T10:58:41.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-03-30T18:45:39.000Z (3 months ago)
- Last Synced: 2026-04-03T04:54:15.325Z (3 months ago)
- Language: Rust
- Homepage: https://frkn.org
- Size: 7.38 MB
- Stars: 15
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[](https://github.com/frkn-dev/pony/actions/workflows/release.yml) [](https://github.com/frkn-dev/pony/actions/workflows/rust.yml)
# Pony - a cluster platform for Xray/Shadowsocks/Hysteria2/Wireguard/MTproto
Pony is a lightweight control plane and orchestration platform for modern proxy protocols. It simplifies the deployment and unified management of Xray, Shadowsocks, Hysteria2, MTproto and Wireguard servers, providing a single pane of glass for your network infrastructure.
## Architecture
Contains parts
- agent — manages Xray/Wireguard/Hysteria2 connections/users/metrics
- api — manages cluster of servers, gets API calls and send commands to servers
- auth — handles auth for Hysteri2 cleints
- utils — helper to work/debug Bin messages
### As dependencies the platfrom has
- ZeroMQ — communicating bus
- PostgreSQL — user and node data storage
- Xray Core
- Hysteria2
- MTproto
- Wireguard
- Nginx — reverse proxy
### Features
- Standalone Agent — can run without external dependencies: just WG or/and Xray Core and a config file.
- Automatic Xray Config Parsing — reads xray-config.json to fetch inbounds and settings automatically.
- Low Resource Usage — works perfectly on low-cost 1 CPU ($5 VPS) machines.
- Protocol Support — handles VLESS TCP, VLESS gRPC, VLESS Xhttp, Hysteria2 and Wireguard connections.
- Cluster Management — API manages users and nodes across the entire cluster.
- Node Health Monitoring — API periodically checks the health and status of all connected nodes.
- Metrics System — system and logic metrics are collected in Graphite format and stored in Clickhouse for analytics.
- Trial User Support — supports trial users with daily traffic limitation control.
# Utils — CLI Tool for Working with rkyv Messages and ZeroMQ
## Overview
utils is a command-line utility to generate, verify, and send binary rkyv messages used in the messaging system over ZeroMQ. It helps to easily create valid messages from JSON, serialize them to binary files, and publish them on a ZeroMQ topic.
Usage
Generate binary message from JSON
```
cargo run --bin utils gen -i path/to/input.json -o path/to/output.bin
-i — path to the JSON file describing the message
-o — path to save the generated binary file
The JSON must match the Message struct format.
```
Send a binary message to ZeroMQ publisher
```
cargo run --bin utils send -t topic -i path/to/message.bin -a tcp://127.0.0.1:3000
-t — topic (channel) to publish on
-i — path to the binary message file
-a — ZeroMQ publisher address
```
Combined mode: generate and send in one step
cargo run --bin utils all -i path/to/input.json -b path/to/output.bin -t topic -a tcp://127.0.0.1:3000`
Generates binary from JSON, saves it, and immediately publishes it to the given topic and address.
```
Example JSON for Message
{
"conn_id": "9658b391-01cb-4031-a3f5-6cbdd749bcff",
"action": "Create",
"tag": "Wireguard",
"wg": {
"keys": {
"privkey": "privatekeyhere",
"pubkey": "publickeyhere"
},
"address": {
"ip": "10.10.0.24",
"cidr": 32
}
},
"password": null
}
```