Files
makemd/node-agent
wurenzhi c932a67be2 feat: 实现前端组件库和API服务基础架构
refactor: 移除废弃的AGI策略演进服务

fix: 修正磁盘I/O指标字段命名

chore: 更新项目依赖版本

test: 添加前后端集成测试用例

docs: 更新AI模块接口文档

style: 统一审计日志字段命名规范

perf: 优化Redis订阅连接错误处理

build: 配置多项目工作区结构

ci: 添加Vite开发服务器CORS支持
2026-03-18 15:22:55 +08:00
..

Node Agent - 节点代理

📋 项目简介

Node Agent 是 Crawlful Hub 的节点代理,用于在分布式环境中执行任务,实现多节点协作和负载均衡。

🚀 核心功能

1. 任务执行

  • 执行分配的任务
  • 任务状态管理
  • 任务结果上报

2. 节点管理

  • 节点注册与发现
  • 节点健康检查
  • 节点负载均衡

3. 数据同步

  • 与中心服务同步数据
  • 本地缓存管理
  • 数据一致性保证

4. 安全通信

  • 加密通信
  • 身份验证
  • 权限控制

🏗 技术栈

  • 框架: Node.js
  • 语言: TypeScript
  • 通信: Socket.io
  • 安全: TLS/SSL

📦 快速开始

环境要求

  • Node.js 16+

安装依赖

cd node-agent
npm install

配置环境变量

创建 .env 文件,配置以下环境变量:

# 服务器配置
PORT=3004

# 中心服务配置
CENTRAL_SERVER_URL=http://localhost:3003

# 节点配置
NODE_ID=node-1
NODE_NAME=Node 1
NODE_TYPE=worker

# 安全配置
API_KEY=your_api_key

启动服务

# 开发模式
npm run dev

# 生产模式
npm run build
npm start

📁 项目结构

node-agent/
├── src/
│   ├── index.ts         # 主入口
│   └── main.ts          # 主要逻辑
├── package.json         # 项目配置
├── tsconfig.json        # TypeScript 配置
└── README.md            # 项目说明

🔧 开发规范

代码规范

  • 遵循 TypeScript 最佳实践
  • 使用 ESLint 进行代码检查
  • 文件命名使用 PascalCase

提交规范

  • 提交信息使用中文描述
  • 提交前确保代码通过测试
  • 大型功能提交前创建分支

🤝 贡献

欢迎贡献代码和提出建议!请先阅读项目文档,然后提交 Pull Request。