Skip to content

VPN and proxies

All of these ship installed and disabled. They need your servers, keys or configuration.

WireGuard

WireGuard is fully installed (kernel module, wg tools and LuCI protocol support) but has no interfaces configured. An empty Status page is normal until you create one.

Create a tunnel: Network → Interfaces → Add new interface, name it (for example wg0), protocol WireGuard VPN, Create interface. In the interface's Configuration tab set the private key and the peers (a peer is an endpoint plus allowed IPs).

Command line alternative:

wg genkey | tee privatekey | wg pubkey > publickey

then configure with wg set.

OpenVPN

VPN → OpenVPN. The service needs your .ovpn configuration, so it ships disabled. Enable it per configuration.

Proxies and bypass tools

App Where Cores
Passwall 2 Services → PassWall 2 Xray, Sing-box, Hysteria and more
Passwall Services → PassWall the same cores
HomeProxy Services → HomeProxy sing-box

Add a node (server), pick the matching core, set the routing mode and enable. dnsmasq-full and chinadns-ng are already wired in.

Use one proxy suite at a time

Running more than one proxy suite on the same router makes firewall and DNS rules fight. Enable the one you want.

IPv6: if you send traffic through Passwall 2, enable IPv6 TProxy in its forwarding settings. Passwall 1 hides IPv6 answers for proxied names by default.

Common questions

Does CleanWRT include WireGuard and OpenVPN?

Yes. WireGuard is fully installed with no interfaces configured, and OpenVPN needs your own .ovpn configuration. Both ship disabled.

Can I run Passwall and HomeProxy at the same time?

It is better not to. Several proxy suites on one router make firewall and DNS rules fight, so enable the one you want.

Why do I need IPv6 TProxy in Passwall 2?

Without it, devices can reach IPv6 sites directly, outside the proxy. Enable it in the forwarding settings when you proxy traffic through Passwall 2.

Out of the box

state
WireGuard kernel module and wireguard-tools, no tunnel configured
OpenVPN installed, off, needs your .ovpn
Passwall, Passwall 2, HomeProxy installed, all off. Their cores — sing-box, xray-core, v2ray-plugin, hysteria, naiveproxy, ipt2socks, microsocks, dns2socks — are in the image
Tailscale, Cloudflare Tunnel installed, off. They belong on remote access
Shadowsocks-Rust, ShadowsocksR-libev, Simple-Obfs, shadow-tls not in the image, and the reasons are in the seed: a deleted upstream asset, a recipe that fails to build, an archived project with a failing tarball hash. The same protocols are covered by xray-core and sing-box
OpenClash never seeded. It lives in the optional cw-opt feed, which is not published yet

What is listening

A proxy suite that is off listens on nothing. When enabled, the transparent-proxy ports are local to the router and the LAN, and none of them is forwarded from the cellular side by this image.

When it does not work

symptom what it means
Traffic still goes out unproxied over IPv6 Passwall 2 needs IPv6 TProxy enabled in its forwarding settings, or devices reach IPv6 sites directly
Two suites fight and one wins run one. Both install transparent-proxy rules on the same ports
apk upgrade pulled a different version of a core the feed pins decide what the image is built with; see updating and pinning
A server you added is refused check the core it needs is in the image. The excluded list above is the set that is not

Questions people ask

Does CleanWRT include WireGuard and OpenVPN?

Yes. WireGuard is a kernel module plus tools and a LuCI page; OpenVPN is installed with its own page and needs your configuration file. Neither is configured out of the box.

Can I run Passwall and HomeProxy at the same time?

You can install both, but only one should be enabled: they both install transparent-proxy rules and the second one silently changes where the first one's traffic goes.

Why do I need IPv6 TProxy in Passwall 2?

Because the 5G connection is dual-stack when your carrier offers IPv6, and a proxy that only captures IPv4 leaves IPv6 traffic going out directly.