{"id":31558016,"url":"https://github.com/skygenesisenterprise/aether-vpn","last_synced_at":"2026-04-09T15:50:41.685Z","repository":{"id":318022217,"uuid":"1069673775","full_name":"skygenesisenterprise/aether-vpn","owner":"skygenesisenterprise","description":"Aether VPN is a lightweight, open-source client built for privacy, speed, and seamless integration within the Aether Office ecosystem","archived":false,"fork":false,"pushed_at":"2025-10-04T14:22:47.000Z","size":34,"stargazers_count":0,"open_issues_count":4,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-04T16:17:06.404Z","etag":null,"topics":["android","docker","docker-image","electron","gateway","ios","javascript","linux","macos","nextjs","typescript","vpn","vpn-client"],"latest_commit_sha":null,"homepage":"https://skygenesisenterprise.com/office","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/skygenesisenterprise.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":".github/SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"patreon":null,"open_collective":"skygenesisenterprise","ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2025-10-04T11:55:20.000Z","updated_at":"2025-10-04T14:22:50.000Z","dependencies_parsed_at":"2025-10-04T16:17:48.117Z","dependency_job_id":"6d52e217-b042-4d48-bdf7-140f3f27c4c1","html_url":"https://github.com/skygenesisenterprise/aether-vpn","commit_stats":null,"previous_names":["skygenesisenterprise/aether-vpn"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/skygenesisenterprise/aether-vpn","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skygenesisenterprise%2Faether-vpn","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skygenesisenterprise%2Faether-vpn/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skygenesisenterprise%2Faether-vpn/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skygenesisenterprise%2Faether-vpn/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/skygenesisenterprise","download_url":"https://codeload.github.com/skygenesisenterprise/aether-vpn/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skygenesisenterprise%2Faether-vpn/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278391405,"owners_count":25978983,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","docker","docker-image","electron","gateway","ios","javascript","linux","macos","nextjs","typescript","vpn","vpn-client"],"created_at":"2025-10-05T00:11:15.927Z","updated_at":"2025-12-30T19:49:32.504Z","avatar_url":"https://github.com/skygenesisenterprise.png","language":"TypeScript","funding_links":["https://opencollective.com/skygenesisenterprise"],"categories":[],"sub_categories":[],"readme":"# 🛡️ Aether VPN\n\n**Aether VPN** is a secure, enterprise-grade VPN solution built as part of the **Aether Office Suite**.  \nInspired by modern solutions like **NordVPN** and **Tailscale**, it combines **privacy, scalability, and simplicity** with a fully open and extensible architecture.\n\n---\n\n## 🚀 Overview\n\nAether VPN is designed to provide a **zero-configuration, high-security VPN platform** for both individuals and enterprises.  \nIt features a clean **Next.js + TypeScript client**, powered by a centralized backend API hosted on  \n`api.skygenesisenterprise.com`.\n\n### Key Principles\n\n- **Security-first design** — end-to-end encryption via WireGuard or OpenVPN.\n- **Unified API** — all VPN logic centralized under `/api/v1/vpn`.\n- **Cross-platform client** — built with Next.js and TypeScript.\n- **Enterprise integration** — single sign-on, device management, and role-based access control.\n- **Extensible core** — modular backend, ready for custom deployment or self-hosting.\n\n---\n\n## 🧠 Architecture Overview\n\n```\n\nClient (Next.js / TS)\n│\n│  HTTPS + JWT / OAuth2\n▼\nBackend API: api.skygenesisenterprise.com\n│\n├── Auth \u0026 Team Management\n├── Device \u0026 Tunnel Control\n├── Server Registry\n├── Key Distribution (WireGuard / OpenVPN)\n└── Metrics \u0026 Monitoring\n\n```\n\n---\n\n## 🧩 API Structure\n\nAll VPN logic is handled via REST routes under `/api/v1/vpn`.\n\n| Endpoint | Method | Description |\n|-----------|---------|-------------|\n| `/auth/login` | POST | User or enterprise authentication |\n| `/users/me` | GET | Retrieve current user info \u0026 roles |\n| `/devices` | GET / POST / DELETE | Register, list, or remove devices |\n| `/servers` | GET | Fetch available VPN servers |\n| `/tunnels/connect` | POST | Establish VPN tunnel |\n| `/tunnels/disconnect` | POST | Close VPN tunnel |\n| `/keys/:deviceId` | GET | Secure key distribution |\n| `/metrics` | GET | VPN usage statistics \u0026 server metrics |\n\n---\n\n## 🧱 Folder Structure\n\n```\n\n/pages/api/v1/vpn/\n├── auth/\n│     ├── login.ts\n│     ├── refresh.ts\n├── users/\n│     ├── me.ts\n├── devices/\n│     ├── index.ts\n│     ├── [id].ts\n├── servers/\n│     ├── index.ts\n│     ├── [id].ts\n├── tunnels/\n│     ├── connect.ts\n│     ├── disconnect.ts\n├── keys/\n│     ├── [deviceId].ts\n└── metrics/\n├── index.ts\n\n````\n\n---\n\n## ⚙️ Tech Stack\n\n- **Frontend / Client** → [Next.js](https://nextjs.org/) + TypeScript  \n- **Backend API** → Next.js API Routes (REST)  \n- **Protocol Layer** → WireGuard / OpenVPN  \n- **Auth** → JWT / OAuth2  \n- **Database** → PostgreSQL or MongoDB (via Prisma ORM)  \n- **Cloud Deployment** → Vercel, Fly.io, or self-hosted Docker containers  \n\n---\n\n## 🧩 Environment Setup\n\n```bash\n# Clone the repository\ngit clone https://github.com/aether-office/aether-vpn.git\ncd aether-vpn\n\n# Install dependencies\nnpm install\n\n# Run the development server\nnpm run dev\n\n# Access the app\nhttp://localhost:3000\n````\n\n### Required Environment Variables\n\n```\nNEXT_PUBLIC_API_URL=https://api.skygenesisenterprise.com\nDATABASE_URL=postgresql://user:pass@localhost:5432/aethervpn\nJWT_SECRET=your_jwt_secret\nWIREGUARD_KEY_PATH=/etc/aethervpn/keys/\n```\n\n---\n\n## 🏢 Enterprise \u0026 Pro Features (Planned)\n\n* **Team \u0026 Role Management**\n* **Advanced Audit Logs**\n* **Magic DNS \u0026 Split Tunneling**\n* **Zero-Trust Access Control**\n* **Custom Region Deployment**\n* **WebSocket Realtime Metrics**\n\n---\n\n## 🧰 Roadmap\n\n| Stage                  | Description                               | Status        |\n| ---------------------- | ----------------------------------------- | ------------- |\n| **MVP**                | Authentication, basic tunnel control      | ✅ In progress |\n| **v1.0**               | Multi-region servers, key management      | 🛠️ Planned   |\n| **Enterprise Edition** | Role-based access, DNS, metrics dashboard | ⏳ Future      |\n| **Mobile Clients**     | iOS / Android integration                 | 🔮 Future     |\n\n---\n\n## 🧑‍💻 Contributing\n\nWe welcome open-source contributions!\nIf you want to contribute, please:\n\n1. Fork this repository\n2. Create a new feature branch\n3. Submit a pull request with clear documentation\n\n---\n\n## 🌌 Part of the Aether Office Ecosystem\n\nAether VPN is a component of the **Aether Office Suite**, a collection of open, privacy-focused productivity and network tools:\n\n* 🧭 **Aether Desk** — Knowledge and workspace platform\n* 💾 **Aether Wallet** — Secure digital identity and key management\n* 🎵 **Aether Wave** — Decentralized music platform\n* 🏬 **Aether Store** — Open-source universal app marketplace\n\n---\n\n\n## 🛡️ License\n\nAether VPN is released under the **Apache 2.0 License**.\nSee [`LICENSE`](./LICENSE) for more information.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskygenesisenterprise%2Faether-vpn","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fskygenesisenterprise%2Faether-vpn","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskygenesisenterprise%2Faether-vpn/lists"}