How m66b/netguard works
NetGuard is an Android no-root firewall: users configure per-app and connection rules, enable its VPN-based filtering, and inspect access logs and usage. The central workflow runs from the app list and rule editor through ServiceSinkhole, with persistent logs and usage handled by DatabaseHelper. Settings also expose DNS, forwarding, hosts-file blocking and PRO features. The tree and README establish these capabilities, but the excerpts do not show how the Java VPN service dispatches packets into the native protocol implementation, so that link is omitted.
Main entry points: ServiceSinkhole.java VPN firewall · ActivityLog.java Traffic log · ActivitySettings.java Settings · ActivityMain.java Firewall screen
Components 22
Rules & settings
- Firewall screen
app/src/main/java/eu/faircode/netguard/ActivityMain.java - Rule editor
app/src/main/java/eu/faircode/netguard/AdapterRule.java - App rules
app/src/main/java/eu/faircode/netguard/Rule.java - Settings
app/src/main/java/eu/faircode/netguard/ActivitySettings.java - Port forwarding
app/src/main/java/eu/faircode/netguard/ActivityForwarding.java - DNS screen
app/src/main/java/eu/faircode/netguard/ActivityDns.java - Hosts download
app/src/main/java/eu/faircode/netguard/DownloadTask.java
VPN filtering
- VPN firewall
app/src/main/java/eu/faircode/netguard/ServiceSinkhole.java - External service
app/src/main/java/eu/faircode/netguard/ServiceExternal.java
Logs & usage
- Firewall database
app/src/main/java/eu/faircode/netguard/DatabaseHelper.java - Traffic log
app/src/main/java/eu/faircode/netguard/ActivityLog.java - Pro features
app/src/main/java/eu/faircode/netguard/ActivityPro.java - Log display
app/src/main/java/eu/faircode/netguard/AdapterLog.java - PCAP records
app/src/main/java/eu/faircode/netguard/Packet.java
Packet engine
- Native packet core
app/src/main/jni/netguard/netguard.c - TCP handling
app/src/main/jni/netguard/tcp.c - UDP handling
app/src/main/jni/netguard/udp.c - DNS handling
app/src/main/jni/netguard/dns.c - IP handling
app/src/main/jni/netguard/ip.c - TLS inspection
app/src/main/jni/netguard/tls.c - Sessions
app/src/main/jni/netguard/session.c
Other components
- User
Connections 17
- User → Firewall screen: configures firewall
- Firewall screen → Rule editor: displays rules
app/src/main/java/eu/faircode/netguard/ActivityMain.java - Rule editor → App rules: updates rules
app/src/main/java/eu/faircode/netguard/AdapterRule.java - Firewall screen → VPN firewall: starts filtering
app/src/main/java/eu/faircode/netguard/ActivityMain.java - Firewall screen → Firewall database: loads access state
app/src/main/java/eu/faircode/netguard/ActivityMain.java - Settings → VPN firewall: reloads filtering
app/src/main/java/eu/faircode/netguard/ActivitySettings.java - Settings → Hosts download: starts download
app/src/main/java/eu/faircode/netguard/ActivitySettings.java - Hosts download → VPN firewall: reloads rules
app/src/main/java/eu/faircode/netguard/DownloadTask.java - Settings → Port forwarding: opens forwarding
app/src/main/java/eu/faircode/netguard/ActivitySettings.java - Settings → DNS screen: opens DNS
app/src/main/java/eu/faircode/netguard/ActivitySettings.java - VPN firewall → Firewall database: records traffic
app/src/main/java/eu/faircode/netguard/ServiceSinkhole.java - Traffic log → Firewall database: queries logs
app/src/main/java/eu/faircode/netguard/ActivityLog.java - Traffic log → Log display: displays entries
app/src/main/java/eu/faircode/netguard/ActivityLog.java - Traffic log → VPN firewall: controls logging
app/src/main/java/eu/faircode/netguard/ActivityLog.java - Traffic log → Pro features: checks access
app/src/main/java/eu/faircode/netguard/ActivityLog.java - Traffic log → PCAP records: manages capture
app/src/main/java/eu/faircode/netguard/ActivityLog.java - VPN firewall → External service: delegates service
app/src/main/java/eu/faircode/netguard/ServiceExternal.java