Proxy Rotation

figranium includes a robust proxy management system to evade IP-based blocking. You can configure proxies globally or enable rotation on a per-task...

Configuring Proxies#

Navigate to Settings > Proxies to manage your proxy list.

Adding a Proxy#

Click Add Proxy and enter the details:

Server: The proxy address (e.g., http://192.168.1.5:8080, socks5://10.0.0.5:1080).
Username/Password: Optional credentials for authentication.
Label: A friendly name (e.g., "US Residential").

Importing Proxies#

You can bulk import proxies using a JSON or text file

Rotation Strategies#

figranium supports two rotation modes:

Round-Robin: Cycles through the list sequentially (Proxy 1 -> Proxy 2 -> ...). This ensures even usage.
Random: Picks a random proxy from the list for each execution.

Default Proxy#

You can designate a specific proxy as the "Default". This proxy will be used for all tasks unless rotation is explicitly enabled.

Include Host IP#

You can choose whether your server's own IP address should be included in the rotation pool. This is useful for testing or when running on a residential connection.

Enabling Rotation in Tasks#

In the Task Editor, enable the Rotate Proxies checkbox.

When enabled: The task will use a proxy from the rotation pool according to the strategy.
When disabled: The task will use the Default Proxy (if set) or the Host IP.

API Management#

You can also manage proxies via the API:

GET /api/settings/proxies: List all proxies.
POST /api/settings/proxies: Add a proxy.
POST /api/settings/proxies/rotation: Update rotation settings.