MCPcopy Index your code
hub / github.com/NetGoVPN-Team/NetGoVPN-Android

github.com/NetGoVPN-Team/NetGoVPN-Android @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
204 symbols 506 edges 29 files 0 documented · 0%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

NetGoVPN — Android Client

Project Cover

GitHub release Downloads GitHub stars Android API 23+ License MIT Status Users Transfer Over 160TB

Get it on Google Play

Tagline: Internet freedom for everyone — resilient, private, and open.

NetGoVPN is a free, open-source Android client engineered to provide reliable, privacy-respecting, and censorship-resistant network connectivity for users in high-restriction environments. It helps people reach essential information safely — from education to communication with loved ones.


🚩 Mission

To preserve access to open information and support individuals experiencing network censorship and surveillance.
We design with user safety first, prioritizing anonymity, resilience, and ease of use.


🛡️ Censorship-Resistant Capabilities

  • Automated fallback and multi-protocol switching
  • Obfuscation and traffic camouflage (high-level disclosures only to protect users)
  • Dynamic server rotation & failover
  • Minimal fingerprintable behavior

We intentionally avoid publishing operational details that may help adversaries.


✨ Key Features

  • Lightweight, stable client for Android API 23+
  • Dynamic routing & connection-quality monitoring
  • Low detection surface & conservative telemetry
  • Modular architecture for future transports
  • UX designed for non-technical users in risky environments

🔒 Privacy & Security

  • No logs of user identity or traffic content
  • Minimal, privacy-respecting aggregated telemetry
  • Responsible disclosure program with PGP
  • Security-sensitive infrastructure kept private

See: SECURITY.md


🧭 Threat Model (summary)

Primary threats: DPI blocking, network surveillance, accidental exposure during connection
Limitations: not a replacement for OPSEC or tools designed for anonymity from state-level actors


📣 What Makes NetGoVPN Different

Feature Why it matters
Built for high-restriction regions Practical survival under active blocking
Automated resiliency Users don’t need to change settings
Transparent & open-source Greater trust for at-risk communities
Low-bandwidth / low-tech friendly Designed for users with low resources

✅ Early Impact

⚡ Even in early development, NetGoVPN is already improving lives.

  • 👥 7500+ active users
  • 🌍 Confirmed usage in multiple restricted regions
  • 🔄 Hundreds of successful connections weekly
  • 📶 Average connection success rate above 97.4%

🌱 Human Story

"I couldn’t join my online university classes for months.
NetGoVPN finally gave me reliable access again."

— Anonymous user in a censored region

Small today — but already meaningful.


🧩 Tech Stack & Components

  • Transport engines: custom configuration built on proven open networking components
  • Android client: Java
  • Telemetry: opt-in Firebase + private, aggregated metrics

Upstream licenses are respected and documented.


🧾 Roadmap (6 Months)

  • Month 1 — Launch & first performance metrics ✅ ongoing
  • Month 2 — Security review + privacy policy hardening
  • Month 3 — UX enhancements & onboarding help screens
  • Month 4 — Scaling infrastructure to multi-region
  • Month 5 — Transparency dashboard + community trust signals
  • Month 6 — Reach 10k MAU

📈 Metrics for Funders

We commit to reporting:

  • Monthly Active Users (MAU)
  • Connection success rate + latency
  • Region-level distribution (non-PII)
  • Retention and engagement curves

💸 Funding & Sustainability

Funding supports:

  • Server capacity for high-blocking regions
  • Development and UX improvements
  • External security audits
  • Operational costs (domains, infrastructure)

Channels:

  • Grants (OTF, NLnet, Internews, GitHub Sponsors)
  • Crypto donations
  • Organizational sponsorships

See: DONATE.md


🧑‍💻 Who We Are

A small team with hands-on experience in:

  • Android networking and secure infrastructure
  • Operating anti-censorship services in high-risk areas
  • Rapid iteration in evolving threat environments

We work anonymously in public spaces to avoid exposing at-risk contributors.


📦 Build & Development

See: BUILD.md

Releases are signed and verified with published hashes.


⚖️ Legal & Compliance

NetGoVPN facilitates access to general information and communication.
It is not intended to assist or encourage unlawful activity.

Contributors must comply with applicable laws and export controls.


📚 Contributing

Contributions are welcome — particularly security reviews and testing.
See: CONTRIBUTING.md


📞 Contact

  • Website: https://netgovpn.com
  • Support: support@netgovpn.com
  • Telegram: https://t.me/NetGoVPN_Team

📄 License

MIT License — see LICENSE.


Prepared for grant reviewers
This project directly benefits people facing censorship by giving them safe access to open knowledge and communication.

Extension points exported contracts — how you extend this code

V2rayServicesListener (Interface)
(no doc) [4 implementers]
v2ray/src/main/java/com/netgovpn/freedom/core/interfaces/V2rayServicesListener.java
Listener (Interface)
(no doc) [1 implementers]
app/src/main/java/com/netgovpn/freedom/MultiRequestManager.java
Tun2SocksListener (Interface)
(no doc) [2 implementers]
v2ray/src/main/java/com/netgovpn/freedom/core/interfaces/Tun2SocksListener.java
PingFunction (Interface)
(no doc)
app/src/main/java/com/netgovpn/freedom/PingManager.java
StateListener (Interface)
(no doc) [2 implementers]
v2ray/src/main/java/com/netgovpn/freedom/core/interfaces/StateListener.java
PingCallback (Interface)
(no doc)
app/src/main/java/com/netgovpn/freedom/PingManager.java
TrafficListener (Interface)
(no doc) [1 implementers]
v2ray/src/main/java/com/netgovpn/freedom/core/interfaces/TrafficListener.java
LatencyDelayListener (Interface)
(no doc)
v2ray/src/main/java/com/netgovpn/freedom/core/interfaces/LatencyDelayListener.java

Core symbols most depended-on inside this repo

prepare
called by 11
v2ray/src/main/java/com/netgovpn/freedom/core/core/V2rayCoreExecutor.java
parseTraffic
called by 8
v2ray/src/main/java/com/netgovpn/freedom/core/utils/Utilities.java
start
called by 8
v2ray/src/main/java/com/netgovpn/freedom/core/services/StaticsBroadCastService.java
stopCore
called by 6
v2ray/src/main/java/com/netgovpn/freedom/core/core/V2rayCoreExecutor.java
OnTun2SocksHasMassage
called by 6
v2ray/src/main/java/com/netgovpn/freedom/core/interfaces/Tun2SocksListener.java
getService
called by 5
v2ray/src/main/java/com/netgovpn/freedom/core/interfaces/V2rayServicesListener.java
getConnectionState
called by 4
v2ray/src/main/java/com/netgovpn/freedom/core/V2rayController.java
shutdownExecutors
called by 3
app/src/main/java/com/netgovpn/freedom/PingManager.java

Shape

Method 167
Class 25
Interface 8
Enum 4

Languages

Java100%

Modules by API surface

v2ray/src/main/java/com/netgovpn/freedom/core/services/V2rayVPNService.java18 symbols
v2ray/src/main/java/com/netgovpn/freedom/core/V2rayController.java18 symbols
app/src/main/java/com/netgovpn/freedom/MainActivity.java18 symbols
v2ray/src/main/java/com/netgovpn/freedom/core/services/V2rayProxyService.java14 symbols
v2ray/src/main/java/com/netgovpn/freedom/core/core/V2rayCoreExecutor.java14 symbols
app/src/main/java/com/netgovpn/freedom/PingManager.java13 symbols
v2ray/src/main/java/com/netgovpn/freedom/core/utils/Utilities.java11 symbols
app/src/main/java/com/netgovpn/freedom/MultiRequestManager.java10 symbols
v2ray/src/main/java/com/netgovpn/freedom/core/services/StaticsBroadCastService.java9 symbols
app/src/main/java/com/netgovpn/freedom/SplashActivity.java9 symbols
app/src/main/java/com/netgovpn/freedom/PermissionHelper.java9 symbols
v2ray/src/main/java/com/netgovpn/freedom/core/services/NotificationService.java8 symbols

For agents

$ claude mcp add NetGoVPN-Android \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact