a6216abcd/free-residential-ip-proxy-controller

This project is a lightweight proxy management system that automatically rotates residential IP addresses for outgoing internet connections. The README is written in Chinese. The system is built around two main parts: a control node deployed to Cloudflare Workers (a serverless hosting service), and a small agent program that runs on one or more Linux VPS servers you own. The control node provides a web dashboard where you can see which VPS servers are active, what IP address each one is currently using, and whether each connection passes a quality check. The quality check filters out datacenter IP addresses and verifies that the connection can reach YouTube streaming, which the project treats as a signal of a clean residential-grade route. You can also click a button in the dashboard to force an immediate IP rotation, swapping out the current address within about 15 seconds. The VPS agent installs with a single command, sets up a background service, and then continuously fetches fresh VPN connection details, applies the quality checks, and exposes a local Socks5 or HTTP proxy port that other programs can connect through. Configuration, including target country selection, is pushed down from the control node so you do not need to log into each VPS individually. The project stores configuration and status data in Cloudflare D1, which is a serverless SQLite database, so running the control panel costs nothing beyond any Cloudflare usage fees. The stated use cases are personal quantitative trading programs, network testing, and light data collection. The README includes a compliance note asking users to confirm their intended use is legal in their jurisdiction and on target services.