跳转至

👂 安装 LoadUp

📝 概述

!!!info "注意“ LoadUp 无法在没有 DNS 健康检查组件的情况下运行。

LoadUP 运行监控服务器包含两个独立的安装步骤：

  • loadup-cp/deploy/install.sh：将 LoadUP-CP 和 API-Server 安装到一台 VPS 上。
  • loadup-worker/deploy/install.sh：将 LoadUP-Worker 安装到另一台 VPS 上。

注意

建议将 LoadUP 组件安装到独立的 VPS 服务器上。

  • 不要将 LoadUP-CP 安装到已有的 EdgeHit Controller 或 Load Proxy 节点上，否则会产生端口冲突。
  • 虽然可以将 LoadUP-Worker 安装到 Load Proxy 节点上，但不推荐这么做。

您需要安装一个 LoadUP-CP 实例，以及至少一个 LoadUP-Worker 实例。LoadUP-Worker 设计用于部署在不同的地理区域，以确保从不同地区监控目标节点的可达性。

🪧 安装 LoadUp-CP

  1. 设置环境变量与密钥：

    export REGISTRY_PASSWORD='<密钥>'
export LOADUP_SERVER_DOMAIN='<目标安装服务器的域名>'
export LOADUP_HTTP_AUTH_PASS='<load proxy 中的 http_auth_pass 值>'

    !!!info "注意“ HTTP_AUTH_PASS 是为 LoadUP-CP 中的 Node-Exporter 定义的密码，如果未配置将随机生成。提前定义可选，但建议与 Load Proxy 一致以便接入 Prometheus；这样会将 LoadUP-CP 指标归入同一个作业 node 中，与 Load Proxy 实例共享。

  2. 使用 CURL 运行安装脚本：

    bash -c "$(curl -fsSL https://files.ops2.net/edgehit/test/loadup-cp/deploy/install.sh)"

    • 安装完成后，安装信息与管理工具将保存在 /usr/local/loadup/loadup-cp/ 目录中，内容如下所示：

      loadup-cp/
├──.env
├──install-info.txt
├──compose.yml
├──bin/
│ ├── bash 脚本
│ └── 更多 bash 脚本
│ └── .....

    • .env 文件包含如 JWT 密钥、域名、Node Exporter 密码等配置。

    • install-info.txt 文件包含如默认登录信息、Web 管理面板地址及部分 .env 中的密钥信息。
    • bin/ 目录中包含管理脚本，用于更新和备份等操作。

    安装步骤中包含起始配置教程

    安装 LoadUP-CP 的过程中将自动完成起始配置 ，因为安装 LoadUP-Worker 和 DNS 健康检查器需要预先在 LoadUP-CP 中生成 API Token。


  3. 登录 LoadUP-CP 仪表板（信息见 install-info.txt），进入 Check > Server Group 设置服务器组。
    alt text

  4. 输入服务器组名称，选填描述，点击 保存更改。

    alt text

    Note

    服务器组是标签，用于标识 LoadUP-Worker 所属的地理区域，如 Asia。


  5. 进入 Check > Server 页面，点击 添加 创建新的 Worker。

    alt text

  6. 填写 IP 地址与主机名，选择所属的服务器组后点击 保存更改。

    alt text

  7. 记录该 Worker 的 UUID，对应 LoadUP-Worker 的 .env 文件中的 loadup_worker_api_key。 alt text

  8. 前往 Account > Details 页面，记录 API Token，用于 DNS Healthchecker 的 .env 配置中的 loadup_worker_api_key。

    alt text

    Note

    不要点击 重新生成 API Token，否则会让此前的 API TOKEN 失效，需要重新配置 Worker 与 DNS Healthchecker 的 .env 文件。

LoadUP-CP 安装完毕后，即可继续安装 LoadUp-Worker 及 DNSHealth-Check 模块以组成 DNS 安全检查系统。

👷 安装 LoadUp-Worker

LoadUP-Worker 部署在多个 VPS 上，通过 ICMP 或 HTTP 检查目标状态，并将信息汇报给 LoadUP-CP。

重要

请先完成 LoadUP-CP 安装，记录服务器的 UUID（API Token）后再继续。

  1. 设置环境变量与密钥：

    export REGISTRY_PASSWORD='<密钥>'
export loadup_worker_api_url='<LoadUP-CP 的域名>'
export loadup_worker_api_key='<目标服务器 UUID>'
export loadup_worker_http_auth_pass='<load proxy 中的 http_auth_pass 值>'

    Info

    HTTP_AUTH_PASS 用于 LoadUP-Worker 的 Node Exporter，未配置将随机生成。推荐与 Load Proxy 一致，便于接入 Prometheus（会共享 node job 名）。


  2. 使用 CURL 运行安装脚本：

    bash -c "$(curl -fsSL https://files.ops2.net/edgehit/test/loadup-worker/deploy/install.sh)"

    • 安装完成后信息保存在 /usr/local/loadup/loadup-worker/，目录内容如下：

      loadup-worker/
├──.env
├──install-info.txt
├──compose.yml
├──bin/
│ ├── bash 脚本
│ └── 更多 bash 脚本
│ └── .....

    • .env 文件包含所有配置密钥。

    • install-info.txt 文件记录安装详情。
    • bin/ 目录提供如更新、备份等管理脚本。