Skip to content

Latest commit

 

History

History
148 lines (87 loc) · 12.3 KB

README.md

File metadata and controls

148 lines (87 loc) · 12.3 KB

stangri's OpenWrt Packages Documentation

This is documentation for packages I'm maintaining for OpenWrt routers. While some of these are packages are already available from official OpenWrt release/snapshots repositories/feeds, my packages repo usually contains newer versions. You can also browse/check-out the source code.

How to use

On your router

The repository is currently hosted at GitHub. If you have problems accessing my packages repo or access to GitHub may be blocked at the location where your router is installed, skip to the Add Repository (jsDelivr) section. Both repositories use HTTPS protocol and require one of the SSL support packages to be installed on your router.

Add Repository (GitHub)

opkg update
opkg install wget-ssl
echo -e -n 'untrusted comment: OpenWrt usign key of Stan Grishin\nRWR//HUXxMwMVnx7fESOKO7x8XoW4/dRidJPjt91hAAU2L59mYvHy0Fa\n' > /etc/opkg/keys/7ffc7517c4cc0c56
sed -i '/stangri_repo/d' /etc/opkg/customfeeds.conf
echo 'src/gz stangri_repo https://repo.openwrt.melmac.net' >> /etc/opkg/customfeeds.conf
opkg update

Add Repository (jsDelivr)

opkg update
opkg install wget-ssl
echo -e -n 'untrusted comment: OpenWrt usign key of Stan Grishin\\nRWR//HUXxMwMVnx7fESOKO7x8XoW4/dRidJPjt91hAAU2L59mYvHy0Fa\\n' > /etc/opkg/keys/7ffc7517c4cc0c56
sed -i '/stangri_repo/d' /etc/opkg/customfeeds.conf
echo 'src/gz stangri_repo https://cdn.jsdelivr.net/gh/stangri/repo.openwrt.melmac.net' >> /etc/opkg/customfeeds.conf
opkg update

Please note that there may be delay in jsDelivr CDN cache updates comparing to my packages repo at GitHub which may cause opkg to pull older files and/or complain about wrong signature.

Image Builder (GitHub)

Add the following line:

src/gz stangri_repo https://repo.openwrt.melmac.net

to the repositories.conf file inside your Image Builder directory. You can use the following shell script code to achieve that:

sed -i '/stangri_repo/d' repositories.conf
! grep -q 'stangri_repo' repositories.conf && sed -i '4 i\src/gz stangri_repo https://repo.openwrt.melmac.net' repositories.conf

Image Builder (jsDelivr)

Add the following line:

src/gz stangri_repo https://cdn.jsdelivr.net/gh/stangri/repo.openwrt.melmac.net

to the repositories.conf file inside your Image Builder directory. You can use the following shell script code to achieve that:

sed -i '/stangri_repo/d' repositories.conf
! grep -q 'stangri_repo' repositories.conf && sed -i '4 i\src/gz stangri_repo https://cdn.jsdelivr.net/gh/stangri/repo.openwrt.melmac.net' repositories.conf

SDK

The packages source code is available in my packages source on GitHub/jsDelivr. Check out the code for the individual packages you want into your SDK's package folder or for luci apps into the package/luci/applications folder.

Description of packages

adblock-fast & luci-app-adblock-fast

This service provides lightweight and very fast dnsmasq-based ad blocking. Please see the README at GitHub/jsDelivr and OpenWrt Forum Thread for further information. This package is an improved version of simple-adblock.

https-dns-proxy & luci-app-https-dns-proxy

This is a lean RFC8484-compatible DNS-over-HTTPS (DoH) proxy service which supports DoH servers ran by AdGuard, CleanBrowsing, Cloudflare, Google, ODVR (nic.cz) and Quad9. Please see the README at GitHub/jsDelivr for further information.

luci-app-advanced-reboot

This package enables Web UI for reboot to another partition functionality on supported (dual-partition) routers and to power off (power down) your router. Please see the README at GitHub/jsDelivr and OpenWrt Forum Thread for further information.

netclient

Netclient is the client for Netmaker networks. To learn more about Netmaker, see Netmaker README. Please see the README at GitHub/jsDelivr and OpenWrt Forum Thread for further information.

pbr & luci-app-pbr

This service can be used to enable policy-based routing for WAN/WAN6 interfaces and multiple VPN tunnels. Supported VPN protocols include: L2TP, Openconnect, OpenVPN, Softether and Wireguard. Policies can be based on domain names, IP addresses, ports or any combination of the above. This service supports policies for both outgoing and incoming traffic to target specific interfaces/tunnels. Please see the README at GitHub/jsDelivr and OpenWrt Forum Thread for further information.

Description of outdated/obsolete packages

antminer-monitor

This service can be used to monitor local BITMAIN Antminers. This is just the wrapper for Antminer Monitor python app. WARNING: Requires a router with a lot of flash, 128Mb recommended. Please see the README at GitHub/jsDelivr for further information.

fakeinternet & luci-app-fakeinternet

This service can be used to fake internet connectivity for local devices. Can be used on routers with no internet access to suppress warnings on local devices on no internet connectivity. Please see the README at GitHub/jsDelivr and OpenWrt Forum Thread for further information.

libcurl with HTTP/3 and QUIC support

Instructions for building libcurl with HTTP/3 and QUIC support using out of the tree OpenSSL-QuicTLS can be found on GitHub/jsDelivr

luci-app-easyflash

This package installs Web UI for quickly updating your router firmware if you use automated snapshots build process which produces fully customized images and uploads them to your router. Requires sysupgrade-compatible upgrade file /tmp/firmware.img and a one-line description (target/version/filename info) in /tmp/firmware.tag. WARNING: does not keep your router settings.

luci-mod-alt-reboot

This package enables Web UI for reboot to another partition functionality on supported (dual-partition) routers and to power off (power down) your router by overwriting default System --> Reboot page. Please see the README at GitHub/jsDelivr for further information. This package has been superseded by luci-app-advanced-reboot and is no longer developed/supported.

luci-theme-material-old

This package brings back the old button styles to the luci-theme-material on OpenWrt 18.06.0-rc2 and later. Please see the README at GitHub/jsDelivr for further information.

nebula

Nebula is a scalable overlay networking tool with a focus on performance, simplicity and security. It lets you seamlessly connect computers anywhere in the world. Nebula is being developed by Slack. Please see the README at GitHub/jsDelivr and OpenWrt Forum Thread for further information.

simple-adblock & luci-app-simple-adblock

This service provides lightweight and very fast dnsmasq-based ad blocking. Please see the README at GitHub/jsDelivr and OpenWrt Forum Thread for further information. This package has been obsoleted by adblock-fast.

slider-support

This package enables switching between Router, Access Point and Wireless Repeater modes of operation for supported routers equipped with slider switch. It also sets the correct current mode setting for the WLAN Blinker service (README at GitHub/jsDelivr). Please see the README at GitHub/jsDelivr for further information.

vpnbypass & luci-app-vpnbypass

This service can be used to enable split tunneling for outgoing traffic for a single OpenVPN tunnel used as the default gateway. Supports accessing domains, IP ranges outside of your OpenVPN tunnel (bypassing OpenVPN tunnel) over IPv4. Please see the README at GitHub/jsDelivr and OpenWrt Forum Thread for further information. This package has been obsoleted by pbr.

vpn-policy-routing & luci-app-vpn-policy-routing

This service can be used to enable policy-based routing for WAN/WAN6 interfaces and multiple VPN tunnels. Supported VPN protocols include: L2TP, Openconnect, OpenVPN and Wireguard. Policies can be based on domain names, IP addresses, ports or any combination of the above. This service supports policies for both outgoing and incoming traffic to target specific interfaces/tunnels. Please see the README at GitHub/jsDelivr and OpenWrt Forum Thread for further information. This package has been obsoleted by pbr.

wlanblinker & luci-app-wlanblinker

This service can be used to indicate WLAN status by blinking the unused LED. Please see the README at GitHub/jsDelivr for further information.

wireshark-helper & luci-app-wireshark-helper

This service can be used to configure router to sniff packets to/from monitored device on the device running Wireshark app. Please see the README at GitHub/jsDelivr for further information.

<script defer src='https://static.cloudflareinsights.com/beacon.min.js' data-cf-beacon='{"token": "911798f2c34b45338f8f8182830a3eb6"}'></script>