Fc0re is a lightweight control plane and orchestration platform for modern proxy protocols. It simplifies the deployment and unified management of Xray, Shadowsocks, Hysteria2, MTproto, Wireguard and Amnezia-Wireguard servers, providing a single pane of glass for your network infrastructure.
| Binary | Purpose |
|---|---|
api |
Core API: subscriptions, connections, nodes, traffic accounting, metrics ingestion, admin panel. |
node |
Agent that runs on every proxy node, drives Xray/Hysteria2/Wireguard/Amnezia-Wireguard/MTproto and reports stats. |
auth |
Auth sidecar: keeps a local copy of connection state and answers /auth requests from proxy nodes. |
- pixel — web analytics:
pixel-agentandpixel-agent-backfill. - payment-gw — payment gateway, business
dashboardand marketing servicemrkting.
- ZeroMQ — control bus between API, nodes and auth services.
- PostgreSQL — subscription and node data storage.
- Xray Core
- Hysteria2
- Teleproxy (MTProxy)
- Wireguard
- Amnezia Wireguard
- Nginx — reverse proxy
- Standalone Node — can run without external dependencies.
- Automatic Xray Config Parsing — reads
xray-config.jsonto fetch inbounds and settings automatically. - Low Resource Usage — works perfectly on low-cost 1 CPU ($3 VPS) machines.
- Protocol Support — handles VLESS TCP, VLESS gRPC, VLESS Xhttp, Hysteria2, Wireguard and Amnezia 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 memory with snapshot persistence.
- Rust (nightly toolchain)
- PostgreSQL 17+
- ZeroMQ libraries installed on your system
- Protobuf Compiler (
protoc)
git clone https://github.com/frkn-dev/fcore.git
cd fcore
cargo build --release --bin api --no-default-features
cargo build --release --bin auth --no-default-features
cargo build --release --bin node --features xray,wireguard,amnezia-wgEach binary has its own example config, systemd unit and README inside src/bin/<name>/:
cp src/bin/api/api-example.toml /etc/fcore/api/config.toml
cp src/bin/auth/auth-example.toml /etc/fcore/auth/config.toml
cp src/bin/node/node-example.toml /etc/fcore/node/config.tomlEach binary has an install script in deploy/:
sudo ./deploy/api-deploy.sh v0.5.16
sudo ./deploy/auth-deploy.sh v0.5.16
sudo ./deploy/node-deploy.sh v0.5.16This project is licensed under the GPLv3 - see the LICENSE file for details.