User guide
Exit nodes, routes & split tunnel
Route all traffic through an exit node, reach a subnet behind a peer with subnet routes, and exclude CIDRs from the tunnel with split tunneling.
Last updated June 15, 2026
Table of contents
By default QuickZTNA connects your devices directly to each other. Three features extend that: exit nodes (egress through a peer), subnet routes (reach non-QuickZTNA hosts behind a peer), and split tunneling (keep some traffic off the tunnel).
Exit nodes
An exit node routes a device’s traffic out through a chosen peer — useful for a stable egress IP or reaching region-locked resources.
ztna exit-node list # available (approved) exit nodes
ztna exit-node suggest # the recommended one
ztna set --exit-node 100.64.0.9 # route traffic through that peer
ztna set --exit-node auto # let QuickZTNA pick
ztna set --exit-node-allow-lan-access # keep your local LAN reachable
ztna set --exit-node off # stop using an exit node
A machine offers itself as an exit node with ztna up --advertise-exit-node, but it only becomes usable once an admin approves it (see the admin access-control guide).
Subnet routes
A subnet route lets peers reach hosts that aren’t running QuickZTNA, by going through a device that is on their network.
-
Advertise a subnet from a device on that network:
sudo ztna up --advertise-routes 10.0.0.0/24,192.168.1.0/24Advertised routes are inert until an admin approves them. View them with
ztna route list. -
Accept approved routes on a device that should use them:
ztna set --accept-routes # or: ztna up --accept-routes
Subnet routing on the gateway side is a Linux capability (ztna up --gateway for a headless subnet gateway).
Split tunneling
Split tunneling keeps specific destinations off the QuickZTNA tunnel (they use your normal network path). Inspect the current exclusions:
ztna split-tunnel list # CIDRs excluded from the tunnel
Next
- Connecting & everyday commands — status, peers, DNS, profiles.
- Admin: access control — approving routes and exit nodes.
- CLI reference — every flag for
up,set,route, andexit-node.
Frequently asked questions
- How do I route my internet traffic through another device?
- Pick an approved exit node with 'ztna exit-node list' (or 'ztna exit-node suggest'), then 'ztna set --exit-node <ip|auto>'. Add '--exit-node-allow-lan-access' to keep your local LAN reachable. Turn it off with 'ztna set --exit-node off'. A machine can only act as an exit node after an admin approves it.
- How do I reach a server that isn't running QuickZTNA?
- Put a QuickZTNA device on the same network and have it advertise that subnet ('ztna up --advertise-routes 10.0.0.0/24'); an admin approves the route; then peers that accept routes can reach hosts on that subnet through it.