🧩 NodeQuality-Proxy：一条命令在受限网络中启动 NodeQuality

💡 为什么你需要它

在国内运行 NodeQuality 测评时，经常遇到：

• 🚫 无法访问 GitHub，下载脚本失败；

• ⚙️ 各类代理、镜像配置繁琐易出错；

• ⏱️ 启动过程复杂，自动化难以集成。

NodeQuality-Proxy 是一个极简、可靠的代理启动脚本，让你在任何网络环境下「一条命令」拉起 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

🇨🇳 GitLab 镜像（推荐国内用户）

wget -N https://gitlab.com/dabao/nodequality-proxy/-/raw/main/nodequality-proxy.sh && bash nodequality-proxy.sh ghproxy

🧭 日常用法速查

方式 1：GitHub 镜像

bash nodequality-proxy.sh ghproxy              # 默认镜像 (https://ghproxy.net/)
bash nodequality-proxy.sh ghproxy https://wget.la
bash nodequality-proxy.sh ghproxy https://hk.gh-proxy.com

方式 2：HTTP / SOCKS5 代理

bash nodequality-proxy.sh proxy http://127.0.0.1:7890
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 或镜像拉取主脚本。

4. URL 替换：自动替换原脚本中的 GitHub URL。

5. 安全执行：权限设为 700，执行完成后清理临时文件。

🧩 高级用法

自动化检测网络环境

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

📘 命令与环境变量速览

🧰 兼容性与依赖

• ✅ Linux / macOS / 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
  

• 自建镜像规则：
  在原 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！