GoEdge自动化添加节点脚本
goedge_add_node.sh | ||
LICENSE | ||
README.md |
go-edge-shell
本脚本用于在 GoEdgeCDN 上自动完成以下操作:
- 获取 Token(调用 /APIAccessTokenService/getAPIAccessToken)
- 创建节点(调用 /NodeService/createNode),其中 nodeLogin.params 等 bytes 类型字段会自动做 Base64 编码
- 批量添加 IP(调用 /NodeIPAddressService/createNodeIPAddresses)
- 获取节点信息(调用 /NodeService/findEnabledNode)
- 安装节点(调用 /NodeService/installNode)
- 新增安装节点时默认采用从本仓库下载edge-node,如果失败请在最后加上
--webinstall
采用webapi进行从你的edgecdn管理站拉取安装脚本
如果调用脚本时没有指定节点名称 --name,则会自动使用 “<本机IPv4>(YYYY-MM-DD)” 作为名称。 另外,支持通过 --grantid 参数来自定义 grantId,若不指定则默认为 1。
使用方法
curl -o goedge_add_node.sh https://git.randallanjie.com/Randall/go-edge-shell/raw/branch/main/goedge_add_node.sh
chmod +x goedge_add_node.sh
./goedge_add_node.sh \
--acid 12345 \
--ackey 1234567890 \
--clusterid 2 \
--name "测试节点" \
--grantid 5 \
--http-api https://api.randallanjie.com \
--api-host https://rpc1.randallanjie.com https://rpc2.randallanjie.com
- --http-api:必填,脚本本身通过此地址与后端进行 HTTP 调用
- --api-host:可多填,用于节点自身的 rpc.endpoints 配置写入 api_node.yaml。节点启动后将自行与这些 RPC 地址通信
若需要使用后端 WebAPI 来安装 edge-node,可在以上命令后面加上 --webinstall,即:
./goedge_add_node.sh ... --webinstall
这样脚本会跳过本地解压步骤,直接调用后端 /NodeService/installNode。
参数说明
参数名 | 是否必填 | 说明 | 示例 |
---|---|---|---|
--acid | 是 | Access Key ID | --acid 12345 |
--ackey | 是 | Access Key | --ackey 1234567890 |
--clusterid | 是 | 节点所属的集群 ID | --clusterid 2 |
--http-api | 是 | 脚本本身调用HTTP接口时使用的主地址 | --http-api https://api.randallanjie.com |
--api-host | 否 | 节点自身 RPC endpoints 配置,可多填,用空格分隔,写入 rpc.endpoints (如 --api-host https://rpc1 ...) | --api-host https://rpc1 ... https://rpc2 ... |
--grantid | 否 | SSH 的 grantId,用于 nodeLogin.params;默认 1 | --grantid 5 |
--name | 否 | 节点名称,若不指定则自动使用「<本机IPv4>(YYYY-MM-DD)」格式 | --name MyNode |
特性
-
自动安装依赖 如 curl, jq, base64, unzip 等命令不存在,脚本会自动尝试通过 apt-get / yum / dnf / zypper / apk 安装它们(Alpine适配)。
-
Base64 编码 脚本会自动对 nodeLogin.params 中的 JSON 内容进行 Base64 编码,以适配 GoEdge 后端对 bytes 字段的要求。
-
自动命名 当不指定 --name 时,脚本会自动以 “本机IPv4 + 当前日期” 组合作为节点名称。
-
多地址支持 可通过 --api-host 传多个 RPC 地址(用空格分隔),写入节点配置文件 api_node.yaml。
-
一站式调用 本脚本包含创建节点、批量添加 IP、安装节点等操作,一次执行完成
适用环境
- Linux 发行版:如 Ubuntu、Debian、CentOS、Rocky Linux、Alma Linux、OpenSUSE、Alpine 等
- Shell:需要常见的 Bash 环境
- 依赖命令:curl, jq, base64, unzip。脚本中已实现自动安装逻辑,但需具备相应的包管理器(apt-get, yum, dnf, zypper 或 apk)