openwrt-passwall2

# PassWall2

[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
[![OpenWrt](https://img.shields.io/badge/OpenWrt-21.02%2B-blue)](https://openwrt.org/)
[![LuCI](https://img.shields.io/badge/LuCI-17.01%2B-green)](https://github.com/openwrt/luci)

PassWall2 is a powerful LuCI web interface application for OpenWrt that provides advanced proxy functionality. It's a comprehensive solution for network traffic management, proxy services, and access control on OpenWrt-based routers.

## 🛠️ Installation

### ⚠️ Pre-installation

```bash
# find it in releases,base of your router Arch
```
**Visit [GitHub Releases](https://github.com/Openwrt-Passwall/openwrt-passwall2/releases/latest) to download the correct package for your system.**

Choose the package format based on your **router's OpenWrt package manager**:

### For OpenWrt with OPKG 

1. **Download the IPK package** from the releases page  
   Look for `luci-app-passwall2_{VERSION}_all.ipk` in the Assets section.  
   > **Note:** If you need localization (Chinese/Persian), download the corresponding language package as well (e.g., `luci-i18n-passwall2-zh-cn...` or `...-fa...`).

2. **Upload to your router** (via SCP, LuCI upload, or wget):
   ```bash
   # Replace {VERSION} with the actual version (e.g., 26.2.5-1)
   wget https://github.com/Openwrt-Passwall/openwrt-passwall2/releases/download/{VERSION}/luci-app-passwall2_{VERSION}_all.ipk
   ```

3. **Install:**
   ```bash
   opkg update
   opkg install luci-app-passwall2_*.ipk
   ```
   
   > If installation fails due to missing dependencies (e.g., `xray-core`), you need to add the PassWall packages feed to `/etc/opkg/customfeeds.conf`.

### For OpenWrt with APK 

1. **Download the APK package** from the releases page  
   Look for `luci-app-passwall2_{VERSION}_all.apk` in the Assets section.
   > **Note:** If you need localization (Chinese/Persian), download the corresponding language package as well (e.g., `luci-i18n-passwall2-zh-cn...` or `...-fa...`).

2. **Upload to your router** (via SCP, LuCI upload, or wget):
   ```bash
   # Replace {VERSION} with the actual version (e.g., 26.2.5-1)
   wget https://github.com/Openwrt-Passwall/openwrt-passwall2/releases/download/{VERSION}/luci-app-passwall2_{VERSION}_all.apk
   ```

3. **Install:**
   ```bash
   apk add --allow-untrusted luci-app-passwall2_*.apk
   ```
   
   > ⚠️ **Security Note:** `--allow-untrusted` bypasses package signature verification. 

> **How to check your package manager:** Run `opkg --version` or `apk --version` to see which one your router uses.

### Restart LuCI
```bash
/etc/init.d/rpcd restart
```

### 🧩 Add PassWall2 APK repository (recommended)
**Instead of installing .apk packages manually**, you can add the PassWall2 APK repository and signing key to enable installation and updates via apk.

1. Add repository signing key

```bash
wget -O passwall.pub https://sourceforge.net/projects/openwrt-passwall-build/files/apk.pu