该种方式适合物理机中已经有 JDK8
+ MySQL8
,仅需要 Jar 包进行部署的场景。
创建数据库
你需要在 MySQL 中先创建一个数据库,数据库名称需要与启动参数 --spring.datasource.url
配置的数据库名称相同,如果不需要自定义数据库名称,你可以直接使用如下语句创建数据库:
CREATE DATABASE `blossom` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;
CREATE DATABASE `blossom` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;
下载 Jar 包
前往下载 Jar 包:https://github.com/blossom-editor/blossom/releases
部署 Jar 包
将 Jar 包上传到服务器中,在 Jar 包所在路径下使用如下命令进行部署。如果使用 Windows,需要把每一行末尾的\
删除,并将所有命令写成一行。
java -jar ./backend-blossom.jar \
# 如果 9999 端口已被占用,注意修改
--server.port=9999 \
#【需修改】配置图片保存的磁盘路径
--project.iaas.blos.default-path="/home/bl/img" \
#【需修改】配置数据库访问地址
--spring.datasource.url="jdbc:mysql://192.168.31.99:3306/blossom?useUnicode=true&characterEncoding=utf-8&allowPublicKeyRetrieval=true&allowMultiQueries=true&useSSL=false&&serverTimezone=GMT%2B8" \
#【需修改】配置数据库用户名
--spring.datasource.username=root \
#【需修改】配置数据库密码
--spring.datasource.password=jasmine888 &
java -jar ./backend-blossom.jar \
# 如果 9999 端口已被占用,注意修改
--server.port=9999 \
#【需修改】配置图片保存的磁盘路径
--project.iaas.blos.default-path="/home/bl/img" \
#【需修改】配置数据库访问地址
--spring.datasource.url="jdbc:mysql://192.168.31.99:3306/blossom?useUnicode=true&characterEncoding=utf-8&allowPublicKeyRetrieval=true&allowMultiQueries=true&useSSL=false&&serverTimezone=GMT%2B8" \
#【需修改】配置数据库用户名
--spring.datasource.username=root \
#【需修改】配置数据库密码
--spring.datasource.password=jasmine888 &
注意
如果命令错误:1. 请将命令中的注释删除。2. 将每一行后的斜杠\
删除。3. 将所有命令写为一行。
参数说明:
参数 | 说明 |
---|---|
--server.port | 【可修改】应用端口 |
--project.iaas.blos.default-path | 【需修改】配置图片保存的磁盘路径 |
--spring.datasource.url | 【需修改】配置数据库访问地址 |
--spring.datasource.username | 【需修改】配置数据库用户名 |
--spring.datasource.password | 【需修改】配置数据库密码 |
使用脚本部署
除了使用上述命令启动 Jar 包之外,你也可以使用如下脚本,该脚本会自动关闭当前运行的后台程序,并重启当前路径下的 Jar 包。
脚本地址:https://github.com/blossom-editor/blossom/blob/dev/blossom-backend/script/restart-springboot.sh
#!/dash
# 重启 blossom
pid=`ps aux | grep backend-blossom.jar | grep -v grep | awk '{print $2}'`
echo "进程ID : " $pid
kill -9 $pid
echo "进程" $pid "已被杀死"
echo "开始重启 backend-blossom 服务器"
# 注意修改相关参数,与上方介绍的相同
nohup java -jar ./backend-blossom.jar --server.port=9999 --spring.datasource.url="jdbc:mysql://192.168.31.99:3306/blossom?useUnicode=true&characterEncoding=utf-8&allowPublicKeyRetrieval=true&allowMultiQueries=true&useSSL=false&&serverTimezone=GMT%2B8" --spring.datasource.username=root --spring.datasource.password=jasmine888 &
echo "backend-blossom 正在启动,请查看日志 ↓↓↓↓↓↓↓↓↓↓↓↓↓↓"
#!/dash
# 重启 blossom
pid=`ps aux | grep backend-blossom.jar | grep -v grep | awk '{print $2}'`
echo "进程ID : " $pid
kill -9 $pid
echo "进程" $pid "已被杀死"
echo "开始重启 backend-blossom 服务器"
# 注意修改相关参数,与上方介绍的相同
nohup java -jar ./backend-blossom.jar --server.port=9999 --spring.datasource.url="jdbc:mysql://192.168.31.99:3306/blossom?useUnicode=true&characterEncoding=utf-8&allowPublicKeyRetrieval=true&allowMultiQueries=true&useSSL=false&&serverTimezone=GMT%2B8" --spring.datasource.username=root --spring.datasource.password=jasmine888 &
echo "backend-blossom 正在启动,请查看日志 ↓↓↓↓↓↓↓↓↓↓↓↓↓↓"
查看配置项是否正确
在启动日志的最上方会显示你配置的各项参数。
检查是否启动成功
方法一:查看日志
如果日志的最底部显示以下内容,则说明应用启动成功。
方法二:直接访问
比方你部署在本地,则可以访问127.0.0.1:9999
,如果返回以下内容,则说明部署成功。
{
"code": "AUTH-40101",
"msg": "无效的授权信息",
"ex": "无效的授权信息",
"data": null
}
{
"code": "AUTH-40101",
"msg": "无效的授权信息",
"ex": "无效的授权信息",
"data": null
}
该提示意思是你没有登录,现在就可以使用客户端登录使用了。
安装客户端并登录
部署成功后即可使用客户端登录,Blossom 提供了两种客户端。
- 下载 PC 桌面客户端。
- 使用自带的网页客户端。
网页客户端地址为:
IP:端口(域名)/editor/#/settingindex
例如 IP:端口为
127.0.0.1:9999
,则访问http://127.0.0.1:9999/editor/#/settingindex
例如域名为
http://www.abc.com
,则访问http://www.abc.com/editor/#/settingindex
如果有配置反向代理路径,如
/bl/
,则访问http://www.abc.com/bl/editor/#/settingindex
注意!
这个地址是网页的的访问地址,不是登录地址!是填写在浏览器地址栏的地址!
打开客户端后,会进入登录页面。
在上方输入后台的访问地址,然后使用默认用户名密码进行登录
- 用户名为
blos
,密码为blos
注意!
访问地址中不包含/editor/#/settingindex
!!!
登录后建议将默认用户修改用户名和密码后,做为你的主账号使用,因为后台自带的博客端仅支持用户 ID 为1
的用户。
快速设置
如果你是初次使用,那么在页面的右上角会看到如下提示。
点击黄色闪烁图标,会进入如下页面。
点击上方任意一个红色框,即可开始快速配置。
点击【是】,进入博客配置。
通常情况下点击【确认使用自带博客】,即可配置完成。