linuxgarry/clashx-random-proxy

clashx-random-proxy is a self-hosted proxy pool that turns a database of Clash protocol proxy nodes into a simple HTTP proxy service, where each port number maps to a randomly selected live exit IP address. The setup stores a large collection of proxy nodes, supporting protocols including vmess, vless, trojan, and others, inside a PostgreSQL database. Every day at 3am the system tests every node for connectivity, marking each one as alive or inactive based on the result. When you request a specific port number through GET /proxy/{port}, the service picks a random live node, assigns it to that port, and that port then functions as a usable HTTP proxy. Requesting the same port again swaps in a different node, which makes rotating your exit IP as simple as refreshing the endpoint. Ports that go unused for 5 minutes are automatically released back into the pool. The service runs as a single Docker container that combines two processes: mihomo, which handles the actual proxy connections and listens across a configurable port range, and a FastAPI web service that manages node selection, exposes the API endpoints, and runs the daily health test using APScheduler. The two processes are linked together so that if either one exits, the whole container restarts. It is designed to run on a home server, uses macvlan networking to give the container a fixed LAN IP address, and connects out to an external PostgreSQL database rather than bundling one. Configurable settings include the port range, the testing schedule, the batch size used for node testing, and the concurrency level. The README notes plainly that this is a private project intended for personal use only, not a public service.