Podkop OpenWrt Guide

Podkop is an orchestration layer over sing-box for OpenWrt: it manages selective routing, edits dnsmasq, assembles rules/lists, generates NFTable rules for tproxy and provides a LuCI UI.

Use this skill when you need more than "change something in the config": when you need to understand how Podkop ties together UCI, dnsmasq, sing-box, nft and the service lifecycle.

When to use

• Installing or updating Podkop on an OpenWrt router.
• Migrating the config after an incompatible release.
• Configuring proxy strings, selector/urltest groups, raw outbound JSON.
• Working with community lists, user domains/subnets, remote/local lists.
• Configuring mixed proxy, YACD dashboard, Clash API, FakeIP.
• Connection types: proxy, vpn, block, exclusion.
• BadWAN interface monitoring, DNS (UDP/DoT/DoH), NTP exclusion.
• Diagnosing sing-box, dnsmasq, nft, dashboard or LuCI breakage.
• Developing the shell backend, LuCI UI or TypeScript frontend in the itdoginfo/podkop repo.
• Analysing conflicts with https-dns-proxy, nextdns, passwall, Getdomains.