新版宝塔面板已内置 Java 项目支持,如网站中无法添加 Java 项目,请更新到最新版本
1. 宝塔面板软件环境
1.1. 首先进入宝塔面板安装 MySQL,如下图所示。
1.2. MySQL 安装好以后添加数据库。请注意下图红圈处推荐使用 utf8mb4,其他无注意事项。数据库名、用户名、密码等根据需要设置,在安装 RB 时仅需填写对应的即可。
2. 下载 RB 安装包
2.1. 进入 REBUILD 官网 getrebuild.com 下载页面下载 Boot 安装包。
2.2. 将上一步下载的安装包上传至服务器(推荐上传至 /www/wwwroot/ 目录)。
3. 配置 Java 项目
3.1. 进入宝塔面板 - 网站 - Java项目(若无此功能请更新宝塔面板到最新版本),点击 [添加Java项目],然后参考以下截图进行设置,完成后点击 [提交] 即可。
- 项目jar路径:上一步骤上传的 RB Boot 安装包路径
- 项目端口:根据实际需要填写,请注意服务器防火墙需要开通相应端口,否则无法访问
- 项目JDK:默认情况下已安装(如未安装请自行安装)
- 开机启动:建议勾选开机启动
3.2. 至此已全部设置完成,点击下图中红圈可启动(或停止)。启动后可以通过服务器地址和上一步中的设置的端口号访问 RB,例如 http://139.196.49.101:8277/
4. 安装 RB
余下步骤请参考 RB 安装文档
5. 常见问题
如启动失败,可能是项目用户权限不足,可以尝试使用 root 用户
启动成功但无法访问
请确认防火墙是否开放了项目端口(包括本机端口和云主机端口)。
使用域名访问
在宝塔中开启外网映射并绑定域名即可使用域名访问。
启用 HTTPS 访问
HTTPS 具有较强的安全性,且 RB 中部分功能需要 HTTPS 才能支持,例如通知弹窗、摄像头拍照等。如需启用 HTTPS 访问,您需要首先使用域名访问,只有域名才能申请 HTTPS 证书。
首先,打开项目配置页进入 SSL - Let's Encrypt - 点击 [申请证书] 按钮。
如您已配置域名访问,此处会显示可用域名,请勾选要申请的域名并点击 [申请]。
宝塔会自动完成申请过程,请在申请完毕后点击 [保存] 即可。
启用 HTTPS 访问后部分页面无法打开
打开项目配置 - 配置文件,并将 proxy_set_header Host $Host:$server_port; 注释后保存,具体参照下图。
访问出现 403 Forbidden 错误
访问时出现以下错误,可能是因为宝塔的 Nginx 访问配置有误(部分宝塔版本不会自动生成配置),需要手动填写。
打开项目配置 - 配置文件 - nginx配置文件,并将以下代码复制过去(注意 58080 端口替换成你自己的)。
location / {
proxy_pass http://localhost:58080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header REMOTE-HOST $remote_addr;
add_header X-Cache $upstream_cache_status;
proxy_set_header X-Host $host:$server_port;
proxy_set_header X-Scheme $scheme;
proxy_connect_timeout 30s;
proxy_read_timeout 86400s;
proxy_send_timeout 30s;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
参考如下: