12VPX
12VPX Neo
Router

12VPX NEO on a router

12VPX NEO on a router sends the traffic of every device on your network through the VPX service: phones, computers, TVs and game consoles, without installing anything on them. It runs on OpenWrt routers, and on a Linux computer that acts as your network's gateway.

To install it on OpenWrt, follow the OpenWrt setup guide.

Contents

Which routers work

  • OpenWrt 25.12 or newer. Older versions use a different package format.
  • A supported processor: x86, 64-bit ARM (for example MediaTek Filogic, Qualcomm ipq807x, Raspberry Pi 3 and newer) or 32-bit ARMv7 with a hardware FPU (for example Qualcomm ipq40xx and ipq806x, Raspberry Pi 2).
  • Not supported: MIPS routers (including MediaTek MT7621 and MT76x8 and Qualcomm Atheros ath79), Broadcom ARM routers such as the Netgear R7000 and Asus RT-AC68U, and other processors. On these, OpenWrt says the vpx package does not exist.

Official OpenWrt works best. GL.iNet's own firmware has VPN features that can take over your network's traffic, so devices may bypass 12VPX NEO. Turn those features off, or install official OpenWrt; for the GL.iNet Flint 2 we have a conversion guide.

Open 12VPX NEO on your router

Open http://192.168.1.1:9847 in a browser on your network, using your router's address if it is different, and sign in as root with the router's own password. If your router has the LuCI web menu, you also find it under VPN → 12VPX NEO, and Status → Overview starts with a section that shows whether you are connected.

You can also control the router from the 12VPX NEO desktop app on your computer. See Web interface and remote control.

Once connected, the router stays connected by itself; you don't need to keep the browser open.

Router Mode

Router Mode is what sends your devices' traffic through 12VPX NEO. On OpenWrt it is on by default, for your main network (lan).

To choose the networks:

  1. Open Settings → Routing Rules → Router Mode.
  2. Under Networks using the VPN, select the networks, such as lan and guest.
  3. Choose Save.

Devices on networks you don't select use your normal internet connection. All devices still use the router's DNS, which is protected either way, as long as the router asks a public DNS server. See When your router is behind another router.

Router Mode needs TUN or TPROXY capture. With Proxy Only, devices on your network are not covered.

A device doesn't use 12VPX NEO

Check these in order:

  1. The device uses the router. It must be connected to this router's network, with the router as its gateway. Usually that is automatic.
  2. Its network is selected under Networks using the VPN, and the RTR code in the desktop app shows that Router Mode is active.
  3. The device is not excluded under Excluded Devices.
  4. Routing sends it there. With Exclude local China, Chinese sites connect directly on purpose. See Routing in 12VPX NEO.

When your router is behind another router

On OpenWrt, if your router's internet port is connected to another router, such as your internet provider's modem, your devices' DNS lookups may not be protected. The other router usually tells OpenWrt to ask it for addresses, at a local address such as 192.168.1.1. OpenWrt then asks it directly, outside the VPX service, so your devices can get wrong addresses from your internet provider and some websites don't load.

Newer versions of 12VPX NEO show "LAN DNS is not protected" under Logs when Router Mode starts in this setup.

To fix it, let OpenWrt ask only a public DNS server. Open an SSH session to the router and run:

uci add_list dhcp.@dnsmasq[0].server='119.29.29.29'
uci set dhcp.@dnsmasq[0].noresolv='1'
uci commit dhcp
/etc/init.d/dnsmasq restart

While 12VPX NEO is connected, these lookups then go through the VPX service. 119.29.29.29 is a public DNS server that also works in China when 12VPX NEO is disconnected.

Excluded Devices

To keep one device, such as a smart TV, on your normal internet connection:

  1. Open Settings → Routing Rules → Excluded Devices.
  2. Enter the device's IP address, or a range, and a name if you like.
  3. Choose Add.

Give the device a fixed address in your router's DHCP settings first, so the exclusion keeps matching it. Excluded devices still use the router's DNS. With TUN capture, a change applies after you reconnect; with TPROXY it applies right away.

When the connection drops

When you press Disconnect, your devices go back to the router's normal internet connection. If the connection drops by itself and the Kill Switch is on, the router blocks internet traffic until it reconnects. Restore Internet stops that and returns your devices to the normal connection.

Linux gateway

Router Mode also works on a Linux computer that your other devices use as their gateway. It doesn't work on Windows or macOS.

  1. Under Router Mode, select the network adapters your devices are connected to.
  2. Set this computer as the gateway on your devices, or in your router's DHCP settings. 12VPX NEO does not hand out addresses itself.
  3. Optionally turn on LAN DNS, which answers DNS lookups for your devices on port 53. Then set this computer as their DNS server. It starts when you connect and stops when you disconnect, and needs port 53 to be free.

OpenWrt already has its own DNS service, so don't turn on LAN DNS there.

Updating on OpenWrt

Update the vpx package in System → Software like any other package. The connection drops for a moment while the new version installs.

Updating from version 26.10.43 or 26.10.44

These two versions stop 12VPX NEO before OpenWrt has downloaded the update, so the update fails. To update from them, open an SSH session to the router and run:

mkdir -p /tmp/vpx-apk-cache
apk update
apk upgrade --no-commit-hooks --cache-dir /tmp/vpx-apk-cache --cache-predownload vpx

This downloads the new version first, then installs it. It needs about 30 MB of free space in /tmp. When it finishes, open 12VPX NEO on the router and check that it shows the new version and can connect.

Without SSH, you can remove vpx in System → Software, restart the router, and install it again. Your settings stay, but you need to connect once by hand afterwards. This only works if the router can still reach the internet after removing vpx, which the SSH steps above don't depend on.

Command line

Everything on this page also works with the vpx command over SSH: vpx router enable --lan lan,guest, vpx router disable, vpx devices add 192.168.1.50 'Living room TV' and more. See The vpx command line.

View as Markdown