ghcr.io/gituib/idc-backend

ghcr.io/gituib/idc-backend:latest

ghcr.iolinux/amd64latest大小: 117.42 MB更新于 2026年11月8日

IDC设备资产管理系统

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

GitHub:


📖 查看完整文档教程 →

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


目录

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


快速开始

Docker 部署(推荐)

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

📖 详细教程请查看文档站:https://gituib.github.io/idc_assest-docs/deploy/docker-deploy.html

Linux 一键部署

# 克隆项目(GitHub 主仓库)
git clone https://github.com/gituib/idc_assest.git
cd idc_assest

# 运行安装脚本(自动安装 Node.js)
./install.sh

# 或一键安装(无需克隆)
curl -fsSL https://raw.githubusercontent.com/gituib/idc_assest/main/install.sh | bash

install.sh 自动完成:

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

Windows 部署

# 克隆项目
git clone https://github.com/gituib/idc_assest.git
cd idc_assest

# 运行安装脚本(需要先安装 Node.js)
node install.js

# 或使用 npm
npm run deploy

环境要求

项目最低要求推荐配置生产环境额外要求
操作系统Windows 10+、macOS 12+、Linux同最低-
Node.js≥14.0.020.x LTS同最低
npm≥6.0.010.x同最低
内存4GB8GB+8GB+(视规模)
磁盘2GB10GB+40GB+(视规模)
数据库--MySQL 8.0+(推荐)或 SQLite
Web 服务器--Nginx 1.18+
进程管理--PM2 5.x+

脚本命令参考

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;

服务器要求参考:

规模CPU内存磁盘
小型(500 设备)8 核心+16GB+100GB+

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)
  1. 502 Bad Gateway

  2. 检查后端服务:pm2 status

  3. 检查端口监听:netstat -tulpn | grep 8000

  4. 检查 Nginx 配置:nginx -t

  5. 查看错误日志:tail /var/log/nginx/error.log

  6. 前端构建失败

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

# 清理并重试
cd frontend
rm -rf node_modules dist
npm install
npm run build
  1. 数据库连接失败

MySQL:

  • 检查服务状态:sudo systemctl status mysql
  • 验证连接参数(主机、端口、用户名、密码)
  • 确认数据库已创建:SHOW DATABASES;
  • 检查用户权限:SHOW GRANTS FOR 'idc_user'@'localhost';
  1. 权限问题
# 修复文件权限
sudo chown -R $(whoami):$(whoami) /path/to/idc_assest

# 上传目录权限
sudo chmod -R 777 backend/uploads
  1. 内存不足
# 增加内存限制(编辑 ecosystem.config.js)
node_args: "--max-old-space-size=4096"

# 或命令行
pm2 restart idc-backend --update-env
  1. npm 安装失败
# 清理缓存
npm cache clean --force

# 删除后重装
rm -rf node_modules package-lock.json
npm install
  1. 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

提交信息规范:

类型说明
feat新功能
fixBug 修复
docs文档更新
style代码格式
refactor重构
perf性能优化
test测试
chore构建/工具

开发规范:

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

许可证

本项目采用**双授权(Dual Licensing)**模式:

开源通道(GPL-3.0)

  • 遵循 GNU GPL v3.0 许可协议:任何个人或组织可免费使用、修改、二次开发、分发。
  • 条件:衍生作品必须以 GPL-3.0 协议开源并公开源代码。

商业通道(商业授权)

  • 凡不符合 GPL-3.0 要求的商业使用或闭源二次开发,必须获得授权方 gituib 的商业授权。
  • 适用场景包括:闭源分发/销售、封装进闭源商业产品、对外提供商业化部署服务、企业内部闭源商业化运营等。
  • 商业授权为非独占许可,付费后可使用、修改、分发并闭源集成本软件,详见 LICENSE-COMMERCIAL.md。

版权 © 2026 gituib( )

如需商业授权,请联系:*** 或


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

  • GitHub Issues:
  • :
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告