vvbbnn00/warp-clash-api — explained in plain English
Analysis updated 2026-06-24
Generate a subscription URL that lets Clash or Surge connect through Cloudflare's WARP+ network without manual configuration.
Automatically keep your WARP+ traffic topped up by running the server continuously in the background.
Filter available WARP server addresses by latency and packet loss so your VPN app always connects to the fastest node.
| vvbbnn00/warp-clash-api | clips/pattern | mailpile/mailpile | |
|---|---|---|---|
| Stars | 8,853 | 8,858 | 8,842 |
| Language | Python | Python | Python |
| Setup difficulty | moderate | easy | moderate |
| Complexity | 3/5 | 2/5 | 3/5 |
| Audience | general | data | general |
Figures from each repo's GitHub metadata at analysis time.
Requires an always-on server or machine to keep running, the primary README is in Chinese.
Cloudflare WARP is a free internet service that routes your traffic through Cloudflare's network, and the paid WARP+ tier provides access to faster nodes. WARP-Clash-API is a self-hosted tool that lets you use WARP+ through popular VPN client apps like Clash, Surge, and Shadowrocket by generating a subscription link those apps can read. The README is primarily in Chinese, though the project description includes an English summary. The tool runs as a small server on your own machine or a remote server. Once running, it produces a subscription URL that you paste into a VPN client app. That app then connects using the WARP+ configuration the server provides. One of the tool's features is automatically refreshing WARP+ traffic allowance by periodically calling Cloudflare's systems, which the README says can add 1 GB of traffic every 18 seconds. Another feature is IP selection: since WARP uses many different server addresses, the tool tests them for speed and packet loss and filters out slow or unreliable ones. You can also run the IP selection process manually at any time. The configuration is done through environment variables in a file you create locally. Options include how often to refresh traffic, what delay threshold to use when filtering server addresses, whether to protect the subscription URL with a secret key, and whether to share the subscription publicly. Deployment is done via Docker Compose, which means you start the whole service with a single command. An optional configuration file handles any settings you want to change from the defaults. The README notes this is a non-commercial project intended for learning and exchange, not for illegal use. The project builds on several other open-source tools for proxy pooling and WireGuard configuration, which are credited in the README.
A self-hosted server that converts Cloudflare's free WARP+ VPN into a subscription URL for popular proxy apps like Clash, Surge, and Shadowrocket. Automatically refreshes WARP+ traffic allowance and filters servers by speed and reliability.
Mainly Python. The stack also includes Python, Docker.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly general.
This repo across BitVibe Labs
Verify against the repo before relying on details.