Proxy subscription manager for Podkop on OpenWrt routers. Runs over SSH as an interactive TUI.
Fetches and parses proxy subscription URLs, auto-groups nodes by provider, maintains refreshable link pools, and pushes them into Podkop's URLTest sections — keeping your VPN node lists up to date automatically.
Manages proxy subscriptions end-to-end: fetch → parse → group → filter → push to Podkop.
- Add by URL — fetches the subscription, parses all node URIs (ss, vless, trojan, hysteria2, socks5 and more), stores pool locally
- Profile metadata extracted from response headers: title, traffic usage, expiry, update interval, announce banner
- Auto-grouped by profile-title — subscriptions from the same provider always share one group, groups materialise on add and vanish on last removal
- Manual link pool editor — paste raw URIs directly without a remote URL
- Per-subscription refresh with metadata update; cron auto-refreshes all enabled subscriptions on a schedule
- Subscriptions from the same provider are grouped automatically; group display name follows the profile-title
- Rename groups; group list shown on the main screen with per-group node counts
- Adopt existing Podkop URLTest sections into Mole management with one key press
- Assign source groups — the link pool for a section is built from all subscriptions in the chosen groups
- Flush to Podkop — writes the resolved URI set into
urltest_proxy_linksand restarts Podkop; no-op if already in sync - Dirty indicator — warns when planned links differ from what is currently in Podkop
- URLTest settings per section: Check Interval, Tolerance (ms), Testing URL — written directly to Podkop UCI
- Latency probe — triggers Podkop's clash API group test and shows per-node ping results on the next render
- Unadopt — removes Mole management without touching Podkop state
- Protocol exclusion — exclude entire protocols (ss, vmess, tuic, etc.) per subscription
- Per-node batch exclude/include — toggle individual nodes by index or range (
1 3 5-8), or exclude/include all at once - Exclusions are applied at flush time; protocol filters and per-link filters stack
- Schedule auto-refresh with presets (every 1h / 3h / 6h / 12h / daily) or a custom cron expression
- Server-suggested interval shown as a hint when subscriptions advertise
profile-update-interval - Cron entry written to
/etc/crontabs/root, cron service reloaded automatically - Last-run info and log tail visible in the cron menu
- Warning shown when the script is not installed at
/usr/bin/mole(cron needs it there)
- Install from current running file or download latest directly from GitHub
- Self-update: downloads
mole.shfrom the repo, installs to/usr/bin/mole - Main menu shows
Install Script ⚠ cron needs thiswhen not yet installed at the expected path
- Log viewer with live tail and clear
- Settings: user-agent, download/connect timeouts, ASN enrichment source and TTL
- Full reset — wipes all UCI config, pool files, cache, log and crontab entry with two-step confirmation
wget -O /usr/bin/mole https://raw.githubusercontent.com/tickcount/mole/main/mole.sh
chmod +x /usr/bin/mole
moleOr run once without installing:
sh <(wget -O - https://raw.githubusercontent.com/tickcount/mole/main/mole.sh)- OpenWrt 24.10+ (BusyBox ash)
- Podkop
Optional (installable from the menu): curl, jq, coreutils-base64, flock.
- Run
mole - Press
+to add a subscription URL - Go to
p › Podkop Sections, adopt a section, assign source groups - Press
fto flush the link pool into Podkop - Optionally configure cron (
c) for automatic refresh
Each subscription is stored as a UCI section in /etc/config/mole. The parsed node URIs are cached as plain-text pool files in /etc/mole/pool/. When a Podkop section is flushed, Mole resolves the union of all source groups' pools, applies protocol and per-link exclusions, and writes the resulting URI list into Podkop's urltest_proxy_links option — then restarts Podkop once.
A canonical hash of the planned URI set is compared against what is currently in Podkop before every flush; if they match the operation is a no-op, so restarting Podkop unnecessarily is avoided.
Mole is an independent, unofficial tool for managing proxy subscriptions for Podkop. It is not affiliated with, endorsed by, or maintained by the Podkop project.
MIT