# openwrt-passwall/openwrt-passwall

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/openwrt-passwall-openwrt-passwall).**

9,277 stars · 2,922 forks · Lua · gpl-3.0

## Links

- GitHub: https://github.com/Openwrt-Passwall/openwrt-passwall
- Homepage: https://t.me/psw_group
- awesome-repositories: https://awesome-repositories.com/repository/openwrt-passwall-openwrt-passwall.md

## Description

OpenWrt-passwall is a network proxy management tool designed for OpenWrt firmware to facilitate internet censorship circumvention. It enables the routing of traffic through proxy servers or VPN tunnels to bypass network blocks and regional restrictions.

The project integrates VPN client functionality directly into the router, allowing all connected devices to secure their traffic without individual software installations. It manages the configuration and switching of various proxy protocols and servers to control how local network traffic exits the gateway.

The system utilizes a Lua-based web interface for management and employs DNS-query diversion to prevent DNS poisoning. Traffic steering is handled through firewall rules and routing tables, while background proxy processes are managed via a daemon-based orchestration model.

## Tags

### Networking & Communication

- [Network Proxy Management](https://awesome-repositories.com/f/networking-communication/network-proxy-management.md) — Provides a comprehensive suite for configuring and controlling internet traffic routing through various proxy servers. ([source](https://github.com/Openwrt-Passwall/openwrt-passwall/blob/main/README.md))
- [Advanced Traffic Routing](https://awesome-repositories.com/f/networking-communication/advanced-traffic-routing.md) — Implements advanced traffic routing logic directly within OpenWrt firmware based on connection metadata.
- [Censorship Circumvention Tools](https://awesome-repositories.com/f/networking-communication/censorship-circumvention-tools.md) — Facilitates the bypassing of regional network blocks and internet censorship via proxy and VPN tunnels.
- [DNS Query Routers](https://awesome-repositories.com/f/networking-communication/dns-query-routers.md) — Intercepts and routes DNS queries through a proxy to prevent DNS poisoning and censorship.
- [Router-Level VPN Integration](https://awesome-repositories.com/f/networking-communication/network-infrastructure-routing/network-infrastructure-configuration/network-management/proxy-tunneling-clients/vpn-and-proxy-clients/router-level-vpn-integration.md) — Integrates VPN client functionality at the router level to secure all downstream connected devices.
- [Firewall Rule Configurations](https://awesome-repositories.com/f/networking-communication/traffic-tunnels/firewall-rule-configurations.md) — Uses kernel-level iptables firewall rules to steer network traffic through specific proxy tunnels.
- [Proxy Orchestrators](https://awesome-repositories.com/f/networking-communication/proxy-orchestrators.md) — Implements a daemon-based system to manage the lifecycle and automatic restarts of background proxy processes.

### User Interface & Experience

- [Lua-Based Administration Interfaces](https://awesome-repositories.com/f/user-interface-experience/lua-based-administration-interfaces.md) — Provides a dynamic Lua-based web interface for configuring proxy rules and VPN settings.