English | 中文

Momo

Transparent Proxy with sing-box on OpenWrt.

Prerequisites

• OpenWrt >= 24.10
• Linux Kernel >= 5.13
• firewall4

Feature

• Transparent Proxy (Redirect/TPROXY/TUN, IPv4 and/or IPv6)
• Access Control
• Profile Editor
• Scheduled Restart

Install & Update

A. Install From Feed (Recommended)

1. Add Feed

# only needs to be run once
wget -O - https://github.com/nikkinikki-org/OpenWrt-momo/raw/refs/heads/main/feed.sh | ash

2. Install

# you can install from shell or `Software` menu in LuCI
# for opkg
opkg install momo
opkg install luci-app-momo
opkg install luci-i18n-momo-zh-cn
# for apk
apk add momo
apk add luci-app-momo
apk add luci-i18n-momo-zh-cn

B. Install From Release

wget -O - https://github.com/nikkinikki-org/OpenWrt-momo/raw/refs/heads/main/install.sh | ash

Uninstall & Reset

wget -O - https://github.com/nikkinikki-org/OpenWrt-momo/raw/refs/heads/main/uninstall.sh | ash

How To Use

See Wiki

How does it work

1. Run sing-box.
2. Set scheduled restart.
3. Get neccesarry param from profile.
4. Set ip rule/route.
5. Generate firewall and apply it.

Note that the steps above may change base on config.

Compilation

# add feed
echo "src-git momo https://github.com/nikkinikki-org/OpenWrt-momo.git;main" >> "feeds.conf.default"
# update & install feeds
./scripts/feeds update -a
./scripts/feeds install -a
# make package
make package/luci-app-momo/compile

The package files will be found under bin/packages/your_architecture/momo.

Dependencies

• ca-bundle
• curl
• firewall4
• ip-full
• kmod-inet-diag
• kmod-nft-socket
• kmod-nft-tproxy
• kmod-tun
• sing-box (1.12)

Contributors