OpenCode IP Rotator & Proxy Server

A microservice-architected Cloudflare WARP IP rotator and proxy server for OpenCode Zen. Designed to prevent HTTP 429 rate limits, guarantee unique IP rotation per cycle, log usage metrics into SQLite, and display real-time statistics on a clean web dashboard. - Verified Shared Egress: The proxy and WARP service share one network namespace, so the observed egress path is the path used for upstream requests. - Microservices Architecture: Decoupled proxy-server (FastAPI) and warp-rotator (Cloudflare WARP daemon) services built with Docker Compose. - Clean Management Dashboard: Lightweight Web UI displaying active connections, current location, token statistics, and manual rotation controls. - SQLite Data Persistence: Stores token consumption, model request counts, and historical IP rotation logs on disk. - USD Savings Calculator: Estimates cost savings per model based on prompt and completion token rates. - Table Pagination: Built-in 5-item pagination for model usage and IP rotation log tables. - Active Flow Locking: Protects active SSE streams from being interrupted during IP rotation — _active_flows_count is held for the full lifetime of the generator, not just until return. - Rate-limit Preservation: Returns upstream 429 details and Retry-After without attempting to bypass model, account, provider, or subscription limits. - Anthropic API Compatibility: Native /v1/messages endpoint for Claude clients and the Vercel AI SDK @ai-sdk/anthropic provider. - Custom Proxy Pool Support: Round-robin outbound proxy pool via data/proxies.txt or PROXY_LIST environment variable. 1. Proxy Server (`server.py`): An OpenAI-compatible API proxy server running on http://127.0.0.1:8000/v1. It processes requests, forwards headers dynamically, handles streaming SSE responses, and presents a Web Management Dashboard. 2. Rotator Module (`rotator.py`): Owns the WARP network namespace and exposes a private health/rotation control endpoint. Manual rotation is authenticated; upstream 429 responses are not used as a rotation trigger. 3. Container Manager (`manager.py`): Provides automated ephemeral container lifecycle management. Triggers container self-destruction and re-creation once a defined rotation threshold is reached to ensure fresh hardware identifiers (machine-id). OpenCode IP Rotator & Proxy Server is the open-source project alztrk/opencode-ip-rotator (https://github.com/alztrk/opencode-ip-rotator) by alztrk, released under MIT. Ion packages it unmodified from commit fd8d86ff06c5, adding only a manifest, an icon and a start script.

Written by alztrk, published to Oikou by Ben Grande.

• ★ 26 stars on GitHub
• Licence: MIT
• Upstream version v1.0.0
• Built from commit fd8d86ff06c5

View the repository on GitHub

Not rated. Nobody has said who this app is suitable for, so Personal Clouds and the Oikou app treat it as 18+.

Internet

It asks to reach these hosts, and no others:

• fonts.googleapis.com
• cdn.tailwindcss.com
• fonts.gstatic.com
• opencode.ai
• api.ipify.org
• ifconfig.me
• ip-api.com

While your Personal Cloud builds it, the build asks to download from:

• registry.npmjs.org
• registry.yarnpkg.com
• pypi.org
• files.pythonhosted.org
• github.com
• codeload.github.com
• objects.githubusercontent.com
• dl-cdn.alpinelinux.org
• deb.debian.org
• security.debian.org
• proxy.golang.org
• index.crates.io
• static.crates.io
• pkg.cloudflareclient.com

A VPN tunnel for its traffic

Can send its traffic through a VPN (Cloudflare WARP) from its container, with network administration; what goes through the tunnel bypasses your Personal Cloud’s internet allowlist: Sends its requests to OpenCode through Cloudflare WARP and reconnects for a new address when it is rate limited

All its other traffic goes through the tunnel too.

You choose the VPN servers it may reach, and whether nothing leaves except through the tunnel. Its container runs as root in a network of its own, and the VPN provider sees its traffic.

Personal Cloud tools

None. It uses nothing from your Personal Cloud beyond its own storage.

Notifications

It does not send push notifications.

Storage

Up to 512 MB on your Personal Cloud.

Sign in to add this web app to a Personal Cloud of yours. It runs there, on your own computer, and you open it from there; nothing is installed on your phone.

Sign in to add