Passwall2 Installation

Run this command in your router's SSH terminal

sh <(wget -O - https://raw.githubusercontent.com/SlenderSolo/passwall2-install-openwrt/master/install.sh)

Manual Installation

Phase 1: Preparation

Step 1: Check System Architecture

Before downloading files, you need to know your router's architecture (e.g., aarch64_cortex-a53, mips_24kc).

1. Log in to the Web Interface.
2. Navigate to System → Software.
3. Click Update lists to refresh the package database.
4. Look for your architecture in the download links after /packages/ (e.g. aarch64_cortex-a53)

Step 2: Download Packages

1. Visit the Passwall2 Releases Page.
2. Download the following files:
   • luci-app-passwall2_all.ipk
   • passwall_packages_ipk zip file matching your architecture (found in Step 1).
3. Unzip the passwall_packages archive on your computer. You will need the files inside it for Step 4.

---

Phase 2: System Configuration (SSH)

Warning

This step involves removing dnsmasq and deleting DHCP configurations. This may temporarily disrupt your network or require you to reconfigure DHCP settings later. Proceed with caution.

1. Connect to the router via SSH using cmd:

   ssh root@192.168.1.1

2. Update the package repositories:

   opkg update

3. Swap dnsmasq for dnsmasq-full: Remove the default version and clean up the config:

   opkg remove dnsmasq

   rm -rf /etc/config/dhcp

4. Install dependencies: Install the full version of dnsmasq and required kernel modules:

   opkg install dnsmasq-full kmod-nft-socket kmod-nft-tproxy kmod-nft-nat

---

Phase 3: Package Installation (Web Interface)

Step 1: Install Core Components

1. Go to System → Software.
2. Click the Upload Package button.
3. Locate the folder where you unzipped the passwall_packages archive.
4. Upload and install the following packages one by one (Xray-core first is recommended):
   • xray-core
   • v2ray-geoip
   • v2ray-geosite
   • geoview
   • chinadns-ng
   • tcping
   • sing-box (Optional)
   • hysteria (Optional)
   • (Optional) Install any other packages from the folder if you specifically need them.

Step 2: Install the Interface (LuCI)

1. Click Upload Package again.
2. Select the luci-app-passwall2_all.ipk file you downloaded earlier and install it.
3. Relogin to the web interface or press Ctrl + F5 to refresh the cache, Passwall2 will then appear under the Services tab.
4. REBOOT router