后端配置（宝塔）：SSH终端设置

<think>我们正在处理一个关于在宝塔面板上部署若依框架项目的问题。根据引用内容，我们知道若依前后端分离项目（Vue3+SpringBoot版本）在部署时，需要修改vite.config.js文件中的target地址，将其改为与VITE_APP_BASE_API一样的地址。然而，用户的问题更广泛：如何在宝塔面板中部署若依框架项目？因此，我们需要提供一个完整的部署指南。部署若依前后端分离项目（Vue3+SpringBoot版本）到宝塔面板，通常包括以下步骤：1.准备服务器环境（安装宝塔面板、Java、Node.js、MySQL、Nginx等）2.部署后端SpringBoot项目（打包为jar/war，配置数据库等）3.部署前端Vue3项目（打包静态文件，配置Nginx）4.修改前端配置以对接后端API（即修改vite.config.js中的target，但注意这是在开发环境中的配置，生产环境是通过Nginx代理解决跨域，因此实际部署时可能不需要修改这个target，而是通过配置Nginx代理）但是，引用中提到的修改vite.config.js文件是在开发环境中的配置，而在生产环境部署时，我们通常将前端打包成静态文件，然后通过Nginx来代理API请求，这样就不需要修改前端的target了，而是通过Nginx的代理配置将API请求转发到后端。因此，我们重新梳理步骤：**后端部署步骤：**1.在宝塔面板中安装必要的软件：Java（根据项目要求的版本，如JDK1.8）、MySQL（创建数据库，导入sql文件）、Nginx（用于前端部署和反向代理后端）。2.将SpringBoot项目打包成jar文件（使用Maven或Gradle），上传到服务器。3.在宝塔面板中配置Java项目，添加SpringBoot的jar包，设置运行端口和运行参数。4.启动后端项目。**前端部署步骤：**1.在本地修改生产环境的后端API地址（如果前端打包时需要指定后端API地址，则修改.env.production文件中的VITE_APP_BASE_API，或者通过打包命令注入环境变量）。注意：引用中提到的vite.config.js中的target通常是开发环境的代理配置，生产环境不需要这个代理，而是通过Nginx配置反向代理。2.打包前端项目（执行`npmrunbuild`），生成dist文件夹。3.将dist文件夹上传到服务器。4.在宝塔面板中创建网站，将网站目录指向dist文件夹。5.配置Nginx反向代理，将API请求转发到后端服务（例如，将所有以`/prod-api/`开头的请求转发到后端的端口，如8080）。因此，我们重点在于配置Nginx反向代理，这样前端在访问`/prod-api/`时，会被Nginx转发到后端服务，从而解决跨域问题。具体步骤：###1.服务器环境准备-安装宝塔面板（略，假设已经安装）-在宝塔面板中安装：Nginx、MySQL（创建数据库，导入若依的SQL脚本）、Java（若依后端需要的版本，如JDK1.8）###2.后端部署-在本地打包后端项目：使用Maven执行`mvncleanpackage`，得到jar文件（在target目录下）。-将jar文件上传到服务器，比如放到`/www/wwwroot/ruoyi`目录下（可以创建一个专门的目录）。-在宝塔面板的“Java项目”部分，添加一个SpringBoot项目，选择上传的jar文件，设置端口（例如8080），并设置其他参数（如JVM参数）。-启动项目，检查日志是否正常。###3.前端部署-在本地修改前端项目的生产环境配置文件（`.env.production`），将`VITE_APP_BASE_API`设置为实际的生产环境API地址。注意：这里可以设置为空或者`/prod-api/`，因为我们将通过Nginx代理转发。-打包前端项目：在项目目录下执行`npmrunbuild`，生成dist文件夹。-将dist文件夹上传到服务器，比如放到`/www/wwwroot/ruoyi-ui`目录下。-在宝塔面板中创建网站：-域名：如果没有域名，可以使用IP或临时域名。-根目录：选择上传的dist文件夹的路径（如`/www/wwwroot/ruoyi-ui`）。-其他设置默认。-配置Nginx反向代理：-在宝塔面板中，找到该网站的设置，点击“配置文件”。-在server块中添加以下反向代理配置（假设后端运行在8080端口）：```nginxlocation/prod-api/{proxy_passhttp://localhost:8080/;#注意最后的斜杠，表示将/prod-api/替换为/proxy_set_headerHost$host;proxy_set_headerX-Real-IP$remote_addr;proxy_set_headerX-Forwarded-For$proxy_add_x_forwarded_for;}```-保存并重启Nginx。###4.测试-访问前端地址（域名或IP），应该可以看到若依的前端界面，并且可以正常访问后端接口。注意：若依框架的前端默认使用`/prod-api`作为后端接口的根路径，因此我们配置Nginx将`/prod-api/`转发到后端的8080端口。另外，如果后端启动失败，需要检查端口是否被占用，以及数据库配置是否正确（修改后端配置文件`application-prod.yml`中的数据库连接信息）。关于引用中提到的修改`vite.config.js`，那是在开发环境中解决跨域问题的方法，在生产环境部署时，我们使用Nginx反向代理，因此不需要修改该文件中的target。但是，如果前端打包后需要独立部署（没有与后端同域），那么前端打包时设置的`VITE_APP_BASE_API`应该是`/prod-api/`（相对路径），这样请求就会发到同一个域下的`/prod-api/`路径，然后由Nginx转发。因此，在部署生产环境时，我们只需要确保前端打包时使用的`VITE_APP_BASE_API`是`/prod-api/`（或者根据实际情况设置），然后通过Nginx代理即可。总结：宝塔部署若依前后端分离项目的关键步骤是后端Java项目的部署和前端Nginx配置（包括静态文件服务和反向代理）。§§相关问题§§1.若依框架后端启动时数据库连接失败怎么办？2.如何配置若依框架的前端生产环境变量？3.宝塔面板如何设置Nginx反向代理？4.若依框架项目在宝塔面板部署后，如何设置HTTPS？</think>### 在宝塔面板中部署若依框架项目（Vue3 + SpringBoot 版）指南 #### 一、环境准备 1. **安装宝塔面板** - 通过 SSH 登录服务器执行安装命令（以 CentOS 为例）： ```bash yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && sh install.sh ``` 2. **安装必要软件** 在宝塔面板的「软件商店」安装： - Web 服务器：**Nginx 1.20+** - 数据库：**MySQL 5.7+** - 运行环境：**Java Tomcat 8/9**（或直接安装 JDK 1.8+） - Node.js：**Node 16+**（用于前端构建） --- #### 二、后端部署（SpringBoot） 1. **打包与上传** - 在本地使用 Maven 打包项目： ```bash mvn clean package -DskipTests ``` - 将生成的 `ruoyi-admin/target/*.jar` 上传到服务器（如 `/www/wwwroot/ruoyi-api`） 2. **配置数据库** - 在宝塔创建 MySQL 数据库，导入若依的 SQL 脚本（`/sql` 目录下的 `.sql` 文件） - 修改后端配置文件 `application-prod.yml`： ```yaml spring: datasource: url: jdbc:mysql://localhost:3306/ry_db?useSSL=false username: your_db_user password: your_db_password ``` 3. **启动后端服务** 在宝塔「终端」执行： ```bash nohup java -jar ruoyi-admin.jar --spring.profiles.active=prod > app.log 2>&1 & ``` > 默认端口 `8080`，可在 `application-prod.yml` 中修改 `server.port` --- #### 三、前端部署（Vue3） 1. **修改 API 地址** 打开前端项目中的 `vite.config.js`，修改代理目标地址： ```javascript server: { proxy: { '/prod-api': { target: 'http://your-server-ip:8080', // 改为后端实际地址 changeOrigin: true, rewrite: (path) => path.replace(/^\/prod-api/, '') } } } ``` > ⚠️ 此步骤关键！需与后端运行 IP:PORT 一致[^1] 2. **构建静态文件** ```bash npm install npm run build ``` 生成 `dist` 文件夹 3. **部署到 Nginx** - 在宝塔创建新网站，根目录指向 `dist` 文件夹 - 修改 Nginx 配置（在「网站设置」→「配置文件」）： ```nginx location /prod-api/ { proxy_pass http://localhost:8080/; # 后端地址 proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } ``` --- #### 四、验证与优化 1. **访问测试** - 前端地址：`http://your-domain.com` - 后端接口：`http://your-domain.com/prod-api/xxx` 2. **HTTPS 配置（可选）** 在宝塔面板「SSL」菜单申请证书并强制 HTTPS 3. **防火墙设置** 确保宝塔安全组和服务器防火墙开放： - 前端端口：`80/443` - 后端端口：`8080` --- #### 常见问题解决 - **前端 404 错误**：检查 Nginx 的 `root` 是否指向 `dist` 目录 - **接口连接失败**：确认 `vite.config.js` 和 Nginx 配置中的后端地址一致 - **数据库连接异常**：检查 `application-prod.yml` 的数据库配置和权限