NodePilot

🚀 批量服务器管理平台 - 一键部署、批量操作、实时监控、以及各种定制化多联机服务批量处理业务

🤖 本项目由 AI 驱动全自动开发，支持二次迭代，可定制化维护 prompts，实现持续演进的智能化批量服务器管理。

English | 中文

特性
快速开始
架构设计
适用场景
API 参考
开发指南
安全说明
贡献指南
许可证

✨ 特性

🎯 核心能力

批量服务器管理 - 集中管理多台服务器的连接信息
批量脚本执行 - 同时在多台服务器上执行相同的脚本
实时输出回显 - 类似 kubectl logs -f 的实时日志查看
连接状态监控 - 一键测试服务器连接状态（在线/离线/未知）

🔒 安全特性

JWT 认证 - 支持 Access Token (24h) 和 Refresh Token (7天)
用户权限管理 - 基于角色的访问控制 (ROLE_ADMIN / ROLE_USER)
bcrypt 密码哈希 - 用户密码安全存储
AES-256-GCM 加密 - SSH 密码安全存储，不在客户端暴露
会话隔离 - 每个任务独立执行，互不干扰

🚀 性能优势

单端口部署 - 前端嵌入二进制，无需 Nginx/Apache
批量并发执行 - 支持 10 台服务器同时执行（可配置批次大小）
WebSocket 实时推送 - 无需轮询，即时获取执行结果

💻 用户体验

Web UI - 简洁易用的管理界面
一键启动 - 下载即运行，无需复杂配置
跨平台 - 支持 Linux/macOS/Windows
分页支持 - 服务器/脚本/任务列表支持分页浏览

📦 快速开始

二进制下载

# Linux/macOS
进入：https://github.com/gcggcg/node-pilot/releases  下载安装包 node-pilot-linux-amd64.tar.gz
tar -xzf node-pilot-linux-amd64.tar.gz
chmod +x node-pilot

# Windows
# 从 https://github.com/gcggcg/node-pilot/releases 下载

# 运行
./node-pilot --db ./data/servers.db --listen :8080

访问 http://localhost:8080

源码构建 (推荐方案)

环境要求:

Go 1.21+
Node.js 18+ (仅前端开发需要)

克隆仓库

git clone https://github.com/gcggcg/node-pilot.git
cd node-pilot

一键启动脚本

cd node-pilot
chmod +x scripts/start.sh
./scripts/start.sh 0.0.0.0 8080 debug

🏗 架构设计

┌─────────────────────────────────────────────────────────────┐
│                        浏览器端                              │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                      NodePilot 服务端                        │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐ │
│  │  REST API   │  │  WebSocket  │  │   静态资源           │ │
│  │  (Gin)      │  │  (Hub)      │  │   (嵌入式前端)       │ │
│  └─────────────┘  └─────────────┘  └─────────────────────┘ │
│         │                │                    │            │
│         ▼                ▼                    │            │
│  ┌─────────────────────────────────────────┐ │            │
│  │              业务逻辑层                   │ │            │
│  │  ┌─────────────┐  ┌─────────────────┐   │ │            │
│  │  │ SSH 连接池  │  │ 任务执行器       │   │ │            │
│  │  │ (连接管理)  │  │ (异步批量执行)   │   │ │            │
│  │  └─────────────┘  └─────────────────┘   │ │            │
│  └─────────────────────────────────────────┘ │            │
│         │                                      │            │
│         ▼                                      │            │
│  ┌─────────────────────────────────────────┐ │            │
│  │              数据访问层                    │ │            │
│  │              (SQLite)                    │ │            │
│  └─────────────────────────────────────────┘ │            │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                      目标服务器集群                          │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐                  │
│  │ 服务器 1 │  │ 服务器 2 │  │ 服务器 N │  ...             │
│  │ (SSH+SFTP)│  │ (SSH+SFTP)│  │ (SSH+SFTP)│                  │
│  └──────────┘  └──────────┘  └──────────┘                  │
└─────────────────────────────────────────────────────────────┘

技术栈

层级	技术
后端	Go + Gin
前端	Vue 3 + TypeScript + Vite
数据库	SQLite (嵌入式)
认证	JWT (golang-jwt/jwt)
密码哈希	bcrypt
SSH	golang.org/x/crypto/ssh
WebSocket	gorilla/websocket
密码加密	AES-256-GCM

💡 适用场景

1. 微服务组件集群一键搭建

# 创建微服务部署脚本列表
#!/bin/bash
cd /opt/myapp
git pull origin main
docker-compose up -d --build

# 在 NodePilot UI 中选择 10 台服务器
# 一键在所有服务器上执行该脚本

2. OpenClaw 小龙虾集群一键搭建

#!/bin/bash
# 一键初始化集群
apt-get update && apt-get install -y docker.io
docker pull openclust/node:latest
docker run -d --name master openclust/node --role=master

3. AI 编程环境集群一键搭建

#!/bin/bash
# 安装 OpenCode AI 开发环境
curl -fsSL https://setup.opencode.com | bash
opencode config set api-key your-key

4. 系统批量维护

#!/bin/bash
# 批量系统更新
apt-get update && apt-get upgrade -y
docker system prune -f
journalctl --vacuum-time=7d

5. 定制化批量服务处理

🌐 API 参考

认证管理

⚠️ 认证接口需要携带 Authorization: Bearer <access_token> 头（Refresh Token 接口除外）

方法	端点	说明	认证
POST	`/api/v1/auth/login`	用户登录	否
GET	`/api/v1/auth/me`	获取当前用户信息	✅
POST	`/api/v1/auth/refresh`	刷新 Token	否
PUT	`/api/v1/auth/profile`	更新个人信息	✅
PUT	`/api/v1/auth/password`	修改密码	✅

登录请求：

POST /api/v1/auth/login
{
  "username": "root",
  "password": "root"
}

登录响应：

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 86400
}

用户管理

⚠️ 仅管理员 (ROLE_ADMIN) 可访问

方法	端点	说明	认证
GET	`/api/v1/admin/users`	获取用户列表	✅ + ADMIN
POST	`/api/v1/admin/users`	创建用户	✅ + ADMIN
DELETE	`/api/v1/admin/users/:id`	删除用户	✅ + ADMIN
POST	`/api/v1/admin/users/batch-delete`	批量删除用户	✅ + ADMIN

服务器管理

方法	端点	说明	分页支持
GET	`/api/servers`	获取服务器列表	✅
GET	`/api/servers/:id`	获取服务器详情
POST	`/api/servers`	创建服务器
PUT	`/api/servers/:id`	更新服务器
DELETE	`/api/servers/:id`	删除服务器
POST	`/api/servers/:id/test`	测试连接
POST	`/api/servers/batch-delete`	批量删除

脚本管理

方法	端点	说明	分页支持
GET	`/api/scripts`	获取脚本列表	✅
GET	`/api/scripts/:id`	获取脚本详情
POST	`/api/scripts`	创建脚本
PUT	`/api/scripts/:id`	更新脚本
DELETE	`/api/scripts/:id`	删除脚本
POST	`/api/scripts/batch-delete`	批量删除

任务管理

方法	端点	说明	分页支持
GET	`/api/tasks`	获取任务列表	✅
GET	`/api/tasks/:id`	获取任务详情
POST	`/api/tasks`	创建并执行任务
DELETE	`/api/tasks/:id`	取消任务
POST	`/api/tasks/batch-delete`	批量删除
GET	`/api/tasks/:id/output`	SSE 实时输出流

分页参数

列表接口支持分页查询，参数通过 URL query 传递：

参数	类型	默认值	说明
`page`	int	1	页码
`pageSize`	int	10	每页条数

分页响应格式：

{
  "data": [
    ...
  ],
  "total": 100,
  "page": 1,
  "pageSize": 10
}

WebSocket

ws://localhost:8080/ws?task_id=123

消息类型:

task_start - 任务开始执行
server_start - 开始在服务器上执行
output - 实时输出
server_done - 单服务器执行完成
task_done - 全部服务器执行完成

🔧 开发指南

项目结构

node-pilot/
├── backend/
│   ├── cmd/server/
│   │   └── main.go           # 程序入口
│   ├── internal/
│   │   ├── auth/            # JWT 认证工具
│   │   ├── config/          # 配置管理
│   │   ├── handler/          # HTTP 处理器
│   │   │   ├── auth.go      # 认证相关处理器
│   │   │   └── user.go      # 用户管理处理器
│   │   ├── middleware/       # Gin 中间件
│   │   │   └── auth.go      # JWT 认证中间件
│   │   ├── model/            # 数据模型
│   │   ├── repository/       # 数据库操作
│   │   ├── service/          # 业务逻辑
│   │   │   ├── ssh.go       # SSH 连接池
│   │   │   └── task.go      # 任务执行器
│   │   └── websocket/        # WebSocket Hub
│   ├── web/                   # 嵌入式前端
│   └── data/                  # SQLite 数据库
├── frontend/
│   └── src/
│       ├── api/              # API 调用封装
│       ├── components/       # Vue 组件 (含 Pagination.vue)
│       ├── router/           # Vue Router + 路由守卫
│       ├── stores/           # Pinia 状态管理 (含 auth store)
│       ├── views/            # 页面视图 (含 Login, UserList, Profile)
│       └── types/            # TypeScript 类型
├── docs/
│   ├── plan/                 # 任务计划文档
│   └── review/               # 代码审查报告
└── scripts/
    └── start.sh             # 启动脚本

环境变量

变量	默认值	说明
`NODE_PILOT_DB`	`./data/servers.db`	数据库路径
`NODE_PILOT_LISTEN`	`:8080`	监听地址
`NODE_PILOT_KEY`	(自动生成)	AES 加密密钥 (32字节)
`JWT_SECRET`	(内置默认)	JWT 签名密钥 (生产环境必须设置)
`ROOT_PASSWORD`	`root`	Root 用户初始密码 (首次部署设置)

运行测试

# 后端测试
cd backend
go test ./...

# 前端测试
cd frontend
npm test

🔒 安全说明

认证机制

系统采用 JWT (JSON Web Token) 进行身份认证：

Access Token - 有效期 24 小时，用于 API 访问认证
Refresh Token - 有效期 7 天，用于自动续期
密码存储 - 用户密码使用 bcrypt 哈希存储
敏感信息 - SSH 密码使用 AES-256-GCM 加密存储

// JWT Claims 结构
type Claims struct {
UserID   int64  `json:"user_id"`
Username string `json:"username"`
Role     string `json:"role"` // ROLE_ADMIN or ROLE_USER
}

最佳实践

JWT Secret - 生产环境必须设置 JWT_SECRET 环境变量
Root 密码 - 首次部署后立即修改 root 默认密码
数据库权限 - 设置数据库文件权限为 600
网络隔离 - 仅在内网环境使用
SSH 密钥 - 生产环境建议使用 SSH 密钥认证替代密码
加密密钥 - 生产环境使用随机生成的强密钥

默认账户

用户名	密码	角色
root	root	ROLE_ADMIN

🤝 贡献指南

欢迎提交 Issue 和 Pull Request！请在提交前阅读贡献指南。

开发环境搭建

# Fork 并克隆仓库
git clone https://github.com/gcggcg/node-pilot.git

# 创建功能分支
git checkout -b feature/your-feature-name

# 修改代码并测试
go test ./...
npm test

# 提交并推送
git commit -m "feat: 添加新功能"
git push origin feature/your-feature-name

# 创建 Pull Request

代码规范

Go: 遵循 Go 编码规范
JavaScript/TypeScript: 遵循项目 ESLint 配置

📄 许可证

MIT 许可证 - 详见 LICENSE 文件。

🙏 致谢

gin-gonic/gin - 高性能 HTTP Web 框架
golang-jwt/jwt - JWT 实现
golang.org/x/crypto - SSH 和加密库
vuejs/core - 渐进式 JavaScript 框架

使用 ❤️ 开发 | 光之翼

Name		Name	Last commit message	Last commit date
Latest commit History 103 Commits
.github/workflows		.github/workflows
backend		backend
docs		docs
frontend		frontend
prompts		prompts
scripts		scripts
.gitignore		.gitignore
README.md		README.md
依赖库.md		依赖库.md

Folders and files

Latest commit

History

Repository files navigation

NodePilot

✨ 特性

🎯 核心能力

🔒 安全特性

🚀 性能优势

💻 用户体验

📦 快速开始

二进制下载

源码构建 (推荐方案)

克隆仓库

一键启动脚本

🏗 架构设计

技术栈

💡 适用场景

1. 微服务组件集群一键搭建

2. OpenClaw 小龙虾集群一键搭建

3. AI 编程环境集群一键搭建

4. 系统批量维护

5. 定制化批量服务处理

🌐 API 参考

认证管理

用户管理

服务器管理

脚本管理

任务管理

分页参数

WebSocket

🔧 开发指南

项目结构

环境变量

运行测试

🔒 安全说明

认证机制

最佳实践

默认账户

🤝 贡献指南

开发环境搭建

代码规范

📄 许可证

🙏 致谢

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases 2

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages