132 lines
3.0 KiB
Markdown
132 lines
3.0 KiB
Markdown
# OpenWRT images 📦
|
|
|
|
Find the images under the Releases section.
|
|
|
|
## Whaaat ? 👾
|
|
|
|
This repository contains self-built OpenWRT images for Linksys WRT1200AC, Linksys WRT3200ACM, and Asus RT-AX53U devices.
|
|
|
|
OpenWRT is a Linux-based open-source operating system designed to run on a wide range of devices, including routers.
|
|
|
|
## Usage 🔨
|
|
|
|
To use these images, download the appropriate image file for your device and flash it onto your router.
|
|
|
|
Please note that flashing your router can be risky, and you should only do so if you know what you are doing.
|
|
|
|
Make sure to follow the instructions carefully and make a backup of your current firmware before proceeding.
|
|
|
|
## Features ⛲
|
|
|
|
- Argon theme
|
|
- Dashboard
|
|
- Bandwidth monitor
|
|
- AdGuard Home
|
|
- banIP
|
|
- ClamAV
|
|
- DAWN
|
|
- File browser and file manager
|
|
- LuCI 2FA plugin
|
|
|
|
## Packages 📦
|
|
|
|
- luci-app-adguardhome
|
|
- luci-app-advanced-reboot
|
|
- luci-app-banip
|
|
- luci-app-commands
|
|
- luci-app-clamav
|
|
- luci-app-dawn
|
|
- luci-app-filebrowser
|
|
- luci-app-filemanager
|
|
- luci-app-nlbwmon
|
|
- luci-app-package-manager
|
|
- luci-app-statistics
|
|
- luci-app-wifischedule
|
|
- luci-mod-dashboard
|
|
- luci-plugin-2fa
|
|
|
|
## Post-install notes ⚙️
|
|
|
|
Some included services need to be configured manually after flashing.
|
|
|
|
### AdGuard Home
|
|
|
|
AdGuard Home is available at:
|
|
|
|
`http://router-ip:3000`
|
|
|
|
Replace `router-ip` with your router IP address.
|
|
|
|
AdGuard Home needs to be configured before use.
|
|
|
|
To allow AdGuard Home to listen on DNS port `53`, move `dnsmasq` away from port `53`:
|
|
|
|
```sh
|
|
uci set dhcp.@dnsmasq[0].port='0'
|
|
uci commit dhcp
|
|
/etc/init.d/dnsmasq restart
|
|
```
|
|
|
|
After that, configure AdGuard Home and set it to listen on port `53`.
|
|
|
|
### banIP
|
|
|
|
banIP needs to be enabled manually over SSH:
|
|
|
|
```sh
|
|
/etc/init.d/banip enable
|
|
/etc/init.d/banip start
|
|
```
|
|
|
|
After starting banIP, configure feeds and WAN interface in LuCI.
|
|
|
|
### ClamAV
|
|
|
|
ClamAV is included, but it still needs to be configured in LuCI.
|
|
|
|
Recommended things to check:
|
|
|
|
- database directory
|
|
- scan limits
|
|
- memory usage
|
|
- logging
|
|
- signature database updates
|
|
|
|
ClamAV on a router is mainly useful for scanning files, for example USB storage or shared files. It does not automatically scan all network traffic.
|
|
|
|
### LuCI 2FA
|
|
|
|
The LuCI 2FA plugin is included, but it needs to be configured manually.
|
|
|
|
Important note:
|
|
|
|
**2FA does not currently work with the Argon theme login page.**
|
|
|
|
Use the default Bootstrap theme when enabling LuCI 2FA.
|
|
|
|
If you get locked out after enabling 2FA, disable it over SSH:
|
|
|
|
```sh
|
|
uci set luci_plugins.global.enabled='0'
|
|
uci set luci_plugins.global.auth_login_enabled='0'
|
|
uci commit luci_plugins
|
|
/etc/init.d/rpcd restart
|
|
/etc/init.d/uhttpd restart
|
|
```
|
|
|
|
## Notes 📝
|
|
|
|
The following plugins/services are included but need manual configuration after flashing:
|
|
|
|
- AdGuard Home
|
|
- banIP
|
|
- ClamAV
|
|
- LuCI 2FA
|
|
|
|
AdGuard Home also requires `dnsmasq` DNS to be disabled or moved away from port `53`.
|
|
|
|
## Disclaimer ⚠️
|
|
|
|
Use these images at your own risk.
|
|
|
|
The author of this repository is not responsible for any damage, bricked devices, configuration issues, or loss of data that may occur as a result of using these images. |