Rotation Engine
Rotation Engine
Saved rotators, source pools, selection strategies, policies, local endpoints, sessions, and traffic decisions.
The Rotation Engine turns saved proxy sources into a local HTTP/CONNECT endpoint that selects a proxy per request or session.
What It Manages
| Object | Purpose |
|---|---|
| Rotator | Saved source list, tags, selection strategy, and policy. |
| Source | Saved proxy pool or inline proxy list. |
| Policy | Runtime rules for sessions, health checks, cooldown, quarantine, fallback, and concurrency. |
| Runtime | Local endpoint bound to 127.0.0.1. |
| Traffic entry | Recent request record with selected proxy, decision, reason, status, and bytes. |
Typical Flow
- Build a checked and benchmarked pool.
- Create a rotator using the pool as a source.
- Pick round robin, random, or least recently used.
- Attach the Balanced Rotation policy.
- Start the local runtime.
- Point a compatible client to the local endpoint.
- Watch traffic decisions and proxy health.
Tiny Features
| Feature | Detail |
|---|---|
| Source types | Saved proxy pools and inline direct proxy lists. |
| Selection | Round robin, random, and least recently used. |
| Sessions | Global session by default, optional sticky session by target host. |
| Rotation triggers | Request count, session age, session bytes, status codes, proxy availability, cooldown, quarantine, and source exhaustion. |
| Failure handling | Cooldown for short pauses and quarantine after repeated failures. |
| Fallback | Can choose fallback sources when primary sources are exhausted or unavailable. |
| Concurrency | Tracks active requests and enforces max concurrent requests per proxy. |
| Traffic decisions | Logs selected proxy, source, decision, reason, session key, status, bytes, duration, and errors. |
Rotation Engine is for operating a source set. Use Proxy Checker and Benchmark first to improve the quality of that source set.