mirror of
https://github.com/baoweise-bot/aimili-vpngate.git
synced 2026-09-06 16:16:53 +08:00
docs: simplify installation and connection guide
This commit is contained in:
Aimili
@@ -1,108 +1,88 @@
|
||||
# AimiliVPN 🌐
|
||||
# AimiliVPN
|
||||
|
||||
[](https://github.com/baoweise-bot/aimili-vpngate/releases/latest)
|
||||
[](https://github.com/baoweise-bot/aimili-vpngate/tree/main)
|
||||
[](https://github.com/baoweise-bot/aimili-vpngate/releases/latest)
|
||||
[](https://github.com/baoweise-bot/aimili-vpngate/pkgs/container/aimili-vpngate)
|
||||
|
||||
Bilingual: [中文](#中文) | [English](#english)
|
||||
AimiliVPN 是运行在 Linux VPS 上的 VPNGate 节点管理与代理网关，提供 Web 管理后台以及同端口的 HTTP、HTTPS 和 SOCKS5 代理接入。
|
||||
|
||||
---
|
||||
> 本项目需要 Linux、root 权限、OpenVPN、iptables、策略路由和可用的 TUN/TAP 设备。Windows 与 macOS 可以作为代理客户端使用，但不能直接运行完整网关。
|
||||
|
||||
<a name="中文"></a>
|
||||
## 中文 (Chinese)
|
||||
## VPS 推荐
|
||||
|
||||
AimiliVPN 是一款基于官方 VPNGate 开放协议的高性能、零依赖 VPN 代理网关。它以纯 Python 标准库编写，内置美观响应式的管理网页，提供智能并发测速、多路由模式、出站代理网关、实时日志等强大功能。
|
||||
以下链接含推广参数，通过链接购买不会增加您的费用。
|
||||
|
||||
---
|
||||
|
||||
### 📌 当前正式版本：V2.1
|
||||
|
||||
V2.1 是项目启用正式版本标志后的首个稳定版本。仓库、安装器、命令行更新和 Web 更新检测现在全部统一使用 **`main` 主分支正式通道**。
|
||||
|
||||
#### V2.1 更新进展
|
||||
|
||||
- **节点来源容灾**：依次尝试 VPNGate 官方 HTTPS、官方 HTTP、GitHub Pages HTTPS、GitHub Pages HTTP、VPS 本地最近有效快照和仓库内置初始快照。
|
||||
- **获取与切换修复**：缩短被 VPNGate 域名封锁的 VPS 等待时间；切换新节点前先完成预检，目标失败时保留当前可用连接。
|
||||
- **节点可视化**：恢复延迟列，优先显示本机实测延迟；没有实测值时显示 VPNGate 官方预估值并明确标注“仅供参考”。
|
||||
- **国家筛选**：支持带国旗和节点数量的实时多选筛选，选择范围保存到本机，并作用于手动更新和后台周期同步。
|
||||
- **节点操作**：恢复单节点“检测”按钮，补齐收藏、检测、连接和断开状态逻辑。
|
||||
- **镜像同步**：GitHub Pages 每 15 分钟同步并校验官方节点快照，官方 API 被屏蔽时自动回退。
|
||||
- **Web 更新检测**：页面顶部显示 `V2.1 正式版`，只检查 GitHub 最新稳定 Release，并根据 Python 源码或 Docker 部署方式显示正确更新命令。
|
||||
- **正式发布链路**：GitHub 标签或手动重跑会依次执行 Python 兼容测试、四架构 Docker 冒烟测试、GHCR 镜像发布，全部成功后才发布通用源码包与 SHA-256 校验文件。
|
||||
|
||||
#### 系统与架构兼容性
|
||||
|
||||
| 类型 | 正式支持范围 | 安装或镜像标识 |
|
||||
| --- | --- | --- |
|
||||
| Linux x64 | Intel/AMD 64 位 VPS | 通用 Python 源码 / Docker `linux/amd64` |
|
||||
| Linux x86 | Intel/AMD 32 位系统 | 通用 Python 源码 / Docker `linux/386` |
|
||||
| Linux ARM64 | AArch64、ARMv8 VPS/开发板 | 通用 Python 源码 / Docker `linux/arm64` |
|
||||
| Linux ARM32 | ARMv7 设备 | 通用 Python 源码 / Docker `linux/arm/v7` |
|
||||
| Linux 发行版 | Debian、Ubuntu、CentOS、RHEL、Rocky、AlmaLinux、Fedora、Oracle Linux、Amazon Linux、Alpine | 使用同一正式核心 |
|
||||
| Docker | Linux 主机上的 amd64、386、arm64、arm/v7 | GHCR 多架构镜像 |
|
||||
|
||||
> AimiliVPN 依赖 Linux 的 TUN、OpenVPN、iptables 和策略路由，因此不发布虚假的 Windows/macOS 原生兼容包。Windows 或 macOS 只能作为代理客户端使用，不能直接运行完整网关；Docker Desktop 同样不等同于具备宿主机 TUN 能力的 Linux 服务器。
|
||||
|
||||
项目由纯 Python 标准库组成，不需要为 CPU 编译不同的 Python 二进制。GitHub Release 只提供一个通用 Linux 源码包；GHCR 才会实际构建并发布四种 CPU 架构的 Docker 镜像。
|
||||
|
||||
---
|
||||
|
||||
### 🌟 VPS 优选推荐：跑 AimiliVPN 更稳更省心
|
||||
[](https://bandwagonhost.com/aff.php?aff=81790)
|
||||
[](https://my.racknerd.com/aff.php?aff=18708)
|
||||
|
||||
| 推荐 | 适合谁 | 亮点 | 入口 |
|
||||
| 推荐 | 适用场景 | 主要特点 | 购买入口 |
|
||||
| --- | --- | --- | --- |
|
||||
| **BandwagonHost 搬瓦工** | 更看重国内访问质量、延迟和线路上限的用户 | **顶级三网优化线路**，适合对网络体验、跨境访问质量和长期稳定性要求更高的场景 | [立即查看](https://bandwagonhost.com/aff.php?aff=81790) |
|
||||
| **RackNerd** | 想低成本部署、测试、长期挂机的用户 | **每月 6000GB 流量**，价格实惠、配置给得足，适合入门部署和性价比优先的 VPS 需求 | [立即查看](https://my.racknerd.com/aff.php?aff=18708) |
|
||||
| **BandwagonHost 搬瓦工** | 重视国内访问质量、延迟和线路稳定性 | 三网优化线路，适合对跨境网络质量要求较高的长期使用场景 | [查看 BandwagonHost](https://bandwagonhost.com/aff.php?aff=81790) |
|
||||
| **RackNerd** | 低成本部署、测试和长期挂机 | 流量充足、价格较低，适合入门部署和性价比优先的 VPS | [查看 RackNerd](https://my.racknerd.com/aff.php?aff=18708) |
|
||||
|
||||
---
|
||||
## 安装方式
|
||||
|
||||
### 📢 官方交流与反馈
|
||||
[](https://t.me/arestemple)
|
||||
[](https://339936.xyz)
|
||||
[](https://www.youtube.com/watch?v=s-ATfXR8BpI)
|
||||
[](mailto:yaohunse7@gmail.com)
|
||||
### 安装前确认
|
||||
|
||||
---
|
||||
- 使用 Ubuntu、Debian、Alpine、CentOS、RHEL、Rocky Linux、AlmaLinux、Fedora、Oracle Linux 或 Amazon Linux。
|
||||
- 使用 `root` 用户运行安装命令。
|
||||
- 在 VPS 控制面板中启用 TUN/TAP，并确认 `/dev/net/tun` 存在。
|
||||
- 放行 Web 管理端口，默认是 TCP `8787`。建议只允许自己的 IP 访问。
|
||||
- Python 源码适用于 x64、x86、ARM64 和 ARM32；预构建 Docker 镜像支持 `linux/amd64`、`linux/386`、`linux/arm64` 和 `linux/arm/v7`。
|
||||
|
||||
### 🚀 安装与正式版更新
|
||||
### 一键源码安装（推荐）
|
||||
|
||||
#### 方法一：从 main 主分支一键安装（推荐）
|
||||
|
||||
在 Linux VPS 上以 root 用户执行：
|
||||
在 VPS 上执行：
|
||||
|
||||
```bash
|
||||
bash <(curl -Ls https://raw.githubusercontent.com/baoweise-bot/aimili-vpngate/main/install.sh)
|
||||
```
|
||||
|
||||
部署完成后，终端会输出管理网页专属链接。输入 `ml update` 时只会获取并切换到 `origin/main`，不会检测或切换任何测试分支。
|
||||
安装器会自动安装依赖、部署到 `/opt/aimilivpn`、注册系统服务，并生成 Web 安全路径、登录账号和密码。请保存安装完成时终端输出的登录信息。
|
||||
|
||||
#### 方法二：GitHub 正式发行包
|
||||
|
||||
[Releases 页面](https://github.com/baoweise-bot/aimili-vpngate/releases/latest)提供以下文件：
|
||||
|
||||
- `aimilivpn-v2.1.0-linux-source.tar.gz`：适用于支持 Python 3 和项目系统依赖的 Linux x64、x86、ARM64、ARMv7 主机。
|
||||
- `sha256sums.txt`：源码包的 SHA-256 校验值。
|
||||
|
||||
#### 方法三：Docker / Docker Compose
|
||||
|
||||
Docker 镜像地址：`ghcr.io/baoweise-bot/aimili-vpngate:2.1`。仓库中的 [`compose.yaml`](./compose.yaml) 已配置主机网络、`NET_ADMIN` 和 TUN 设备：
|
||||
常用管理命令：
|
||||
|
||||
```bash
|
||||
ml # 打开管理菜单
|
||||
ml status # 查看运行状态和连接信息
|
||||
ml logs # 查看实时日志
|
||||
ml restart # 重启服务
|
||||
ml update # 从 main 正式分支更新
|
||||
ml uninstall # 卸载
|
||||
```
|
||||
|
||||
不希望直接通过 `curl` 执行脚本时，也可以克隆仓库后检查并运行安装器：
|
||||
|
||||
```bash
|
||||
git clone --branch main --single-branch https://github.com/baoweise-bot/aimili-vpngate.git
|
||||
cd aimili-vpngate
|
||||
sudo bash install.sh
|
||||
```
|
||||
|
||||
通用 Linux 源码包和 SHA-256 校验文件可从 [GitHub Releases](https://github.com/baoweise-bot/aimili-vpngate/releases/latest) 下载。版本变更记录也统一发布在 Releases 页面。
|
||||
|
||||
### Docker Compose
|
||||
|
||||
Docker 主机必须能够使用 `/dev/net/tun`、host 网络以及 `NET_ADMIN`、`NET_RAW` 权限。
|
||||
|
||||
```bash
|
||||
git clone --branch main --single-branch https://github.com/baoweise-bot/aimili-vpngate.git
|
||||
cd aimili-vpngate
|
||||
docker compose pull
|
||||
docker compose up -d
|
||||
docker logs -f aimilivpn
|
||||
```
|
||||
|
||||
无法访问 GHCR 或需要自行审查构建过程时，也可以在 VPS 的仓库目录本地构建：
|
||||
正式镜像地址：
|
||||
|
||||
```text
|
||||
ghcr.io/baoweise-bot/aimili-vpngate:2.1
|
||||
```
|
||||
|
||||
更新容器：
|
||||
|
||||
```bash
|
||||
docker compose build
|
||||
docker compose pull
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
也可以直接运行：
|
||||
### Docker 直接运行
|
||||
|
||||
```bash
|
||||
docker run -d \
|
||||
@@ -112,229 +92,112 @@ docker run -d \
|
||||
--cap-add NET_ADMIN \
|
||||
--cap-add NET_RAW \
|
||||
--device /dev/net/tun:/dev/net/tun \
|
||||
-e UI_HOST=0.0.0.0 \
|
||||
-e UI_PORT=8787 \
|
||||
-e LOCAL_PROXY_HOST=127.0.0.1 \
|
||||
-e LOCAL_PROXY_PORT=7928 \
|
||||
-v aimilivpn-data:/data \
|
||||
ghcr.io/baoweise-bot/aimili-vpngate:2.1
|
||||
```
|
||||
|
||||
> Docker 方式只支持具备 `/dev/net/tun` 的 Linux 主机，并需要 `NET_ADMIN`、`NET_RAW` 能力。管理页面默认端口为 `8787`，本机 HTTP/SOCKS5 代理默认端口为 `7928`。容器检测到新版本后会提示重新拉取镜像，不会在容器内执行 `git pull`。
|
||||
### 在 VPS 本地构建 Docker 镜像
|
||||
|
||||
---
|
||||
|
||||
### 💡 快速使用指南 (小白必看)
|
||||
|
||||
部署成功后，如何使用它进行科学上网？
|
||||
|
||||
#### 第一步：登录 Web 管理后台
|
||||
打开浏览器，访问部署完成时提示的专属后台地址（含安全后缀），即可进入精美的暗黑玻璃拟物风管理界面。
|
||||
|
||||
#### 第二步：获取并连接节点
|
||||
1. 首次进入后台，节点列表可能正在进行首次自动测速与拉取。
|
||||
2. 点击 **“更新节点”** 按钮（或通过网页下方的网关/日志进行状态检查），程序会在后台通过多线程并发测速，自动筛选出延迟最低、可连接的 VPNGate 节点。
|
||||
3. 选择您喜欢的出站路由模式：
|
||||
- **智能自动配置**（推荐）：如果当前连接的节点失效，系统会在数秒内自动漂移连接至其他备用健康节点，无需手动干预。
|
||||
- **固定国家地区**：只选择指定国家（如日本 JP、韩国 KR、美国 US）的最佳节点。
|
||||
- **固定 IP 节点**：始终锁定连接到这一个特定节点。
|
||||
|
||||
#### 第三步：使用本机代理 (核心步骤)
|
||||
为了防止代理端口暴露至公网被恶意扫描和滥用，AimiliVPN 的双效代理服务（默认端口 **`7928`**，自适应支持 SOCKS5 和 HTTP 协议）**默认仅绑定在本地回环地址（`127.0.0.1`）**，只接收 VPS 本机上的流量，不对外机提供代理。
|
||||
|
||||
* **🐍 Python 脚本中使用代理**:
|
||||
```python
|
||||
import requests
|
||||
proxies = {
|
||||
"http": "http://127.0.0.1:7928",
|
||||
"https": "http://127.0.0.1:7928",
|
||||
}
|
||||
response = requests.get("https://www.google.com", proxies=proxies)
|
||||
```
|
||||
* **🐚 Shell 终端环境中使用代理**:
|
||||
在命令行执行以下命令，可以让当前终端的后续命令（如 `curl`、`wget` 等）走代理出口：
|
||||
```bash
|
||||
export http_proxy="http://127.0.0.1:7928"
|
||||
export https_proxy="http://127.0.0.1:7928"
|
||||
```
|
||||
* **⚙️ 本地其他服务配置**:
|
||||
将本机的其他代理工具、爬虫框架或服务的出战代理设置为 `127.0.0.1:7928`。
|
||||
|
||||
> 💡 **小贴士**：如果您确实需要对公网其他设备开放此代理端口，可以通过设置环境变量 `export LOCAL_PROXY_HOST="::"` 重新启动服务以允许公网接入。
|
||||
|
||||
---
|
||||
|
||||
### 🛠️ 核心功能与操作说明
|
||||
|
||||
* **合并操作面板**：将“更新节点”与“立即检测补齐”合并，一键触发多线程拉取与测速。
|
||||
* **正式版更新检测**：Web 顶部版本菜单可以检查 GitHub 最新稳定 Release；源码部署提示 `ml update`，Docker 部署提示重新拉取并启动镜像。
|
||||
* **多国家发现范围**：节点表可实时勾选多个国家；点击“更新节点”后保存范围并影响后台周期拉取。
|
||||
* **延迟来源区分**：实测延迟正常显示，官方 Ping 回退值使用弱化样式并标注为预估。
|
||||
* **网关状态面板**：
|
||||
- **系统诊断**：检测网关心跳及后台各个子守护线程（网页服务、VPN连接管理、出站网关服务）是否正常运行。若有脚本未运行，会提示具体的异常原因。
|
||||
- **本地代理出口检测**：在网页端直接一键检测 VPS 后台对海外的实际连通状况，并回显真实的代理出站 IP 和所在地理位置。
|
||||
* **日志追踪面板**：
|
||||
- **分类过滤**：可精准筛选查看特定功能的日志（如 VPN 连接日志、API 请求日志、系统异常等）。
|
||||
- **实时滚动与管理**：日志实时滚动加载，支持一键复制代码、一键导出 `.log` 日志文件到本地。
|
||||
|
||||
---
|
||||
|
||||
### ⚠️ 小白安装与运行常见问题 (FAQ)
|
||||
|
||||
#### 1. 提示 `Cannot allocate tun` 或 `Cannot open tun/tap dev`
|
||||
* **原因**：VPS 宿主机未启用虚拟网卡（TUN/TAP 设备）。这种情况常见于 LXC 或 OpenVZ 架构的轻量 VPS。
|
||||
* **解决办法**：请登录您的 VPS 服务商控制面板（如 SolusVM/Proxmox），找到 **Enable TUN/TAP** / **开启 TUN** 选项并启用，然后重启 VPS。如无此选项，请工单联系客服开启。
|
||||
|
||||
#### 2. 网页管理后台无法打开（链接超时或拒绝连接）
|
||||
* **原因 1**：VPS 本身自带防火墙（如 UFW、firewalld 或 iptables）阻断了管理端口（默认 `8787`）或代理端口（默认 `7928`）。
|
||||
* **解决办法 1**：请在终端放行对应端口：
|
||||
* **UFW (Ubuntu/Debian)**: `ufw allow 8787/tcp && ufw allow 7928/tcp`
|
||||
* **Firewalld (CentOS/RHEL)**: `firewall-cmd --zone=public --add-port=8787/tcp --permanent && firewall-cmd --zone=public --add-port=7928/tcp --permanent && firewall-cmd --reload`
|
||||
* **原因 2**：云服务商的“安全组”或“网络访问控制列表 (ACL)”未放行端口。
|
||||
* **解决办法 2**：**非常重要！** 登录云服务商控制台（如阿里云、腾讯云、AWS、Oracle Cloud等），找到您 VPS 实例的 **安全组规则 (Security Group)**，在入站规则中添加：
|
||||
- **协议类型**: `TCP`
|
||||
- **端口范围**: `8787` (管理网页) 和 `7928` (代理端口)
|
||||
- **授权对象/源IP**: `0.0.0.0/0` (允许所有人，或指定您自己的家庭公网 IP 提高安全性)
|
||||
|
||||
#### 3. 页面提示 `API Domain Blocked` 且备选节点显示为 0
|
||||
* **原因**：您的 VPS DNS 解析异常，或者官方 VPNGate 域名遭防火墙拦截污染，导致无法下载节点列表。
|
||||
* **解决办法**：
|
||||
* **设置上游代理**：如果您有其他可用的代理服务，可在网页管理面板中打开“管理员 -> 代理及网络设置”，配置有效的 HTTP/SOCKS5 上游代理，后台会自动通过该代理拉取更新。
|
||||
* **修改 DNS 解析器**：在终端修改 `/etc/resolv.conf`，将域名服务器替换为公共 DNS（如 `nameserver 8.8.8.8` 和 `nameserver 1.1.1.1`）。
|
||||
|
||||
程序会按以下顺序自动回退，不需要用户手动切换：
|
||||
|
||||
1. VPNGate 官方 HTTPS
|
||||
2. VPNGate 官方 HTTP（兼容旧系统，结果不会覆盖 HTTPS 获得的可信缓存）
|
||||
3. GitHub Pages 镜像 HTTPS
|
||||
4. GitHub Pages 镜像 HTTP
|
||||
5. VPS 本地最近有效快照；首次安装时使用仓库附带的初始快照
|
||||
|
||||
默认镜像为 `https://baoweise-bot.github.io/aimili-vpngate/vpngate.csv`。仓库管理员需要在 GitHub 的 **Settings -> Pages** 中将 Source 设置为 **GitHub Actions**，定时工作流会每 15 分钟校验并发布一次快照。可通过 `VPNGATE_API_HTTPS_URL`、`VPNGATE_API_HTTP_URL`、`VPNGATE_MIRROR_HTTPS_URL` 和 `VPNGATE_MIRROR_HTTP_URL` 覆盖各节点源。
|
||||
|
||||
#### 4. VPN 已成功连接，但客户端设置代理后无法上网 (无流量)
|
||||
* **原因**：部分系统启用了严格的反向路径过滤（`rp_filter`），导致策略路由的入站/出站数据包被系统误判丢弃。
|
||||
* **解决办法**：在终端输入 `ml` 命令打开交互菜单，工具会自动检测并提示您将 `rp_filter` 修复为宽松模式（值为 `2`）。
|
||||
|
||||
---
|
||||
|
||||
### 🎁 捐赠支持项目开发
|
||||
|
||||
如果您觉得这个项目对您有所帮助，欢迎捐赠支持我们的后续开发与维护：
|
||||
|
||||
* **BNB (BSC / BEP20)**: `0xB6d78c42CEB0687A31B8cfEBE4b51b6eB8953C17`
|
||||
* **TRX (TRC20)**: `TSdzCW6JvsrqcppodYjhSrku4mYmDJ9pxf`
|
||||
|
||||
感谢您的慷慨与支持！❤️
|
||||
|
||||
---
|
||||
|
||||
<a name="english"></a>
|
||||
## English
|
||||
|
||||
AimiliVPN is a high-performance, zero-dependency VPN proxy gateway built entirely using Python's standard library. It parses official VPNGate servers, benchmarks latency, and routes traffic through a built-in dual-protocol (HTTP/SOCKS5) proxy server.
|
||||
|
||||
### 🌟 Recommended VPS Deals
|
||||
[](https://bandwagonhost.com/aff.php?aff=81790)
|
||||
[](https://my.racknerd.com/aff.php?aff=18708)
|
||||
|
||||
| Pick | Best for | Highlights | Link |
|
||||
| --- | --- | --- | --- |
|
||||
| **BandwagonHost** | Users who care most about China connectivity, latency, and route quality | **Premium China Telecom/Unicom/Mobile optimized routes**, ideal for demanding cross-border networking and long-term use | [View deals](https://bandwagonhost.com/aff.php?aff=81790) |
|
||||
| **RackNerd** | Budget deployments, testing, and long-running lightweight services | **6000GB monthly bandwidth**, affordable pricing, and generous specs for value-focused VPS use | [View deals](https://my.racknerd.com/aff.php?aff=18708) |
|
||||
|
||||
|
||||
### 📢 Community & Feedback
|
||||
- **Telegram Group**: [arestemple](https://t.me/arestemple)
|
||||
- **Discussion Forum**: [339936.xyz](https://339936.xyz)
|
||||
- **Video Tutorial**: [YouTube Guide](https://www.youtube.com/watch?v=s-ATfXR8BpI)
|
||||
- **Email Contact**: yaohunse7@gmail.com
|
||||
|
||||
---
|
||||
|
||||
### 🚀 One-Click Installation
|
||||
|
||||
Run the corresponding command on your Linux VPS as root:
|
||||
|
||||
#### 🌟 V2.1 Formal Release (main branch only)
|
||||
```bash
|
||||
bash <(curl -Ls https://raw.githubusercontent.com/baoweise-bot/aimili-vpngate/main/install.sh)
|
||||
```
|
||||
|
||||
> 💡 **Quick Note**: Once installed, copy the printed URL from the terminal to access the Web UI. Type the `ml` command in the terminal to summon the interactive CLI management console.
|
||||
|
||||
#### Docker / Docker Compose
|
||||
|
||||
GitHub publishes prebuilt images for `linux/amd64`, `linux/386`, `linux/arm64`, and `linux/arm/v7` under `ghcr.io/baoweise-bot/aimili-vpngate:2.1`:
|
||||
无法拉取 GHCR 镜像或希望自行审查构建过程时，可在仓库目录构建：
|
||||
|
||||
```bash
|
||||
docker compose pull
|
||||
git clone --branch main --single-branch https://github.com/baoweise-bot/aimili-vpngate.git
|
||||
cd aimili-vpngate
|
||||
docker compose build
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
To build natively on the VPS instead, run `docker compose build` before `docker compose up -d`. Docker requires a Linux host with `/dev/net/tun`, `NET_ADMIN`, and `NET_RAW` support.
|
||||
## 连接与使用
|
||||
|
||||
---
|
||||
### 登录 Web 管理后台
|
||||
|
||||
### 💡 Quick Start Guide
|
||||
源码安装完成后，终端会显示完整地址、账号和密码，地址格式如下：
|
||||
|
||||
#### Step 1: Access the Web UI
|
||||
Open your browser and navigate to the printed URL (e.g. `http://your_vps_ip:8787/u71e9IXp4TPx`).
|
||||
```text
|
||||
http://VPS_IP:8787/随机安全路径/
|
||||
```
|
||||
|
||||
#### Step 2: Select Node and Mode
|
||||
1. Wait for the program to complete its first automatic node speed benchmarks.
|
||||
2. Under "Admin", you can trigger node fetching. The backend concurrently tests official VPNGate nodes and ranks them by latency.
|
||||
3. Switch routes mode (Smart Auto, Specific Region, or Specific Server Node) according to your needs.
|
||||
忘记地址时可执行 `ml status` 查看；需要重新设置账号或密码时执行 `ml password`。
|
||||
|
||||
#### Step 3: Use Localhost Proxy (Core Step)
|
||||
To prevent unauthorized scanning and abuse of the proxy port on the public internet, the built-in HTTP/SOCKS5 proxy server (default port **`7928`**) **binds to localhost (`127.0.0.1`) by default**. It is designed to route traffic generated locally on the VPS, rather than acting as a public proxy server.
|
||||
Docker 首次启动会把 Web 安全路径以及自动生成的账号和密码保存到数据卷，可执行以下命令查看：
|
||||
|
||||
* **🐍 Proxy in Python**:
|
||||
```python
|
||||
import requests
|
||||
proxies = {
|
||||
"http": "http://127.0.0.1:7928",
|
||||
"https": "http://127.0.0.1:7928",
|
||||
}
|
||||
response = requests.get("https://www.google.com", proxies=proxies)
|
||||
```
|
||||
* **🐚 Proxy in Shell terminal**:
|
||||
```bash
|
||||
export http_proxy="http://127.0.0.1:7928"
|
||||
export https_proxy="http://127.0.0.1:7928"
|
||||
```
|
||||
* **⚙️ Other local services**:
|
||||
Configure your scrapers, frameworks, or utility tools on this VPS to send traffic via `127.0.0.1:7928`.
|
||||
```bash
|
||||
docker exec aimilivpn cat /data/ui_auth.json
|
||||
```
|
||||
|
||||
> 💡 **Quick Note**: If you really need to open this proxy port to the public internet, you can set the environment variable `export LOCAL_PROXY_HOST="::"` before running the manager.
|
||||
读取其中的 `secret_path`、`username` 和 `password`，再访问：
|
||||
|
||||
---
|
||||
```text
|
||||
http://VPS_IP:8787/secret_path/
|
||||
```
|
||||
|
||||
### ⚠️ Common Troubleshooting (FAQ)
|
||||
首次登录后，建议在管理后台修改 Web 安全路径和登录凭据。
|
||||
|
||||
#### 1. Error: `Cannot allocate tun` or `Cannot open tun/tap dev`
|
||||
* **Reason**: Virtual network adapter (TUN/TAP device) is disabled. This is common in OpenVZ/LXC VPS instances.
|
||||
* **Solution**: Enable **TUN/TAP** in your VPS SolusVM/KiwiVM control panel, or submit a support ticket to your hosting provider.
|
||||
### 获取并连接节点
|
||||
|
||||
#### 2. Cannot open the Web UI in the browser
|
||||
* **Reason 1**: The built-in firewall (UFW or firewalld) is blocking ports `8787` (Web UI) and `7928` (Proxy).
|
||||
* **Solution 1**: Allow the ports in your OS firewall:
|
||||
* **UFW**: `ufw allow 8787/tcp && ufw allow 7928/tcp`
|
||||
* **Firewalld**: `firewall-cmd --add-port=8787/tcp --permanent && firewall-cmd --add-port=7928/tcp --permanent && firewall-cmd --reload`
|
||||
* **Reason 2**: Service provider security group blocking ports.
|
||||
* **Solution 2**: **Crucial!** Log in to your cloud provider console (AWS, Aliyun, Oracle Cloud, etc.), locate the **Security Group** for your instance, and add an inbound TCP rule to allow ports `8787` and `7928` from `0.0.0.0/0`.
|
||||
1. 登录 Web 后台，等待首次节点列表加载完成，或点击“更新节点”。
|
||||
2. 按国家筛选节点，需要时先使用“测试”检查实际延迟和可用性。
|
||||
3. 点击目标节点的“切换”进行连接；切换前会先预检目标节点，目标不可用时会尽量保留当前连接。
|
||||
4. 根据需要选择智能自动、固定国家或固定 IP 路由模式。
|
||||
5. 在状态区域确认 VPN 已连接，并检查当前出口 IP。
|
||||
|
||||
#### 3. "API Domain Blocked" / Candidate nodes pool is empty (0 nodes)
|
||||
* **Reason**: The official VPNGate domain is blocked or DNS resolution failed on your VPS.
|
||||
* **Solution**: Add an HTTP/SOCKS5 upstream proxy in the settings panel (Admin -> Proxy Settings), or configure public DNS in `/etc/resolv.conf` (e.g., `nameserver 8.8.8.8`).
|
||||
### 在 VPS 本机使用代理
|
||||
|
||||
The application automatically tries the official HTTPS endpoint, official HTTP endpoint, GitHub Pages HTTPS mirror, GitHub Pages HTTP mirror, and finally the last valid local snapshot. A validated initial snapshot is bundled for first startup. HTTP results remain supported for older systems but do not replace the cache obtained through HTTPS.
|
||||
HTTP、HTTPS 和 SOCKS5 共用默认端口 `127.0.0.1:7928`。HTTPS 网站通过 HTTP 代理的 `CONNECT` 方法访问，因此代理地址仍填写 `http://127.0.0.1:7928`。
|
||||
|
||||
The default mirror is `https://baoweise-bot.github.io/aimili-vpngate/vpngate.csv`. Repository administrators must select **GitHub Actions** as the Pages source under **Settings -> Pages**. The scheduled workflow validates and publishes a fresh snapshot every 15 minutes. Source URLs can be overridden with `VPNGATE_API_HTTPS_URL`, `VPNGATE_API_HTTP_URL`, `VPNGATE_MIRROR_HTTPS_URL`, and `VPNGATE_MIRROR_HTTP_URL`.
|
||||
Shell 环境：
|
||||
|
||||
---
|
||||
```bash
|
||||
export http_proxy="http://127.0.0.1:7928"
|
||||
export https_proxy="http://127.0.0.1:7928"
|
||||
curl https://api.ipify.org
|
||||
```
|
||||
|
||||
### 🎁 Donation Support
|
||||
单次使用 HTTP 代理：
|
||||
|
||||
If you find this project helpful, you can support its development and maintenance via donation:
|
||||
```bash
|
||||
curl -x http://127.0.0.1:7928 https://api.ipify.org
|
||||
```
|
||||
|
||||
* **BNB (BSC / BEP20)**: `0xB6d78c42CEB0687A31B8cfEBE4b51b6eB8953C17`
|
||||
* **TRX (TRC20)**: `TSdzCW6JvsrqcppodYjhSrku4mYmDJ9pxf`
|
||||
单次使用 SOCKS5 代理，并让域名解析也经过代理：
|
||||
|
||||
Thank you for your generosity and support! ❤️
|
||||
```bash
|
||||
curl --proxy socks5h://127.0.0.1:7928 https://api.ipify.org
|
||||
```
|
||||
|
||||
Python `requests` 示例：
|
||||
|
||||
```python
|
||||
import requests
|
||||
|
||||
proxies = {
|
||||
"http": "http://127.0.0.1:7928",
|
||||
"https": "http://127.0.0.1:7928",
|
||||
}
|
||||
|
||||
response = requests.get("https://api.ipify.org", proxies=proxies, timeout=20)
|
||||
print(response.text)
|
||||
```
|
||||
|
||||
### 从电脑或其他设备连接
|
||||
|
||||
代理默认只监听 VPS 回环地址，不直接暴露到公网。推荐使用 SSH 隧道连接，在本地电脑执行：
|
||||
|
||||
```bash
|
||||
ssh -N \
|
||||
-L 8787:127.0.0.1:8787 \
|
||||
-L 7928:127.0.0.1:7928 \
|
||||
root@VPS_IP
|
||||
```
|
||||
|
||||
隧道建立后：
|
||||
|
||||
- Web 后台访问 `http://127.0.0.1:8787/随机安全路径/`。
|
||||
- HTTP/HTTPS 代理填写 `127.0.0.1:7928`。
|
||||
- SOCKS5 代理同样填写 `127.0.0.1:7928`，支持时优先选择远程 DNS 或 `socks5h`。
|
||||
|
||||
请勿在没有访问控制和身份认证的情况下把 `7928` 代理端口直接开放到公网。
|
||||
|
||||
Reference in New Issue
Block a user