核心内容摘要
《暴躁老妈》_2
环境准备与宝塔面板安装第一次用宝塔部署Ruoyi项目时我对着命令行界面发呆了半小时——这可能是很多小白的真实写照。
其实整个过程就像组装乐高积木只要按步骤来就能搭建出完整的系统。
我们先从最基础的服务器环境说起。
选择云服务器时国内主流平台1核2G配置就足够运行Ruoyi。
记得在安全组开放以下端口8888宝塔面板、80/443Web服务、3306MySQL、6379Redis以及项目要用的端口如8080。
拿到服务器后用SSH工具连接执行这条魔法咒语yum install -y wget wget -O install.sh https://download.bt.cn/install/install_
6.
sh sh install.sh ed8484bec安装完成后会显示面板地址和初始账号密码建议立即保存到本地。
首次登录宝塔会弹出环境安装向导我建议选择LNMP组合Nginx
1.
MySQL
5.
PHP
4。
这里有个小技巧PHP版本选
4足够用MySQL一定要选
7以上否则导入数据时会报错。
后端部署全流程
1 数据库配置在宝塔面板的数据库菜单新建数据库字符集选utf8mb4。
下载的Ruoyi源码里会有SQL文件通常在/sql目录通过宝塔的phpMyAdmin导入时我遇到过两个典型问题文件过大无法上传修改php.ini中的upload_max_filesize外键约束报错在导入前执行SET FOREIGN_KEY_CHECKS0记得检查application-druid.yml中的数据库配置特别是密码字段。
有次我折腾半天连接失败最后发现是密码里的特殊字符没转义。
2 项目打包与上传用IDEA打开项目后先修改这三个配置文件application.ymlserver.port改为计划使用的端口如8080application-druid.yml数据库连接信息logback.xml日志路径改为服务器真实路径如/www/wwwroot/logs执行maven打包时建议跳过测试mvn clean package -Dmaven.test.skiptrue上传jar包到服务器后在宝塔的Java项目菜单新建项目。
关键配置点项目路径建议放在/www/wwwroot/目录下JDK版本与本地开发环境保持一致端口号与配置文件中的server.port一致
3 常见启动问题第一次启动失败时别慌查看日志通常能发现端口冲突netstat -tlnp查看占用端口的进程数据库连接失败检查账号密码及远程连接权限文件权限问题chmod -R 777 /www/wwwroot/logs
前端部署实战
1 项目打包技巧在ruoyi-ui目录下执行打包时Node.js版本建议用
x。
遇到过两个坑高版本Node报openssl错误在package.json的build命令前加SET NODE_OPTIONS--openssl-legacy-provider打包后页面空白修改vue.config.js中的publicPath为./
2 Nginx配置精髓宝塔新建站点后关键配置在Nginx的location块location / { try_files $uri $uri/ /index.html; root /www/wwwroot/ruoyi-ui/dist; } location /prod-api/ { proxy_pass http://
127.
0.
1:8080/; proxy_set_header Host $http_host; }特别注意proxy_pass末尾的/不能漏前端路由需要try_files配置静态资源缓存可以设置expires
安全加固与优化部署完成后建议立即修改宝塔面板默认端口设置SSH密钥登录配置防火墙规则开启Nginx的gzip压缩设置定时任务备份数据库性能优化方面可以调整JVM参数-Xms512m -Xmx1024m配置Redis缓存开启Nginx的http
故障排查指南遇到问题先看日志后端日志/www/wwwroot/项目名/logsNginx错误日志/www/wwwlogs/域名.error.logMySQL慢查询日志通过宝塔面板开启
常见问题解决方案502错误检查后端服务是否运行接口404确认Nginx的proxy_pass配置静态资源加载失败检查路径和权限登录失败确认Redis服务正常记得第一次成功看到登录页面的成就感所有报错都成了值得回味的经历。
部署过程中养成记录配置变更的习惯下次再部署同样项目时效率能提升数倍。