部署软件管理系统admin入口需先确认框架技术栈，admin3（java+vue）、soybeanadmin（ts+vite）、element-ui admin（vue2+webpack）环境要求各异；须核对package.json或pom.xml存在后，按对应node.js或java依赖安装并启动。
部署软件管理系统admin入口，需根据实际选用的框架明确技术栈与环境依赖，不能直接套用通用流程。admin3、SoybeanAdmin、Element-UI Admin 等主流后台框架虽都带“admin”字样，但后端语言、构建工具、数据库要求差异显著——选错路径会导致启动失败、接口404或登录态丢失。
确认所用框架并拉取代码
打开终端，执行以下任一命令，对应你实际要部署的系统：
若部署 admin3（Java+Vue）：git clone https://gitcode.com/gh_mirrors/ad/admin3 && cd admin3
若部署 SoybeanAdmin（TypeScript+Vite）：git clone https://github.com/soybeanjs/soybean-admin.git && cd soybean-admin && git checkout example
若部署 Element-UI Admin（Vue2+Webpack）：git clone https://gitcode.com/gh_mirrors/el/element-ui-admin && cd element-ui-admin
【必须核对项目根目录是否存在 package.json 或 pom.xml】——没有前者说明不是前端项目，没有后者说明后端未包含，此时不可继续下一步。
本地环境依赖安装
方法一：Node.js 项目（SoybeanAdmin / Element-UI Admin）
确保已安装 Node.js 16+（运行 node -v 验证），然后执行：pnpm i（SoybeanAdmin）或 npm install（Element-UI Admin）。
方法二：Java 项目（admin3）
需同时满足 JDK 17+ 和 Maven 3.6+，运行 java -version 和 mvn -v 确认；若缺失，Ubuntu 下可执行：sudo apt install openjdk-17-jdk maven。
注意：不要在 Windows 上用 PowerShell 运行 Maven 命令，容易因路径空格或编码报错，改用 Git Bash 或 WSL。
后端服务启动（仅 admin3 需要）
第一步：准备 MySQL 数据库
创建 UTF8MB4 字符集数据库：mysql -u root -p -e "CREATE DATABASE admin3 DEFAULT CHARACTER SET utf8mb4;"
第二步：导入初始化脚本
执行：mysql -u root -p admin3 ——若提示 No such file，说明你没进入 admin3 目录或分支不对。
第三步：修改数据库连接配置
编辑 admin3-server/src/main/resources/application-dev.yml，将 spring.datasource.url、username、password 改为本地真实值；【password 必须填写，留空会导致启动时抛出 NullPointerException】。
第四步：启动后端
在 admin3-server 目录下运行：mvn spring-boot:run，看到控制台输出 “Started Admin3ServerApplication in X.XXX seconds” 即成功。
前端启动与访问
admin3 前端：cd admin3-ui && pnpm dev，默认访问 https://www.php.cn/link/8e5687e2d6ab87e5da2f833f3e8986a4
SoybeanAdmin：pnpm dev，默认访问 https://www.php.cn/link/5a88c0ad5912acc71a03765cab4e1e77
Element-UI Admin：npm start，默认访问 https://www.php.cn/link/cbb686245ece57c9827c4bc0d0654a8e
若浏览器打不开页面，先检查终端是否报 “address already in use”，再确认防火墙是否拦截了该端口——Linux 可临时关防火墙：sudo ufw disable，Windows 可在“高级安全 Windows 防火墙”中新建入站规则放行对应端口。
云端部署关键配置
方法一：反向代理暴露（Nginx + 宝塔/手动配置）
将前端构建产物（dist/ 目录）上传至服务器，配置 Nginx location 块指向该目录，并添加 proxy_pass http://127.0.0.1:8080;（admin3 后端）或直接 serve 静态文件（SoybeanAdmin 无需后端时）。
方法二：跨域与 host 白名单（SoybeanAdmin 必做）
编辑 vite.config.ts，在 server 配置中加入：host: true, allowedHosts: ["your-domain.com", "your-public-ip"] ——否则外网访问会触发 403 Forbidden。
方法三：生产构建（所有前端项目）
运行 pnpm build 或 npm run build 生成 dist/，该目录才是上线所需内容，dev 模式仅供本地调试，不可直接部署。
