一、阿里云服务器准备(最易踩坑环节)
1.服务器购买与配置
推荐配置:2核4G,系统盘40G以上,带宽1M起步
操作系统:可以选择CentOS7.9 64位
安全组配置(购买时或控制台"安全组"页面):
入方向添加规则:开放80(HTTP)、443(HTTPS)、3306(MySQL)、6379(Redis)、后端需要的端口、前端需要端口、宝塔面板端口
源地址:测试环境填0.0.0.0/0,生产环境仅开放必要IP
注意:阿里云默认关闭所有端口,不开放将无法访问任何服务

2.远程连接服务器
方法1:阿里云控制台"远程连接"→"Workbench远程连接",输入root密码登录
方法2:使用Xshell,主机填服务器公网IP,端口22,用户名root,密码登录
登录成功后会显示[root@i-xxxxxx~]提示符

二、宝塔面板安装(全程约5分钟)
1.执行官方最新一键安装命令(2026年6月):
bash
yuminstall-ywget&&wget-Oinstall.shhttp://download.bt.cn/install/install_6.0.sh&&shinstall.sh

2.安装过程中会提示"DoyouwanttoinstallBt-Paneltothe/wwwdirectorynow?",输入y回车
3.安装完成后,终端会输出类似以下信息:

外网面板地址:http://123.45.67.89:8888/abcdef12
内网面板地址:http://172.16.0.1:8888/abcdef12
用户名:admin
密码:12345678

可以截图保存,或者直接用命令bt 打开宝塔选择面板,直接根据选择改成自己想要的账号及密码。
4.浏览器访问外网面板地址,输入用户名和密码登录
5.首次登录会弹出"推荐安装套件",选择LNMP(Nginx+MySQL+PHP),点击"一键安装"(PHP可选,不影响Java项目),如果选择内没有想要的环境,可以到宝塔面板的软件商店搜索下载需要的环境及工具。

三、基础环境安装与验证
在宝塔面板"软件商店"→"运行环境"中安装以下软件:
|软件|版本|作用|安装后验证|
|------|------|------|------------|
|Nginx|1.24|静态资源托管+反向代理|访问服务器IP,显示"恭喜,站点创建成功!"|
|MySQL|8.0|数据库|宝塔"数据库"页面可正常创建数据库|
|Redis|7.0|缓存|宝塔"软件商店"→"Redis"→"设置"→"状态"显示"运行中"|
|Java|1.8|SpringBoot运行环境|终端执行java-version显示版本信息|
|Node.js|18.x|Vue项目打包|终端执行node-v和npm-v显示版本信息|

注意:安装Java时选择"JDK1.8",不要选JRE;Node.js安装后在"设置"中切换npm源为淘宝源,加速依赖下载

四、数据库与缓存详细配置
MySQL配置
1.进入宝塔"数据库"页面,点击"添加数据库"
2.数据库名:springboot_db,用户名:springboot_user,密码:设置复杂密码(如Spring@2026)
3.访问权限:测试环境选"所有人",生产环境选"指定IP"并填写服务器公网IP
4.点击"提交",记录数据库名、用户名和密码
5.点击"导入",上传本地SQL脚本文件,点击"导入"完成数据初始化。还可以用本地电脑,使用Navicat软件连接新建的数据库继续传输及脚本运行数据库脚本。

Redis配置
1.进入宝塔"软件商店"→"Redis"→"设置"→"配置修改"
2.找到requirepass,取消注释并设置密码:requirepassRedis@2026
3.找到protected-mode,改为protected-modeno(测试环境)
4.找到bind127.0.0.1,注释掉(测试环境)
5.点击"保存",然后点击"服务"→"重启"生效

五、前端Vue项目部署
1.本地打包准备
修改Vue项目src/config/index.js或.env.production文件,将后端接口地址改为:http://服务器公网IP/api
在项目根目录执行:
bash
npminstall
npmrunbuild

执行完成后会生成dist文件夹,里面是打包后的静态文件

2.宝塔部署
进入宝塔"网站"页面,点击"添加站点"
域名:填写服务器公网IP(没有域名就用IP),根目录:/www/wwwroot/你的域名
点击"提交",然后点击"根目录"进入文件管理器
删除默认的index.html文件,点击"上传",将本地dist文件夹内的所有文件上传到根目录

3.Nginx配置解决路由404
点击站点右侧的"设置"→"配置文件"
找到location/{块,修改为:
nginx
location/{
root/www/wwwroot/你的域名;
indexindex.htmlindex.htm;
try_files$uri$uri//index.html;关键:解决Vue路由刷新404
}

点击"保存",然后点击"服务"→"重启Nginx"
此时访问服务器公网IP,应该能看到前端页面

六、后端SpringBoot项目部署
1.本地打包准备
修改application.yml或application.properties文件:
yaml
spring:
datasource:
url:jdbc:mysql://127.0.0.1:3306/springboot_db?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
username:springboot_user
password:Spring@2026
redis:
host:127.0.0.1
port:6379
password:Redis@2026
server:
port:8080
servlet:
context-path:/api关键:与前端接口前缀一致

在IDEA中执行:mvncleanpackage-DskipTests
执行完成后,在target目录下会生成一个jar包(如demo-0.0.1-SNAPSHOT.jar)

2.宝塔部署与启动
进入宝塔"文件"页面,创建目录:/www/wwwroot/springboot
进入该目录,点击"上传",将本地jar包上传到这里
点击宝塔"终端",执行以下命令启动项目:
bash
cd/www/wwwroot/springboot
nohupjava-jardemo-0.0.1-SNAPSHOT.jar>app.log2>&1&

解释:nohup表示后台运行,>app.log表示将日志输出到app.log文件,2>&1表示将错误输出重定向到标准输出,&表示后台执行

3.Nginx反向代理配置
回到前端站点的"设置"→"配置文件",在location/块下面添加:
nginx
location/api/{
proxy_passhttp://127.0.0.1:8080/api/; #这里可以修改成自己的对应端口,8080/api/根据自己的实际情况来写,如果自己的,没带api,可以直接写8080/.
proxy_set_headerHost$host;
proxy_set_headerX-Real-IP$remote_addr;
proxy_set_headerX-Forwarded-For$proxy_add_x_forwarded_for;
proxy_set_headerX-Forwarded-Proto$scheme;
}

点击"保存",重启Nginx

七、测试与常见问题排查
1.测试流程
访问前端页面:http://服务器公网IP
测试登录、查询等功能,看是否能正常调用后端接口
查看后端日志:cat/www/wwwroot/springboot/app.log

2.常见问题解决
无法访问宝塔面板:检查安全组是否开放8888端口
无法访问前端页面:检查Nginx是否启动,安全组是否开放80端口
接口调用失败:检查SpringBoot是否启动,Nginx反向代理配置是否正确
数据库连接失败:检查数据库用户名密码是否正确,是否允许本地访问

3.生产环境优化建议
配置HTTPS证书:宝塔"网站"→"SSL"→"Let'sEncrypt"免费申请
关闭不必要的端口:安全组只开放80、443端口
配置防火墙:宝塔"安全"→"防火墙",添加规则
定期备份数据库:宝塔"数据库"→"备份",设置自动备份

Logo

汇聚全球AI编程工具,助力开发者即刻编程。

更多推荐