XPROXY

Installing Dongles

How to wire 4G/LTE dongles into the XProxy box and verify each modem is producing a working proxy port.

Before you start

  • XProxy box (or Ubuntu PC) already powered and reachable on the LAN.
  • Powered USB hub with a 12V adapter — never bus-power a hub when running 4+ dongles.
  • SIM cards with an active data plan, PIN lock disabled.
  • XProxy XH22, Huawei E3372, or any compatible HiLink dongle.

Step 1 — Insert the SIM card

Pop the back cover, slide the SIM into the tray (chip facing the board), and snap the cover back on. Each dongle holds exactly one SIM.

Inserting a SIM into an XProxy XH22 dongle

Step 2 — Plug dongles into the USB hub

Insert each dongle into the powered hub. Leave at least one port free between dongles when possible — it reduces RF cross-talk and improves rotation speed.

Do NOT plug dongles directly into the XProxy box for production use. The box has only 3 USB ports and shared power. Always go through a 12V powered hub.

Step 3 — Wait for the panel to detect them

Open the XProxy dashboard and go to Dongles. New dongles appear within 10–30 seconds with status connecting → connected. Each detected dongle is automatically assigned an HTTP port (5000 + index) and a SOCKS5 port (5001 + index).

XProxy dashboard showing connected dongles

Step 4 — Verify the proxy

Test from any machine on the same LAN:

bash
curl -x socks5h://USER:PASS@<xproxy-ip>:5001 https://api.ipify.org

You should see a mobile carrier IP. If the IP matches your home WAN instead, the dongle is in tethering mode — power-cycle the hub or re-insert the SIM.

Once all dongles are green you can set rotation policy per port (timer, on-request URL, or API trigger) from the Rotation tab.

Understanding dongle labels

XProxy uses a label system to identify each physical dongle in the panel. A label is a number (11–254) that matches the 3rd octet of the dongle's gateway IP address.

  • Example: a dongle with gateway 192.168.11.1 has label 11.
  • Every dongle on the same system must have a unique label.
  • Avoid labels 0 and 1 — they conflict with common home router IPs (192.168.0.1 / 192.168.1.1).
  • If you purchased dongles from our shop, labels are pre-configured — no action needed.
Labels only need to be unique within a single XProxy system. Duplicate labels across separate systems are fine.

Automatic label changing

For Huawei and ZTE dongles, XProxy can set the label automatically:

  1. Plug one dongle at a time into the XProxy box or server.
  2. Open the XProxy dashboard → Device Settings → Dongle Devices.
  3. In the Label column, click Edit and enter the label value.
  4. Wait for the dongle to reboot. Note the new label on the dongle.
If the dongle isn't detected, check the password settings first. Some dongles require a password change before the label can be set.

Manual label changing

If automatic label changing doesn't work, change the label manually from a Windows PC:

Huawei dongles

  1. Plug the dongle into a Windows PC.
  2. Open the dongle panel at 192.168.8.1 or 192.168.1.1.
  3. Find the DHCP menu and change the gateway to 192.168.X.1 (X = your label, e.g. 11).
  4. Click Save. If prompted for a password on first use, set it to admin / admin123.

ZTE dongles

  1. Plug the dongle into a Windows PC.
  2. Open the dongle panel at 192.168.0.1.
  3. Go to Advanced Settings → Router and set: IP Address = 192.168.11.1, DHCP Pool = 192.168.11.100–192.168.11.200.
  4. Click Save. If prompted for a password, set it to admin / admin.
× Zoomed document image preview