ghcr.io/gituib/idc-backend:latest

IDC设备资产管理系统

现代化数据中心（IDC）设备管理系统，提供机房、机柜、设备的全生命周期管理，具备3D可视化展示功能。

GitHub: Gitee:

---

目录

• IDC设备资产管理系统
• 功能特性
• 项目截图
• 快速开始
• Linux一键部署
• Windows部署
• 手动安装
• 环境要求
• 生产环境额外要求
• 脚本命令参考
• install.js - 安装脚本
• update.js - 更新脚本
• uninstall.js - 卸载脚本
• 部署指南
• 生产环境
• Nginx配置
• 系统维护
• 服务管理
• 日志查看
• 数据备份
• 常见问题
• 项目结构
• API文档
• 贡献指南
• 许可证

---

功能特性

项目截图

点击展开查看截图

数据看板 - 实时监控数据中心运行状态

3D机柜可视化 - 三维展示机柜设备布局

机房管理 - 多机房分类管理

设备管理 - 设备全生命周期管理

工单管理 - 故障报修与维护工单处理

数据备份 - 数据库备份与恢复管理

---

快速开始

Docker部署（推荐）

适用于新服务器上快速部署，无需安装Node.js等运行时环境，只需Docker即可。

详细教程：Docker部署指南

架构：3个容器（Nginx + 前端静态文件 | Backend | MySQL），通过Docker Compose编排。

• Nginx容器：提供前端静态页面 + 反向代理/api到后端
• Backend容器：Node.js Express应用，端口8000
• MySQL容器：数据库，数据持久化到Docker卷

访问地址：http://服务器IP 首次使用：注册页面注册的第一个账号自动成为管理员

Linux一键部署

# 克隆项目
git clone https://gitee.com/zhang96110/idc_assest.git
cd idc_assest

# 运行安装脚本（自动安装Node.js）
./install.sh

# 或一键安装（无需克隆）
curl -fsSL https://gitee.com/zhang96110/idc_assest/raw/main/install.sh | bash

install.sh自动完成：

• 自动检测Linux发行版（Ubuntu/Debian/CentOS/Arch）
• 自动安装Node.js 20.x
• 自动安装系统依赖（git、curl）
• 调用install.js完成后续安装

Windows部署

# 克隆项目
git clone https://gitee.com/zhang96110/idc_assest.git
cd idc_assest

# 运行安装脚本（需要先安装Node.js）
node install.js

# 或使用npm
npm run deploy

手动安装

# 1. 克隆项目
git clone https://gitee.com/zhang96110/idc_assest.git
cd idc_assest

# 2. 安装依赖
npm run install:all

# 3. 配置环境变量
cp backend/.env.example backend/.env

# 4. 配置JWT密钥（必填）
# 编辑backend/.env，设置JWT_SECRET为强随机字符串
# 生成命令：openssl rand -hex 64（Linux/macOS）
# 或：node -e "console.log(require('crypto').randomBytes(64).toString('hex'))"

# 5. 初始化数据库
cd backend && node scripts/init-database.js

# 6. 启动服务
cd .. && npm start

访问地址： 默认账号：首次注册自动成为管理员

---

环境要求

生产环境额外要求：

---

脚本命令参考

install.js - 安装脚本

# 交互式安装
node install.js

# 非交互式安装
node install.js -y

# 指定数据库类型
node install.js -y --db=mysql # 使用MySQL
node install.js -y --db=sqlite # 使用SQLite（默认）

# 指定端口
node install.js -y --port=8000 # 后端端口

# 跳过前端构建
node install.js -y --skip-build

# 跳过Nginx配置
node install.js -y --skip-nginx

# 查看帮助
node install.js --help

update.js - 更新脚本

# 交互式更新
node update.js

# 模拟运行（不执行实际操作）
node update.js --dry-run

# 跳过某些步骤
node update.js --skip-git # 跳过Git拉取
node update.js --skip-backup # 跳过数据库备份
node update.js --skip-migrate # 跳过数据库迁移
node update.js --skip-build # 跳过前端构建
node update.js --skip-deps # 跳过依赖安装
node update.js --skip-restart # 跳过服务重启

# 强制执行（忽略锁文件）
node update.js --force

# 查看帮助
node update.js --help

智能检测功能：

• 依赖安装智能跳过（检测package.json变化）
• 前端构建智能跳过（检测源码变化）
• 数据库自动备份（支持回滚）
• 健康检查验证
• 日志持久化保存到logs/update_*.log
• 锁机制防止重复运行

uninstall.js - 卸载脚本

# 交互式卸载
node uninstall.js

# 强制卸载（无需确认）
node uninstall.js --force

# 卸载前自动备份数据库
node uninstall.js --backup

# 跳过某些步骤
node uninstall.js --skip-db # 跳过数据库删除
node uninstall.js --skip-deps # 跳过依赖删除
node uninstall.js --skip-uploads # 跳过上传文件删除

# 预览模式（不实际执行）
node uninstall.js --dry-run

# 查看帮助
node uninstall.js --help

---

部署指南

生产环境

生产环境部署只需运行./install.sh或node install.js，脚本会自动完成所有配置。

仅需提前准备MySQL数据库（如使用MySQL）：

-- 创建数据库
CREATE DATABASE idc_management CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- 创建用户
CREATE USER 'idc_user'@'localhost' IDENTIFIED BY 'YourStrongPassword';
GRANT ALL PRIVILEGES ON idc_management.* TO 'idc_user'@'localhost';
FLUSH PRIVILEGES;

服务器要求参考：

Nginx配置

install.js会自动配置Nginx。配置文件位于deploy/nginx-idc.conf，核心配置如下：

server {
listen 80;
server_name your-domain.com;

client_max_body_size 100M;

root "/var/www/idc";
index index.html;

# Gzip压缩
gzip on;
gzip_vary on;
gzip_min_length 1024;
gzip_proxied any;
gzip_comp_level 6;
gzip_types text/plain text/css text/xml text/javascript application/javascript application/xml+rss application/json application/x-javascript image/svg+xml;

# 静态资源缓存（1年）
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot|hdr)$ {
expires 1y;
add_header Cache-Control "public, immutable";
try_files $uri =404;
}

# API代理
location /api/ {
proxy_pass http://127.0.0.1:8000/api/;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_connect_timeout 60s;
proxy_send_timeout 60s;
proxy_read_timeout 300s;
proxy_buffering off;
}

# 文件上传代理
location /uploads/ {
proxy_pass http://127.0.0.1:8000/uploads/;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
client_max_body_size 100M;
}

# 前端路由（SPA）
location / {
try_files $uri $uri/ /index.html =404;
}
}

启用配置：

# Ubuntu/Debian
sudo cp deploy/nginx-idc.conf /etc/nginx/sites-available/idc
sudo ln -sf /etc/nginx/sites-available/idc /etc/nginx/sites-enabled/idc
sudo rm -f /etc/nginx/sites-enabled/default
sudo nginx -t && sudo nginx -s reload

---

系统维护

服务管理

# PM2服务
pm2 status # 查看状态
pm2 logs idc-backend # 查看日志
pm2 restart idc-backend # 重启服务
pm2 stop idc-backend # 停止服务
pm2 delete idc-backend # 删除服务
pm2 save # 保存配置
pm2 startup # 开机自启

# Nginx
sudo nginx -t # 测试配置
sudo nginx -s reload # 重载配置
sudo systemctl restart nginx # 重启服务

日志查看

# PM2日志
pm2 logs idc-backend
pm2 logs idc-backend --err # 仅错误日志

# Nginx日志
sudo tail -f /var/log/nginx/error.log

# 应用日志
tail -f backend/logs/*.log

数据备份

# 内置备份
# 系统管理 → 备份管理 → 创建备份

# 命令行备份
cd backend && node scripts/backup.js

# 还原
cd backend && node scripts/restore.js

---

常见问题

1. 端口冲突（8000、3000、80）

# 检查端口占用（Linux）
netstat -tulpn | grep :8000

# Windows
netstat -ano | findstr :8000

# 方案1：修改端口（编辑backend/.env）
PORT=8001

# 方案2：停止占用进程
sudo kill $(lsof -t -i:8000)

2. 502 Bad Gateway

3. 检查后端服务：pm2 status

4. 检查端口监听：netstat -tulpn | grep 8000

5. 检查Nginx配置：nginx -t

6. 查看错误日志：tail /var/log/nginx/error.log

7. 前端构建失败

# 检查Node.js版本
node -v # 需要≥18.x

# 清理并重试
cd frontend
rm -rf node_modules dist
npm install
npm run build

4. 数据库连接失败

MySQL：

• 检查服务状态：sudo systemctl status mysql
• 验证连接参数（主机、端口、用户名、密码）
• 确认数据库已创建：SHOW DATABASES;
• 检查用户权限：SHOW GRANTS FOR 'idc_user'@'localhost';

5. 权限问题

# 修复文件权限
sudo chown -R $(whoami):$(whoami) /path/to/idc_assest

# 上传目录权限
sudo chmod -R 777 backend/uploads

6. 内存不足

# 增加内存限制（编辑ecosystem.config.js）
node_args: "--max-old-space-size=4096"

# 或命令行
pm2 restart idc-backend --update-env

7. npm安装失败

# 清理缓存
npm cache clean --force

# 删除后重装
rm -rf node_modules package-lock.json
npm install

8. PM2服务消失

# 重新启动
pm2 start ecosystem.config.js
pm2 save
pm2 startup

---

项目结构

idc_assest/
├── frontend/ # 前端项目
│ ├── src/
│ │ ├── api/ # API接口
│ │ ├── components/ # 组件（3d/、dashboard/、device/、floorplan/）
│ │ ├── pages/ # 页面
│ │ ├── hooks/ # 自定义Hooks
│ │ ├── stores/ # 状态管理
│ │ └── utils/ # 工具函数
│ └── package.json
├── backend/ # 后端项目
│ ├── models/ # Sequelize数据模型
│ ├── routes/ # API路由
│ ├── middleware/ # 中间件
│ ├── scripts/ # 数据库脚本（init-database.js、migrate-all.js）
│ ├── utils/ # 工具函数
│ ├── uploads/ # 上传文件目录
│ ├── server.js # 服务入口
│ └── package.json
├── deploy/ # 部署配置
│ ├── ecosystem.config.js # PM2配置
│ └── nginx-idc.conf # Nginx配置
├── install/ # 安装脚本模块
├── docs/ # 项目文档
├── install.sh # Linux安装引导脚本
├── install.js # 安装脚本入口
├── update.js # 更新脚本
├── uninstall.js # 卸载脚本
└── README.md # 本文件

---

API文档

完整交互式API文档访问：** **

基于Swagger/OpenAPI 3.0标准，支持在线认证测试和API调试。

---

贡献指南

欢迎提交Issue或Pull Request！

# 1. Fork本项目

# 2. 克隆你的Fork
git clone https://github.com/YOUR_USERNAME/idc_assest.git
cd idc_assest

# 3. 创建分支
git checkout -b feature/your-feature # 功能开发
git checkout -b fix/your-fix # Bug修复

# 4. 开发并提交
git commit -m 'feat: 添加新功能'
git commit -m 'fix: 修复问题'

# 5. 推送并创建PR
git push origin feature/your-feature

提交信息规范：

开发规范：

• 使用ES6+语法
• 遵循React Hooks规范
• 使用async/await处理异步
• 遵循ESLint + Prettier代码规范

---

许可证

本项目基于MIT许可证开源。

---

⭐ 如果这个项目对您有帮助，请给我们一个Star！

• Gitee Issues:
• GitHub Issues:
• QQ群：***