LinkMaster Node
LinkMaster 节点服务，用于执行网络测试任务。
功能
- HTTP GET/POST 测试
- Ping 测试
- DNS 查询
- Traceroute 路由追踪
- Socket 连接测试
- TCPing 端口延迟测试
- FindPing IP段批量ping检测
- 持续 Ping/TCPing 测试
- 心跳上报
安装
方式一：一键安装（推荐）
从 GitHub 一键安装，只需指定后端服务器地址。安装脚本会自动克隆源码并编译安装：
# 基本用法（替换为实际的 GitHub 仓库地址）
curl -fsSL https://raw.githubusercontent.com/yourbask/linkmaster-node/main/install.sh | bash -s -- http://your-backend-server:8080
# 示例
# 节点和后端在同一服务器
curl -fsSL https://raw.githubusercontent.com/yourbask/linkmaster-node/main/install.sh | bash -s -- http://localhost:8080
# 节点和后端在不同服务器
curl -fsSL https://raw.githubusercontent.com/yourbask/linkmaster-node/main/install.sh | bash -s -- http://192.168.1.100:8080
重要说明：
- 节点端需要直接连接后端服务器（端口 8080），不是前端地址
- 前端通过
/api路径代理到后端，但节点端不使用代理 - 如果后端在公网，使用公网 IP 或域名
- 如果后端在内网，使用内网 IP
- 本项目是独立的 GitHub 仓库，与前后端项目分离
安装说明：
- 自动检测系统类型和架构
- 自动安装系统依赖（包括 Git 和 Go）
- 从 GitHub 克隆源码到
/opt/linkmaster-node - 自动编译并安装二进制文件
- 自动创建 systemd 服务
- 自动启动服务并验证
指定分支安装：
GITHUB_BRANCH=develop curl -fsSL https://raw.githubusercontent.com/yourbask/linkmaster-node/main/install.sh | bash -s -- http://your-backend-server:8080
方式二：手动编译安装
# 克隆仓库
git clone https://github.com/yourbask/linkmaster-node.git
cd linkmaster-node
# 编译
go build -o agent ./cmd/agent
# 安装（需要root权限）
sudo cp agent /usr/local/bin/linkmaster-node
sudo chmod +x /usr/local/bin/linkmaster-node
# 或使用安装脚本
./install.sh http://your-backend-server:8080
方式三：手动运行
# 克隆仓库
git clone https://github.com/yourbask/linkmaster-node.git
cd linkmaster-node
# 运行（会自动拉取最新代码并编译）
BACKEND_URL=http://your-backend-server:8080 ./run.sh start
配置
环境变量
BACKEND_URL: 后端服务地址（必需，默认: http://localhost:8080）CONFIG_PATH: 配置文件路径（可选，默认: config.yaml）
配置文件（可选）
创建 config.yaml 文件：
server:
port: 2200
backend:
url: http://your-backend-server:8080
heartbeat:
interval: 60
debug: false
运行脚本
使用 run.sh 脚本管理节点端。每次启动时会自动拉取最新代码并重新编译：
# 启动服务（会自动拉取最新代码并编译）
./run.sh start
# 停止服务
./run.sh stop
# 重启服务（会拉取最新代码并重新编译）
./run.sh restart
# 查看状态
./run.sh status
# 查看日志
./run.sh logs
# 查看完整日志
./run.sh logs-all
# 指定后端地址启动
BACKEND_URL=http://192.168.1.100:8080 ./run.sh start
重要提示：
- 启动脚本会自动执行
git pull拉取最新代码 - 拉取代码后会自动执行
go mod download更新依赖 - 然后自动编译生成新的二进制文件
- 如果 Git 拉取失败（如网络问题），会使用当前代码继续编译
- 如果编译失败，服务不会启动
API
POST /api/test
统一测试接口
{
"type": "ceGet|cePost|cePing|ceDns|ceTrace|ceSocket|ceTCPing|ceFindPing",
"url": "测试目标",
"params": {}
}
POST /api/continuous/start
启动持续测试
{
"type": "ping|tcping",
"target": "测试目标",
"interval": 10,
"max_duration": 60
}
POST /api/continuous/stop
停止持续测试
{
"task_id": "任务ID"
}
GET /api/continuous/status?task_id=xxx
查询任务状态
GET /api/health
健康检查