Skip to content
使用 Jar 包部署

该种方式适合物理机中已经有 JDK8 + MySQL8,仅需要 Jar 包进行部署的场景。

创建数据库

你需要在 MySQL 中先创建一个数据库,数据库名称需要与启动参数 --spring.datasource.url 配置的数据库名称相同,如果不需要自定义数据库名称,你可以直接使用如下语句创建数据库:

sql
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,需要把每一行末尾的\删除,并将所有命令写成一行。

bash
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

bash
#!/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,如果返回以下内容,则说明部署成功。

json
{
  "code": "AUTH-40101",
  "msg": "无效的授权信息",
  "ex": "无效的授权信息",
  "data": null
}
{
  "code": "AUTH-40101",
  "msg": "无效的授权信息",
  "ex": "无效的授权信息",
  "data": null
}

该提示意思是你没有登录,现在就可以使用客户端登录使用了。

安装客户端并登录

部署成功后即可使用客户端登录,Blossom 提供了两种客户端。

  1. 下载 PC 桌面客户端
  2. 使用自带的网页客户端。

网页客户端地址为: 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的用户

查看如何修改及创建用户?

快速设置

如果你是初次使用,那么在页面的右上角会看到如下提示。

点击黄色闪烁图标,会进入如下页面。

点击上方任意一个红色框,即可开始快速配置。

点击【是】,进入博客配置。

通常情况下点击【确认使用自带博客】,即可配置完成。

Blossom 官方文档