ghcr.io/gituib/idc-backend:bab8abb

IDC设备资产管理系统

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

GitHub: Gitee:

---

📖 查看完整文档教程 →

包含安装部署、配置说明、使用指南等全部教程

---

目录

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

---

---

快速开始

Docker 部署（推荐）

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

📖 详细教程请查看文档站：https://gitee.com/zhang96110/idc_assest-docs/deploy/docker-deploy.html

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

---

环境要求

生产环境额外要求：

---

脚本命令参考

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:
• ：