『NodeQuality 代理启动器』发布上线 | 解决国内网络受限、一键运行

在测评国内的小鸡时，运行NodeQuality总会因为无法访问github等地址无法使用。为此，我发布了 NodeQuality-Proxy 代理启动脚本：一个极简、可靠、可在多种网络环境中稳定拉起 NodeQuality 的工具。这个脚本都能让你「一条命令」完成启动。

为什么你需要它

• 网络受限痛点: 直连 GitHub 时常失败、超时。
• 复杂配置门槛: 代理/镜像配置分散且易出错。

核心亮点

• 极简: 约 50 行 Bash，零依赖安装，拿来即用。
• 稳健: 自动验证代理与镜像可用性，失败即停。
• 多通道: 支持 GitHub 镜像、HTTP/SOCKS5 代理、直连。
• 灵活: 参数或环境变量双模式配置，易集成自动化。
• 安全: 临时文件权限收紧、执行后自动清理。

适用场景

• 国内/受限网络快速拉起 NodeQuality

一键开始

推荐国内网络优先使用镜像模式；如有自有代理，使用代理模式；网络畅通可直连。

# 使用 GitHub 镜像
wget -N https://raw.githubusercontent.com/zensea/nodequality-proxy/main/nodequality-proxy.sh && bash nodequality-proxy.sh ghproxy

# 使用本地代理
wget -N https://raw.githubusercontent.com/zensea/nodequality-proxy/main/nodequality-proxy.sh && bash nodequality-proxy.sh proxy http://127.0.0.1:7890

# 直接连接
wget -N https://raw.githubusercontent.com/zensea/nodequality-proxy/main/nodequality-proxy.sh && bash nodequality-proxy.sh

如无法访问 GitHub，可用 GitLab 镜像获取脚本：

# 使用 GitLab 镜像仓库（推荐国内用户）
wget -N https://gitlab.com/dabao/nodequality-proxy/-/raw/main/nodequality-proxy.sh && bash nodequality-proxy.sh ghproxy

日常用法速查

• 方式 1: GitHub 镜像加速

# 使用默认镜像 (https://ghproxy.net/)
bash nodequality-proxy.sh ghproxy

# 使用自定义镜像
bash nodequality-proxy.sh ghproxy https://wget.la
bash nodequality-proxy.sh ghproxy https://hk.gh-proxy.com

• 方式 2: HTTP/SOCKS5 代理

# 使用 HTTP 代理
bash nodequality-proxy.sh proxy http://127.0.0.1:7890

# 使用 SOCKS5 代理
bash nodequality-proxy.sh proxy socks5://127.0.0.1:1080

# 或通过环境变量
export PROXY="http://127.0.0.1:7890"
bash nodequality-proxy.sh proxy

• 方式 3: 直接连接

bash nodequality-proxy.sh

• 方式 4: 环境变量（自动化推荐）

# 设置环境变量
export MIRROR="https://ghproxy.net/"
export PROXY="http://127.0.0.1:7890"

# 直接运行
bash nodequality-proxy.sh

工作原理（放心托付的稳定性）

1. 代理验证 - 通过 `google.com` 验证代理连通性（5秒超时）
2. 镜像验证 - 通过访问 NodeQuality README 验证镜像可用性
3. 脚本下载 - 从 GitHub 或镜像下载 NodeQuality 主脚本
4. URL 替换 - 自动将脚本中的 GitHub URL 替换为镜像地址
5. 安全执行 - 临时文件权限 700，执行后自动清理

高级用法

• 调试输出（排障更透明）

# 查看详细执行过程
bash -x nodequality-proxy.sh ghproxy

• 在自动化脚本中按环境自适应

#!/bin/bash
# 自动化部署脚本

# 检测网络环境
if curl -s --connect-timeout 3 https://github.com >/dev/null 2>&1; then
    # 可以直连
    bash nodequality-proxy.sh
else
    # 使用镜像
    bash nodequality-proxy.sh ghproxy
fi

• 用配置文件统一管理参数

# ~/.nodequality_config
export PROXY="http://127.0.0.1:7890"
export MIRROR="https://ghproxy.net/"

# 使用时
source ~/.nodequality_config
bash nodequality-proxy.sh

命令与环境变量

| 命令 | 参数 | 说明 | 示例 |
|------|------|------|------|
| `ghproxy` | `[镜像地址]` | 使用 GitHub 镜像，可选自定义地址 | `bash nodequality-proxy.sh ghproxy` |
| `proxy` | `` | 使用 HTTP/SOCKS5 代理（必需） | `bash nodequality-proxy.sh proxy http://127.0.0.1:7890` |
| `none` | - | 直接连接，不使用代理 | `bash nodequality-proxy.sh` |
| `help` | - | 显示帮助信息 | `bash nodequality-proxy.sh help` |

| 变量 | 说明 | 示例 |
|------|------|------|
| `PROXY` | HTTP/SOCKS5 代理地址 | `export PROXY="http://127.0.0.1:7890"` |
| `MIRROR` | GitHub 镜像地址 | `export MIRROR="https://ghproxy.net/"` |

兼容性与最低依赖

- ✅ Linux (所有发行版)
- ✅ macOS (Intel & Apple Silicon)
- ✅ Windows (WSL, Git Bash, Cygwin)
- ✅ BSD 系统

- `bash` 3.0 
- `curl`
- `sed`

安全与合规

1. 临时文件安全 - 使用 `chmod 700` 限制权限
2. 自动清理 - 通过 `trap` 确保临时文件自动删除
3. 验证机制 - 执行前验证代理/镜像可用性
4. 错误退出 - 使用 `set -e` 确保异常时立即停止

常见问题

• 代理验证失败时，先本地排查代理是否正常；或暂切镜像模式。

# 检查代理是否正确启动
curl -v -x http://127.0.0.1:7890 https://www.google.com

# 或跳过验证（不推荐）
# 手动编辑脚本，注释掉验证部分

• 镜像验证失败，换其他镜像或改用代理模式：

# 尝试其他镜像
bash nodequality-proxy.sh ghproxy https://wget.la

# 或使用代理方式
bash nodequality-proxy.sh proxy http://127.0.0.1:7890

• 自建镜像遵循前缀拼接规则：

# 直接指定镜像 URL
bash nodequality-proxy.sh ghproxy https://your-mirror.com/

# 镜像格式要求: 在原 URL 前加前缀
# 原始: https://raw.githubusercontent.com/user/repo/file
# 镜像: https://your-mirror.com/https://raw.githubusercontent.com/user/repo/file

获取与参与

• GitHub（项目主页）: https://github.com/zensea/nodequality-proxy
• GitLab（国内镜像）: https://gitlab.com/dabao/nodequality-proxy
• NodeQuality 官方仓库: https://github.com/LloydAsp/NodeQuality

欢迎提交 Issue、PR，或在你的自动化体系中集成使用。如果这个脚本对你有帮助，请 Star 支持！