yunrui_asset/DEPLOYMENT.md

IDC设备管理系统 - 部署指南

本文档详细介绍IDC设备管理系统的多种部署方式，包括开发环境、测试环境、生产环境的配置方法。

---

目录

• 快速开始
• 环境要求
• 开发环境部署
• 测试环境部署
• 生产环境部署
• 数据库配置
• 部署验证
• 更新升级
• 监控维护
• 常见问题

---

快速开始

一键部署脚本（推荐）⭐

我们提供了交互式安装脚本，自动完成环境检测、依赖安装、数据库初始化和服务启动。

Linux 用户（支持自动安装 Node.js）

# 克隆项目（选择其一）
# Gitee（国内推荐）
git clone https://gitee.com/zhang96110/idc_assest.git
# GitHub
git clone https://github.com/gituib/idc_assest.git
cd idc_assest

# 方式1：使用 Shell 引导脚本（推荐，无需预装 Node.js）
chmod +x install.sh && ./install.sh

# 方式2：一键安装（从远程）
curl -fsSL https://gitee.com/zhang96110/idc_assest/raw/main/install.sh | bash

Shell 脚本功能：

• ✅ 自动检测 Linux 发行版（Ubuntu/Debian/CentOS/Arch）
• ✅ 自动安装 Node.js 20.x（使用 NodeSource 或 nvm）
• ✅ 自动安装系统依赖（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

非交互式安装（快速部署）

# 使用默认配置快速安装
node install.js -y                    # 交互式安装

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

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

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

脚本功能：

• ✅ 自动检测 Node.js、npm、PM2、Nginx
• ✅ Linux 自动安装 Node.js（Ubuntu/Debian/CentOS/Arch）
• ✅ MySQL 连接测试（配置后自动验证）
• ✅ 安装后健康检查（验证服务是否正常）
• ✅ 交互式配置数据库（SQLite/MySQL）
• ✅ 交互式选择运行环境（development/production）
• ✅ 交互式选择前端部署方式（Nginx/PM2 serve）
• ✅ 自动安装项目依赖
• ✅ 自动初始化数据库
• ✅ 自动构建前端项目
• ✅ 使用 PM2 启动和管理服务
• ✅ 日志持久化保存

---

环境要求

基础运行环境

项目	最低要求	推荐配置
操作系统	Windows 10/11、macOS 12+、Linux (Ubuntu 20.04+/CentOS 8+)	同最低要求
Node.js	≥14.0.0	20.x LTS
npm	≥6.0.0	10.x
内存	4GB	8GB+
磁盘空间	2GB	10GB+

生产环境服务器要求

最低配置

资源	要求
CPU	2 核心
内存	4GB
磁盘	40GB SSD
带宽	5Mbps

推荐配置

资源	要求
CPU	4 核心+
内存	8GB+
磁盘	100GB SSD
带宽	10Mbps+

软件依赖

软件	版本要求	说明
Node.js	≥14.0.0 (推荐 20.x LTS)	运行时环境
npm	≥6.0.0	包管理器
PM2	5.x+	进程管理器（生产环境）
Nginx	1.18+	Web服务器/反向代理
MySQL	8.0+	数据库（生产环境，推荐）
SQLite	-（开发/小型	数据库部署）

端口要求

端口	用途	协议
8000	后端API服务	HTTP
3000	前端开发服务	HTTP
80	Nginx HTTP	HTTP
443	Nginx HTTPS	HTTPS

---

开发环境部署

1. 环境准备

Linux

Ubuntu/Debian:

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

CentOS/RHEL/Fedora:

curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
sudo yum install -y nodejs

使用 nvm（推荐开发者）:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 20
nvm use 20

2. 克隆项目

# 从Gitee克隆（国内访问更快）
git clone https://gitee.com/zhang96110/idc_assest.git

# 或从GitHub克隆
git clone https://github.com/gituib/idc_assest.git

cd idc_assest

3. 安装依赖

# 安装后端依赖
cd backend
npm install

# 安装前端依赖（新终端）
cd ../frontend
npm install

4. 配置环境变量

cd ../backend
cp .env.example .env

编辑 .env 文件（开发环境使用默认SQLite配置即可）：

# 开发环境配置
NODE_ENV=development
PORT=8000
DB_TYPE=sqlite
DB_PATH=./idc_management.db

# JWT配置（开发环境可使用简单密钥）
JWT_SECRET=dev_secret_key_change_in_production
JWT_EXPIRES_IN=7d

5. 初始化数据库

node scripts/init-database.js

6. 启动服务

同时启动前后端（推荐）：

# 项目根目录
npm start

分别启动：

# 终端1 - 启动后端（端口8000）
cd backend
npm run dev

# 终端2 - 启动前端（端口3000）
cd frontend
npm run dev

7. 访问开发环境

服务	地址
前端应用	http://localhost:3000
后端API	http://localhost:8000/api
健康检查	http://localhost:8000/health

8. 开发命令

# 项目根目录命令
npm start                 # 同时启动前后端
npm run start:backend    # 仅启动后端
npm run start:frontend  # 仅启动前端
npm run install:all     # 安装所有依赖

# 后端命令
cd backend
npm run dev             # 开发模式启动（热重载）
npm start               # 生产模式启动

# 前端命令
cd frontend
npm run dev             # 开发模式启动
npm run build           # 构建生产版本
npm run preview         # 预览生产版本

---

测试环境部署

1. 服务器准备

测试环境配置要求：

项目	配置
操作系统	Ubuntu 20.04 LTS / CentOS 8
Node.js	20.x LTS
内存	4GB
磁盘	20GB SSD
数据库	MySQL 8.0（与生产一致）

2. 配置数据库

# 安装MySQL
sudo apt update
sudo apt install -y mysql-server

# 启动MySQL
sudo systemctl start mysql
sudo systemctl enable mysql

# 创建数据库和用户
sudo mysql

CREATE DATABASE idc_management CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'idc_test'@'localhost' IDENTIFIED BY 'test_password';
GRANT ALL PRIVILEGES ON idc_management.* TO 'idc_test'@'localhost';
FLUSH PRIVILEGES;
EXIT;

3. 配置环境变量

cd backend
cp .env.example .env

编辑 .env 文件：

NODE_ENV=test
PORT=8000
DB_TYPE=mysql
MYSQL_HOST=localhost
MYSQL_PORT=3306
MYSQL_USERNAME=idc_test
MYSQL_PASSWORD=test_password
MYSQL_DATABASE=idc_management
JWT_SECRET=test_jwt_secret_key
JWT_EXPIRES_IN=24h

4. 安装依赖并初始化

# 安装后端依赖
cd backend
npm install

# 初始化数据库
node scripts/init-database.js

# 安装前端依赖并构建
cd ../frontend
npm install
npm run build

5. 使用PM2启动服务

# 安装PM2
npm install -g pm2

# 启动后端服务
cd ../backend
pm2 start server.js --name "idc-test-backend" --env test

# 启动前端静态服务
cd ../frontend
pm2 serve --name "idc-test-frontend" -s dist -l 3000

# 保存PM2配置
pm2 save

# 配置开机自启
pm2 startup

6. 测试验证

# 测试后端API
curl http://localhost:8000/health

# 测试前端
curl http://localhost:3000

---

生产环境部署

1. 服务器要求

硬件要求

规模	CPU	内存	磁盘
小型（<100设备）	2核心	4GB	40GB
中型（100-500设备）	4核心	8GB	80GB
大型（>500设备）	8核心+	16GB+	100GB+

软件要求

软件	版本	说明
操作系统	Ubuntu 20.04+ / CentOS 8+	推荐 Ubuntu 22.04 LTS
Node.js	20.x LTS	运行时环境
MySQL	8.0+	数据库
Nginx	1.18+	反向代理/静态文件
PM2	5.x+	进程管理

2. 系统配置

创建部署用户（非root）

# 创建用户
sudo adduser idcadmin

# 赋予sudo权限
sudo usermod -aG sudo idcadmin

# 切换到部署用户
sudo su - idcadmin

配置防火墙

# Ubuntu
sudo ufw allow 22    # SSH
sudo ufw allow 80    # HTTP
sudo ufw allow 443   # HTTPS
sudo ufw enable

# CentOS
sudo firewall-cmd --permanent --add-port=22/tcp
sudo firewall-cmd --permanent --add-port=80/tcp
sudo firewall-cmd --permanent --add-port=443/tcp
sudo firewall-cmd --reload

3. 安装软件

安装Node.js

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# 安装PM2
sudo npm install -g pm2

安装MySQL

# Ubuntu
sudo apt install -y mysql-server

sudo apt update
# 启动并配置
sudo systemctl start mysql
sudo systemctl enable mysql

安装Nginx

# Ubuntu
sudo apt install -y nginx
sudo systemctl start nginx
sudo systemctl enable nginx

4. 配置数据库

sudo mysql

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

-- 创建用户（生产环境使用强密码）
CREATE USER 'idc_prod'@'localhost' IDENTIFIED BY 'YOUR_STRONG_PASSWORD_HERE';
GRANT ALL PRIVILEGES ON idc_management.* TO 'idc_prod'@'localhost';
FLUSH PRIVILEGES;

EXIT;

5. 部署项目

克隆项目

cd /var/www
# 选择其一
# Gitee（国内推荐）
sudo git clone https://gitee.com/zhang96110/idc_assest.git
# GitHub
sudo git clone https://github.com/gituib/idc_assest.git
sudo chown -R idcadmin:idcadmin idc_assest

配置环境变量

cd /var/www/idc_assest/backend
cp .env.example .env
nano .env

编辑 .env 文件：

# 生产环境配置
NODE_ENV=production
PORT=8000
DB_TYPE=mysql
MYSQL_HOST=localhost
MYSQL_PORT=3306
MYSQL_USERNAME=idc_prod
MYSQL_PASSWORD=YOUR_STRONG_PASSWORD_HERE
MYSQL_DATABASE=idc_management

# JWT配置（使用强随机密钥）
JWT_SECRET=$(openssl rand -base64 32)
JWT_EXPIRES_IN=24h

# 日志配置
LOG_LEVEL=info

6. 安装依赖

# 安装后端依赖
cd /var/www/idc_assest/backend
npm install --production

# 安装前端依赖并构建
cd ../frontend
npm install
npm run build

7. 初始化数据库

cd ../backend
node scripts/init-database.js

8. 配置PM2

# 创建PM2配置文件
nano /var/www/idc_assest/ecosystem.config.js

module.exports = {
  apps: [
    {
      name: 'idc-backend',
      script: './server.js',
      cwd: '/var/www/idc_assest/backend',
      instances: 1,
      exec_mode: 'fork',
      env: {
        NODE_ENV: 'production',
        PORT: 8000
      },
      max_memory_restart: '1G',
      log_file: '/var/log/idc/combined.log',
      out_file: '/var/log/idc/out.log',
      error_file: '/var/log/idc/error.log',
      log_date_format: 'YYYY-MM-DD HH:mm:ss Z',
      merge_logs: true,
      autorestart: true,
      watch: false
    }
  ]
};

# 创建日志目录
sudo mkdir -p /var/log/idc
sudo chown -R idcadmin:idcadmin /var/log/idc

# 启动服务
cd /var/www/idc_assest
pm2 start ecosystem.config.js
pm2 save
pm2 startup

9. 配置Nginx

sudo nano /etc/nginx/sites-available/idc

upstream idc_backend {
    server 127.0.0.1:8000;
}

server {
    listen 80;
    server_name your-domain.com;  # 替换为实际域名

    # 前端静态文件
    root /var/www/idc_assest/frontend/dist;
    index index.html;

    # Gzip压缩
    gzip on;
    gzip_vary on;
    gzip_min_length 1024;
    gzip_types text/plain text/css text/xml text/javascript application/javascript application/xml+rss application/json;

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

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

    # API代理
    location /api {
        proxy_pass http://idc_backend;
        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_connect_timeout 60s;
        proxy_send_timeout 60s;
        proxy_read_timeout 60s;
    }

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

    # 健康检查
    location /health {
        proxy_pass http://idc_backend/health;
    }

    # Swagger API文档（v2.0.0新增）
    location /api-docs {
        proxy_pass http://idc_backend/api-docs;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
    }

    # SSE 备份恢复进度推送（v2.0.0新增）
    location ~ ^/api/backup/restore-progress/ {
        proxy_pass http://idc_backend;
        proxy_http_version 1.1;
        proxy_set_header Connection '';
        proxy_buffering off;
        proxy_cache off;
        chunked_transfer_encoding off;
    }
}

# 启用配置
sudo ln -s /etc/nginx/sites-available/idc /etc/nginx/sites-enabled/
sudo rm -f /etc/nginx/sites-enabled/default
sudo nginx -t
sudo systemctl reload nginx

10. 配置SSL证书（可选）

使用 Let's Encrypt 免费证书：

# 安装Certbot
sudo apt install -y certbot python3-certbot-nginx

# 获取证书
sudo certbot --nginx -d your-domain.com

# 自动续期测试
sudo certbot renew --dry-run

---

数据库配置

SQLite（开发环境/小规模）

• 默认配置，无需额外设置
• 数据库文件：backend/idc_management.db
• 优点：零配置，便携
• 缺点：不适合高并发，单文件限制

MySQL（生产环境推荐）

创建数据库

CREATE DATABASE idc_management CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

配置优化

# my.cnf 或 my.ini
[mysqld]
character-set-server=utf8mb4
collation-server=utf8mb4_unicode_ci
max_connections=200
innodb_buffer_pool_size=1G

数据备份

系统内置备份（推荐）

v2.0.0 新增了内置备份管理功能，支持手动备份、自动定时备份和远端备份。

1. 手动备份：在系统管理 → 备份管理中点击「创建备份」
2. 自动备份：在系统管理 → 自动备份中配置 Cron 表达式定时备份
3. 远端备份：在系统管理 → 远端备份中配置 FTP/SFTP/WebDAV/SMB 协议上传

SQLite备份

# 手动备份
cp backend/idc_management.db backup/database_$(date +%Y%m%d).db

MySQL备份

# 手动备份
mysqldump -u idc_prod -p idc_management > backup/database_$(date +%Y%m%d).sql

# 自动备份脚本
#!/bin/bash
BACKUP_DIR="/var/backups/idc"
DATE=$(date +%Y%m%d_%H%M%S)
mkdir -p $BACKUP_DIR
mysqldump -u idc_prod -pYourPassword idc_management > "$BACKUP_DIR/database_$DATE.sql"
gzip "$BACKUP_DIR/database_$DATE.sql"

# 清理30天前的备份
find $BACKUP_DIR -name "database_*.gz" -mtime +30 -delete

添加到crontab：

crontab -e
# 每天凌晨2点执行
0 2 * * * /path/to/backup_script.sh

---

部署验证

1. 服务状态检查

# PM2服务状态
pm2 status

# Nginx状态
sudo systemctl status nginx

# MySQL状态
sudo systemctl status mysql

2. 接口验证

# 健康检查
curl http://localhost:8000/health

# API测试
curl http://localhost:8000/api/rooms

# Swagger API文档（v2.0.0新增）
# 浏览器访问 http://localhost:8000/api-docs

# 上传接口测试
curl -X POST http://localhost:8000/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"admin123"}'

3. 日志检查

# PM2日志
pm2 logs idc-backend

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

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

4. 性能测试

# 使用curl测试响应时间
time curl -o /dev/null -s -w "%{http_code}\n" http://localhost:8000/health

---

更新升级

方式一：一键更新脚本（推荐）⭐

# 交互式更新
node update.js

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

# 模拟运行（不执行实际操作）
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

智能检测功能：

• ✅ 依赖安装智能跳过 - 检测 package.json 变化，无变化则跳过
• ✅ 前端构建智能跳过 - 检测源码变化，无变化则跳过
• ✅ 数据库自动备份 - 更新前自动备份，支持回滚
• ✅ 健康检查验证 - 更新后验证服务是否正常
• ✅ 日志持久化 - 更新日志保存到 logs/update_*.log
• ✅ 锁机制 - 防止多个更新进程同时运行

方式二：手动更新

v2.0.0 升级注意事项

从 1.x 版本升级到 2.0.0 时，请注意以下事项：

1. 数据库迁移：新增了 BackupLog、OperationLog、Warehouse、Business、DeviceBusiness、ConsumableLogArchive 等数据表，务必运行迁移脚本
2. JWT 安全增强：建议更新生产环境的 JWT_SECRET 配置为强随机密钥
3. 新增依赖：后端新增了 basic-ftp、ssh2-sftp-client、webdav、smb2、node-cron、swagger-jsdoc、swagger-ui-express 等依赖
4. 3D 引擎升级：Three.js 从 0.160.0 升级到 0.183.2，请确认浏览器兼容性
5. Swagger 文档：新增交互式 API 文档，可通过 /api-docs 访问
6. 备份目录：确保 backend/backups/ 目录存在且有写入权限

1. 备份数据

# 备份数据库
mysqldump -u idc_prod -p idc_management > /var/backups/idc/database_backup_$(date +%Y%m%d).sql

# 或备份SQLite
cp backend/idc_management.db /var/backups/idc/

2. 拉取最新代码

cd /var/www/idc_assest
git pull origin main

3. 更新依赖

# 更新后端依赖
cd backend
npm install

# 更新前端依赖并构建
cd ../frontend
npm install
npm run build

4. 运行数据库迁移（如有）

cd ../backend
node scripts/migrate-all.js

5. 重启服务

pm2 restart idc-backend
sudo nginx -t && sudo nginx -s reload

---

监控维护

服务管理命令

# PM2 管理
pm2 status                    # 查看服务状态
pm2 logs idc-backend          # 查看后端日志
pm2 logs idc-backend --err    # 查看错误日志
pm2 restart idc-backend       # 重启后端服务
pm2 stop idc-backend          # 停止后端服务
pm2 delete idc-backend        # 删除后端服务
pm2 save                      # 保存当前进程列表
pm2 startup                   # 配置开机自启
pm2 monit                     # 实时监控

# Nginx 管理
sudo nginx -t                 # 测试配置
sudo systemctl restart nginx  # 重启服务
sudo systemctl status nginx   # 查看状态

性能监控

PM2配置（ecosystem.config.js）

module.exports = {
  apps: [{
    name: 'idc-backend',
    script: './server.js',
    cwd: './backend',
    instances: 1,
    exec_mode: 'fork',
    max_memory_restart: '1G',
    autorestart: true,
    env: {
      NODE_ENV: 'production'
    },
    log_file: './logs/combined.log',
    out_file: './logs/out.log',
    error_file: './logs/error.log',
    log_date_format: 'YYYY-MM-DD HH:mm:ss Z'
  }]
};

---

卸载系统

方式一：一键卸载脚本（推荐）⭐

# 交互式卸载
node uninstall.js

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

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

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

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

卸载功能：

• ✅ 停止并删除 PM2 服务
• ✅ 清理 Nginx 配置
• ✅ 删除生成的配置文件
• ✅ 可选删除数据库文件
• ✅ 可选删除 node_modules
• ✅ 卸载前自动备份
• ✅ 日志持久化保存

方式二：手动卸载

# 1. 停止服务
pm2 stop idc-backend
pm2 delete idc-backend
pm2 save

# 2. 删除配置文件
rm backend/.env
rm deploy/ecosystem.config.js
rm deploy/nginx-idc.conf

# 3. 删除数据库（可选）
rm backend/idc_management.db

# 4. 删除依赖（可选）
rm -rf backend/node_modules
rm -rf frontend/node_modules
rm -rf frontend/dist

---

常见问题

端口冲突

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

# Windows
netstat -ano | findstr :8000

# 修改端口
# 编辑 backend/.env 文件
PORT=8001

依赖安装失败

# 清理缓存
npm cache clean --force

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

数据库连接失败

MySQL：

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

前端构建失败

# 检查 Node.js 版本
node -v

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

权限问题

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

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

内存不足

# 增加 Node.js 内存限制
node --max-old-space-size=4096 server.js

# PM2 配置
pm2 start server.js --name "idc-backend" --node-args="--max-old-space-size=4096"

Nginx 502 Bad Gateway

1. 检查后端服务是否运行：pm2 status
2. 检查后端端口是否监听：netstat -tulpn | grep 8000
3. 检查Nginx配置：nginx -t
4. 查看错误日志：tail -f /var/log/nginx/error.log

SSL证书问题

# 检查证书是否过期
sudo certbot certificates

# 手动续期
sudo certbot renew

# 查看证书详情
sudo certbot certificates

---

项目结构

idc_assest/
├── backend/              # 后端服务
│   ├── middleware/       # 中间件（认证、验证）
│   ├── models/          # 数据模型（Sequelize）
│   ├── routes/          # API路由
│   ├── scripts/         # 数据库脚本
│   ├── uploads/        # 文件上传目录
│   ├── validation/     # 数据验证Schema
│   ├── server.js       # 服务入口
│   └── package.json
├── frontend/            # 前端应用
│   ├── src/
│   │   ├── api/        # API接口
│   │   ├── components/ # 组件
│   │   ├── pages/      # 页面
│   │   └── utils/      # 工具函数
│   ├── dist/           # 构建输出
│   └── package.json
├── docs/                # 项目文档
│   ├── api/             # 接口文档
│   └── images/          # 文档图片
├── install.sh           # Linux 安装引导脚本（Shell）⭐
├── install.js           # 交互式安装脚本（Node.js）⭐
├── update.js            # 一键更新脚本 ⭐
├── uninstall.js         # 卸载脚本
├── check.js             # 环境检查脚本
├── modify.js            # 配置修改脚本
├── package.json
├── README.md            # 项目说明
├── CHANGELOG.md         # 版本记录
└── DEPLOYMENT.md       # 本文件

---

⭐ 如果这个部署指南对您有帮助，请给我们一个Star！