Skip to content
These docs describe the Veilus release after v0.2.1, coming soon. If you have v0.2.1, some screens and features (Datasets, Trash, the new profile panel, many MCP tools) are not in your version yet.

Proxy Setup

Manual proxyProxy pool
Set inThe profile’s Network tabProxy pools in the sidebar, then assign to profiles
Good forOne profile, one proxyMany profiles sharing a list of proxies or one provider gateway

If a profile has both, the pool proxy takes priority at launch. A profile with neither connects directly.

The Proxy column of the profile list shows what each profile uses: No Proxy, Manual, the pool’s name, or Dead Proxy when the proxy at the profile’s slot failed a health check.

  1. Open the profile’s panel and go to Network.
  2. Under Manual Proxy, turn on Enable Proxy.
  3. Pick the Type:
    • HTTP
    • SOCKS5
    • Residential: for residential proxies that work over HTTP
  4. Enter Host and Port, and Username and Password if the proxy needs them.
  5. Click Test Proxy. On success it shows Connected • <latency>ms • IP: <exit IP>.
  6. Click Save Changes.

Open Proxy pools in the sidebar and click New Pool. There are two kinds.

A list of proxies, one per line, in any of these forms:

host:port
host:port:user:pass
user:pass@host:port

Start a line with socks5:// for a SOCKS5 proxy, for example socks5://user:pass@host:port or socks5://host:port:user:pass. A line starting with http://, or with no prefix, is an HTTP proxy. Each proxy keeps its own type, so one pool can mix HTTP and SOCKS5.

https:// proxies are not supported: Veilus cannot open an encrypted connection to a proxy, and lines starting with https:// are rejected.

Choose an Assignment Mode:

  • 1:1 Dedicated: each profile gets its own proxy (slot).
  • Round Robin: profiles share the proxies in turn.

One gateway URL from your proxy provider, for example http://user:pass@gate.example.com:8000. Use socks5:// at the start for a SOCKS5 gateway. https:// gateway URLs are rejected.

Set Session Type to match how your provider’s gateway behaves: Sticky (same IP per session) or Per Request (rotate each call). The provider does the rotation.

A pool’s type cannot be changed after it is created.

  • To selected profiles: tick profiles, click Assign Pool in the bulk action bar, pick a pool.
  • To every profile in a filtered list: filter the list, then click Assign Pool in the page header.
  • To one profile: in its Network tab, pick a pool under Proxy Pool.
  • When creating profiles: pick a Proxy pool in Batch create.

If a 1:1 pool has fewer free proxies than the profiles you are assigning, choose:

  • Strict 1:1: only the first profiles get a proxy; the rest are skipped.
  • Round-robin: every profile is assigned, and some share a proxy.

A profile in the Trash keeps its slot in a static pool. Delete it forever from the Trash to free that proxy for other profiles. Deleting a pool removes all of its slot assignments.

On the Proxy pools page, click Import and choose a .txt or .csv file.

  • TXT: one proxy per line, in the forms shown above, including the optional http:// or socks5:// prefix.
  • CSV: a header row with host and port, and optionally username, password, country, timezone, city. Other columns are ignored. For a SOCKS5 proxy, put socks5:// before the host, for example socks5://1.2.3.4.

The preview counts valid proxies and lists skipped lines with the reason. Import into a New pool or Add to existing pool (static pools). Proxies already in the pool, with the same host, port, username and type, are skipped.

To export, use Export all on the Proxy pools page, or Export on a pool’s page. Choose TXT (one proxy per line; a rotating pool is written as its endpoint URL) or CSV (with location columns; rotating pools are left out). SOCKS5 proxies keep their socks5:// prefix, so the file imports back with the same type.

  • Test Proxy in a profile’s Network tab tests the manual proxy.
  • Test on a pool runs a Health Check of every proxy: alive or dead, latency, external IP and location.
  • Geo on a pool looks up each proxy’s country, city and timezone.

A profile that goes out through a US IP but reports a Vietnam timezone contradicts itself. Before every launch, Veilus compares the profile’s timezone with where its proxy (or your own network, with no proxy) exits.

Choose what happens in Settings → Timezone check:

SettingBehavior
Block (default)Don’t launch; show the two conflicting timezones
WarnShow the conflict, but let you open the profile anyway
OffNo check. Launches faster, because the check calls through the proxy and then looks up the IP’s location

When the check stops a launch, you can choose Edit profile or Change proxy.

Veilus does not change a profile’s timezone on its own when you assign a proxy. To bring them in line:

  • In the Network tab, with a pool selected, click Match to proxy. Veilus measures the proxy’s real exit IP and proposes the matching timezone; coordinates follow when you save.
  • If a static pool’s proxies have a detected location (from Geo or a health check) that differs from the profile’s timezone, the Network tab shows Proxy location mismatch with a Fix button.
  • Or set the Timezone yourself on the Fingerprint tab.
ProblemWhat to do
Test Proxy failsCheck host, port, type and credentials
Launch blocked by the timezone checkUse Match to proxy or change the profile’s timezone, or pick a proxy in the profile’s region
Launch fails with proxy pool ’…’ has no usable proxy or mentions https://The profile’s pool is empty or its gateway URL can’t be used (for example https://). Edit the pool or assign another one. Veilus will not launch the profile without its proxy
Dead Proxy in the listRun the pool’s health check, replace the dead proxy
WebRTC shows your real IPSet WebRTC Mode on the Fingerprint tab (see Fingerprinting)