https://github.com/vag-zhao/device-net-tracker
远程监控客户机的网络连接，支持断开并忘记已连接WiFi信息（暂未开发处理以太网功能）
https://github.com/vag-zhao/device-net-tracker
electron javascript typescript vue3 websocket
Last synced: 2 months ago
JSON representation
远程监控客户机的网络连接，支持断开并忘记已连接WiFi信息（暂未开发处理以太网功能）
- Host: GitHub
- URL: https://github.com/vag-zhao/device-net-tracker
- Owner: vag-Zhao
- License: mit
- Created: 2025-02-18T11:48:03.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-18T12:02:52.000Z (over 1 year ago)
- Last Synced: 2025-05-18T04:12:33.476Z (about 1 year ago)
- Topics: electron, javascript, typescript, vue3, websocket
- Language: TypeScript
- Homepage:
- Size: 183 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
设备监控系统
这是一个基于 Electron 和 WebSocket 的设备监控系统，包含客户端和服务器端两个部分。
系统可以实时监控设备状态、网络连接情况，并提供远程 WiFi 管理功能。
---
## 目录
- [系统架构](#系统架构)
- [技术栈](#技术栈)
- [客户端](#客户端)
- [服务器端](#服务器端)
- [系统特性](#系统特性)
- [安全性设计](#安全性设计)
- [性能优化](#性能优化)
- [客户端优化](#客户端优化)
- [服务器端优化](#服务器端优化)
- [部署指南](#部署指南)
- [环境要求](#环境要求)
- [配置说明](#配置说明)
- [部署步骤](#部署步骤)
- [防火墙配置](#防火墙配置)
- [验证部署](#验证部署)
- [开发规范](#开发规范)
- [更新日志](#更新日志)
- [贡献指南](#贡献指南)
- [许可证](#许可证)
---
## 系统架构
```mermaid
graph TB
subgraph 客户端[客户端 ET]
A1[Electron 主进程] --> B1[系统托盘]
A1 --> B2[WebSocket 客户端]
A1 --> B3[设备信息采集]
A1 --> B4[WiFi 管理]
B3 --> C1[序列号]
B3 --> C2[网络接口]
B3 --> C3[WiFi 状态]
end
subgraph 服务器[服务器端 ET-SERVER]
D1[Express 服务器] --> E1[WebSocket 服务器]
D1 --> E2[MongoDB 数据库]
D1 --> E3[RESTful API]
D1 --> E4[认证系统]
E1 --> F1[设备连接管理]
E1 --> F2[实时状态更新]
E2 --> F3[设备信息存储]
E3 --> F4[设备管理接口]
end
B2 <--> E1
style 客户端 fill:#ecf0f1,stroke:#bdc3c7
style 服务器 fill:#ecf0f1,stroke:#bdc3c7
```
## 技术栈
### 客户端
- Electron 28.0.0
- TypeScript 5.7.3
- WebSocket (ws)
- Windows Native API
### 服务器端
- Node.js 14+
- Express 4.21.2
- MongoDB 4.4+
- WebSocket (ws)
- JWT 认证
## 系统特性
| 特性 | 描述 |
|------|------|
| 🔒 安全认证 | 基于 JWT 的身份验证和授权 |
| 🔄 实时监控 | WebSocket 实现设备状态实时更新 |
| 📡 网络管理 | 远程 WiFi 配置和管理功能 |
| 💾 数据持久化 | MongoDB 存储设备信息和历史记录 |
## 安全性设计
```mermaid
flowchart TD
A[客户端请求] --> B{JWT 验证}
B -->|验证通过| C[访问资源]
B -->|验证失败| D[拒绝访问]
C --> E{权限检查}
E -->|允许| F[执行操作]
E -->|禁止| G[返回错误]
```
## 📈 性能优化
### 客户端优化
- 使用 TypeScript 提升代码质量
- 实现单实例锁防止重复启动
- 资源使用优化和内存管理
- 自动重连机制
### 服务器端优化
- 数据库索引优化
- 连接池管理
- 错误处理和日志记录
- 定时清理离线设备
## 部署指南
### 环境要求
组件
最低要求
推荐配置
操作系统
Windows 10
Windows 10/11
Node.js
14.x
16.x 或更高
MongoDB
4.4
5.0 或更高
内存
4GB
8GB 或更高
### 配置说明
#### 1. 数据库配置
在 `et-server/src/config/database.ts` 文件中配置您的 MySQL连接信息：
```typescript
export const dbConfig = {
host: 'your-mongodb-host', // MongoDB 服务器地址
port: 3307, // MongoDB 端口
user: 'your-username', // 数据库用户名
password: 'your-password', // 数据库密码
database: 'your-database', // 数据库名称
// ... 其他配置保持不变
};
```
#### 2. 服务器配置
创建 `et-server/src/config/server.ts` 文件：
```typescript
export const serverConfig = {
port: 3000, // 服务器端口
jwtSecret: 'your-jwt-secret', // JWT 密钥
corsOrigin: '*', // CORS 配置
wsPort: 8080 // WebSocket 端口
};
```
#### 3. 客户端配置
在 `et/src/config/app.ts` 中配置服务器连接信息：
```typescript
export const appConfig = {
serverUrl: 'http://your-server-ip:3000',
wsUrl: 'ws://your-server-ip:8080',
// ... 其他配置
};
```
### 部署步骤
#### 服务器端部署
1. 安装 MongoDB
```bash
# Ubuntu/Debian
sudo apt update
sudo apt install -y mongodb
# CentOS
sudo yum install -y mongodb-org
```
2. 启动 MongoDB 服务
```bash
sudo systemctl start mongod
sudo systemctl enable mongod
```
3. 部署服务器应用
```bash
cd et-server
# 安装依赖
npm install
# 编译 TypeScript
npm run build
# 使用 PM2 启动服务
npm install -g pm2
pm2 start dist/app.js --name et-server
```
#### 客户端部署
1. 安装依赖并构建
```bash
cd et
npm install
npm run build
```
2. 打包应用
```bash
# Windows
npm run package:win
# macOS
npm run package:mac
```
### 防火墙配置
确保以下端口已开放：
- 3000: REST API
- 8080: WebSocket
- 3307: MySQL
```bash
# Ubuntu/Debian
sudo ufw allow 3000
sudo ufw allow 8080
sudo ufw allow 3307
# CentOS
sudo firewall-cmd --permanent --add-port=3000/tcp
sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --permanent --add-port=3307/tcp
sudo firewall-cmd --reload
```
### 验证部署
1. 检查服务器状态
```bash
curl http://your-server-ip:3000/health
```
2. 检查 WebSocket 连接
```bash
wscat -c ws://your-server-ip:8080
```
## 开发规范
### Git 提交规范
类型
说明
🎯 feat
新功能
🐛 fix
修复问题
📚 docs
文档更新
🎨 style
代码格式
♻️ refactor
代码重构
✅ test
测试相关
🔧 chore
构建/工具
## 更新日志
### v1.0.0 (2024-01-20)
- ✨ 初始版本发布
- 🔒 完善认证系统
- 🔧 优化设备管理
- 📡 增强网络功能
## 贡献指南
1. Fork 项目
2. 创建特性分支
3. 提交更改
4. 推送到分支
5. 创建 Pull Request
## 📄 许可证
---
Built with ❤️ by zgs3344