[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-83971":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":8,"language":9,"languages":8,"totalLinesOfCode":8,"stars":10,"forks":11,"watchers":12,"openIssues":13,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":15,"stars7d":16,"stars30d":16,"stars90d":14,"forks30d":14,"starsTrendScore":17,"compositeScore":18,"rankGlobal":8,"rankLanguage":8,"license":8,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":21,"hasPages":19,"topics":22,"createdAt":8,"pushedAt":8,"updatedAt":23,"readmeContent":24,"aiSummary":8,"trendingCount":14,"starSnapshotCount":14,"syncStatus":25,"lastSyncTime":26,"discoverSource":27},83971,"aethergate-pro","JFGAtlas\u002Faethergate-pro","JFGAtlas",null,"Python",337,49,1,3,0,9,154,172,5.1,false,"main",true,[],"2026-06-12 02:04:36","# AetherGate Pro 🌌\n\n[中文文档](README_CN.md)\n\nAetherGate Pro is an enterprise-grade, high-availability VPN & Proxy Gateway manager designed to run on Linux Virtual Private Servers (VPS). Built by and for proxy network engineers, it solves the notorious issue of SSH disconnection and routing conflicts commonly experienced when running VPN gateways directly on VPS host interfaces.\n\nBy isolating all VPN activity inside a dedicated Linux **Network Namespace (`netns`)** and routing proxy traffic via an asynchronous single-port mixed protocol (SOCKS5\u002FHTTP) server, AetherGate Pro provides a seamless, self-healing proxy gateway with a gorgeous glassmorphic dashboard.\n\n---\n\n## 🚀 Key Features\n\n* **Network Namespace Isolation (`netns`)**: Restricted default routing within `vpn_ns` namespace prevents host interface pollution. Say goodbye to SSH drops and disconnected VPS sessions!\n* **Mixed Protocol Single-Port Proxy**: Auto-sniffs incoming client connections on port `7928` to serve both **SOCKS5** and **HTTP** protocols on a single port.\n* **Auto-Geolocation & Scamalytics Fraud Score Filtering**: Concurrently scrapes VPNGate, performs latency pinging, runs IP geolocations, and checks Scamalytics fraud risks. Hides nodes with a fraud score $\\ge 10$ to guarantee pure residential\u002Fmobile outbound traffic.\n* **Modern Web Dashboard**: A futuristic, glassmorphic dark-themed control center featuring mouse spotlight tracking, real-time diagnostic consoles, auto-refreshing connection tables, and lock settings.\n* **Watchdog Self-Healing**: Automatically monitors the VPN tunnel. If a node fails or latency spikes, the background watchdog triggers auto-reconnection\u002Ffailover.\n* **Systemd Daemon Integration**: Designed to run as a persistent system service that auto-starts on system boot.\n\n---\n\n## 🛠️ Architecture Overview\n\n```mermaid\nflowchart TD\n    subgraph Host OS [Host OS Network Space]\n        SSH[SSH Session - Port 22] -->|No interference| HostRouting[Host Routing Table]\n        User[Admin Browser] -->|Port 8787| WebUI[Async Dashboard Server]\n        ClientProxy[Client Proxy App] -->|Port 7928| SocatForwarder[socat Port Forwarder]\n    end\n\n    subgraph NetNS [vpn_ns isolated namespace]\n        SocatForwarder -->|Forward tunnel| NamespaceProxy[Mixed SOCKS5\u002FHTTP Proxy]\n        NamespaceProxy -->|Outbound request| OpenVPN[OpenVPN Client Process]\n        OpenVPN -->|Tunnel Interface tun0| VirtualEthernet[veth_vpn: 10.200.0.2]\n    end\n\n    VirtualEthernet \u003C-->|NAT Masquerade| veth_host[veth_host: 10.200.0.1]\n    veth_host \u003C--> Internet((Global Internet))\n    OpenVPN \u003C-->|Encrypted Tunnel| VPNGateNode[VPNGate Target Node]\n```\n\n---\n\n## 📥 VPS Deployment Guide\n\nThis guide describes how to deploy **AetherGate Pro** on a clean Linux VPS (Ubuntu 20.04\u002F22.04+ or Debian 11+ recommended).\n\n### Option 1: One-Key Installation (Recommended)\n\nSimply run the following command on your VPS to automatically pull the repository and install the gateway:\n```bash\ncurl -sSL https:\u002F\u002Fraw.githubusercontent.com\u002FJFGAtlas\u002Faethergate-pro\u002Fmain\u002Finstall_vps.sh | bash\n```\n\n---\n\n### Option 2: Manual Installation\n\n#### 1. Prerequisites\nEnsure you have root access to your VPS. Connect via SSH:\n```bash\nssh root@your_vps_ip\n```\n\n#### 2. Clone Repository to VPS\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FJFGAtlas\u002Faethergate-pro.git \u002Ftmp\u002Faethergate-pro\n```\n\n#### 3. Run the Installer\n```bash\ncd \u002Ftmp\u002Faethergate-pro\nsudo bash install.sh\n```\n\n**What the installer does:**\n1. Installs system packages: `openvpn`, `socat`, `python3`, `iptables`.\n2. Cleanly stops any conflicting older proxy daemons.\n3. Places the codebase into the target production directory `\u002Fopt\u002Fvpngate-pro\u002F`.\n4. Migrates existing credentials (`\u002Fopt\u002Faimilivpn\u002Fvpngate_data\u002Fui_auth.json`) into `\u002Fopt\u002Fvpngate-pro\u002Fvpngate_data\u002Fconfig.json` if present.\n5. Sets up persistent IP forwarding (`sysctl`).\n6. Configures and registers the `vpngate-pro.service` systemd service.\n7. Automatically launches the service.\n\n### 4. Verify the Installation\nCheck that the AetherGate systemd service is active:\n```bash\nsudo systemctl status vpngate-pro\n```\n\nYou should see output indicating the service is `active (running)`.\n\n---\n\n## 🖥️ Usage & Access\n\n### 1. Web Dashboard\nAfter successful installation, the Web Dashboard will be exposed at:\n* **URL**: `http:\u002F\u002F\u003CYOUR_VPS_IP>:8787\u002F\u003CSECRET_PATH>\u002F`\n  *(Note: The `\u003CSECRET_PATH>` is generated on first startup. You can read or customize it in the config file).*\n* **Default Credentials**:\n  * **Username**: `admin`\n  * **Password**: A random password stored in `\u002Fopt\u002Fvpngate-pro\u002Fvpngate_data\u002Fconfig.json` on first startup (or migrated from your old installation).\n\n### 2. Connecting to Proxy\nSet up your local browser (e.g., SwitchyOmega) or system client to use the Mixed Proxy:\n* **Proxy Address**: `\u003CYOUR_VPS_IP>`\n* **Proxy Port**: `7928`\n* **Supported Protocols**: **SOCKS5** (recommended) or **HTTP** (both listen on `7928` simultaneously).\n\n---\n\n## ⚙️ Advanced Customization\n\nYou can manually tweak settings in `\u002Fopt\u002Fvpngate-pro\u002Fvpngate_data\u002Fconfig.json`:\n```json\n{\n  \"username\": \"admin\",\n  \"password\": \"your_secure_password\",\n  \"secret_path\": \"your_dashboard_url_token\",\n  \"ui_host\": \"0.0.0.0\",\n  \"ui_port\": 8787,\n  \"proxy_host\": \"127.0.0.1\",\n  \"proxy_port\": 7928,\n  \"routing_mode\": \"auto\",\n  \"force_country\": \"\",\n  \"connection_enabled\": false,\n  \"fixed_node_id\": \"\",\n  \"scamalytics_threshold\": 10\n}\n```\n*Remember to run `sudo systemctl restart vpngate-pro` after modifying the configuration manually.*\n\n---\n\n## 🗃️ Management Commands\n\n```bash\n# Restart the gateway and cleanly recreate namespace\u002Fforwarding rules\nsudo systemctl restart vpngate-pro\n\n# Stop the gateway and tear down network namespaces\nsudo systemctl stop vpngate-pro\n\n# View live system logs and connection states\nsudo journalctl -u vpngate-pro -f --no-pager\n```\n\n---\n\n## ⚖️ License\nThis project is open-source and licensed under the MIT License. Feel free to fork, contribute, and open issues.\n",2,"2026-06-11 04:11:55","CREATED_QUERY"]