从本地开发到云服务器：手把手教你用宝塔面板部署JeecgBoot（含域名绑定和SSL证书）
从零到上线：宝塔面板可视化部署JeecgBoot全栈项目实战
在数字化转型浪潮中，快速搭建企业级管理系统成为许多中小团队的刚需。JeecgBoot作为一款基于SpringBoot+Vue3的低代码开发平台，凭借其丰富的功能模板和开箱即用的特性，正获得越来越多开发者的青睐。但对于不熟悉命令行操作的团队而言，从本地开发到服务器部署的全流程仍存在一定门槛。本文将彻底摒弃复杂的命令行操作，全程使用国内普及率最高的宝塔面板作为可视化工具，带您完成从云服务器初始化到HTTPS安全访问的完整部署旅程。
1. 云服务器与宝塔面板基础配置
1.1 服务器选购与系统初始化
建议选择2核4G及以上配置的云服务器（腾讯云、阿里云等主流平台均可），操作系统推荐CentOS 7.9或Ubuntu 20.04 LTS。购买完成后需在控制台完成三项基础操作：
- 重置实例密码（建议12位以上包含大小写字母和数字）
- 开放安全组端口（需包含：8888、80、443、3306、6379、8080）
- 绑定弹性IP（避免服务器重启后公网IP变更）
通过SSH连接服务器后，执行系统更新（以CentOS为例）：
yum update -y && yum install -y wget1.2 宝塔面板一键安装
官方提供极简安装命令，根据系统选择对应指令：
CentOS安装命令：
curl -sSO http://download.bt.cn/install/install_6.0.sh && bash install_6.0.sh安装过程约需2-5分钟，成功后控制台会显示面板地址及初始账号密码。首次登录需在SSH终端执行bt default查看默认信息，强烈建议立即修改默认端口和密码。
注意：若访问面板出现安全警告，需检查服务器安全组是否放行8888端口。部分云厂商还需在控制台额外配置防火墙规则。
2. 运行环境可视化部署
2.1 基础软件栈安装
进入宝塔面板"软件商店"，依次安装以下组件：
| 组件名称 | 版本要求 | 安装方式 |
|---|---|---|
| Nginx | 1.20+ | 极速安装 |
| MySQL | 5.7+ | 编译安装 |
| Redis | 6.2+ | 极速安装 |
| Java项目管理器 | 最新版 | 插件安装 |
Java环境配置建议：
- 通过"Java项目管理器"安装OpenJDK 11
- 设置环境变量路径为
/usr/lib/jvm/java-11-openjdk - 在终端验证版本：
java -version
2.2 数据库初始化
在宝塔面板"数据库"模块创建新数据库，关键参数配置：
CREATE DATABASE `jeecg_boot` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;通过phpMyAdmin导入官方提供的SQL脚本（位于jeecg-boot/db目录），导入时需注意：
- 选择UTF8mb4编码
- 关闭外键检查选项
- 按脚本编号顺序执行
3. 前后端项目部署实战
3.1 前端Vue项目部署
- 本地开发环境打包：
# 在jeecgboot-vue3目录下执行 pnpm install && pnpm run build生成的dist目录包含所有静态资源文件
- 宝塔面板操作流程：
- 创建新网站（暂不绑定域名）
- 删除默认生成的
index.html - 上传dist文件夹内全部内容到网站根目录
- 配置Nginx反向代理：
location / { try_files $uri $uri/ /index.html; } location /jeecg-boot { proxy_pass http://localhost:8080/jeecg-boot; proxy_set_header Host $host; }3.2 后端SpringBoot部署
- 项目打包准备：
- 修改
application-prod.yml中的数据库连接信息 - 确保redis配置与服务器一致
- Maven执行
clean package -Pprod
- 宝塔面板部署步骤：
- 通过"Java项目管理器"新建项目
- 上传生成的
jeecg-system-start-3.6.1.jar - 配置启动参数：
--server.port=8080 --spring.profiles.active=prod - 内存分配建议：2G堆内存（-Xmx2048m）
常见问题：若启动时报数据库连接失败，检查MySQL是否开启远程连接权限，执行：
GRANT ALL PRIVILEGES ON jeecg_boot.* TO 'root'@'%' IDENTIFIED BY 'yourpassword'; FLUSH PRIVILEGES;
4. 域名与HTTPS安全配置
4.1 域名解析与绑定
在域名管理后台添加A记录指向服务器IP后，宝塔面板操作：
- 进入"网站"模块点击对应站点设置
- 在"域名管理"添加带www和不带www的域名
- 开启强制HTTPS跳转（需先完成SSL证书部署）
4.2 Let's Encrypt证书申请
宝塔内置SSL证书申请功能：
- 选择"Let's Encrypt"免费证书
- 勾选需要绑定的域名
- 选择文件验证方式（需确保域名已解析生效）
- 开启HTTP/2和TLS 1.3协议
证书自动续签配置：
- 在面板"计划任务"中添加类型为"Shell脚本"的任务
- 设置每月执行一次：
/usr/local/nginx/sbin/nginx -s reload
4.3 安全加固建议
- 修改宝塔面板默认入口路径
- 开启BasicAuth认证访问限制
- 配置Nginx防注入规则
- 设置MySQL定期自动备份
在项目成功运行后，建议通过宝塔的"监控"功能持续观察服务器资源占用情况。对于访问量逐渐增大的系统，可考虑：
- 升级服务器配置
- 开启Redis缓存加速
- 配置CDN静态资源分发
- 使用宝塔的负载均衡插件扩展后端节点