使用 Dockerhub 公共镜像

Blossom 依赖 JDK8 + MySQL8。如果你拉取镜像缓慢，也可以通过百度网盘下载镜像文件。

【可选】拉取 MySQL 镜像并启动

如果已安装数据库，可以跳过该步骤。

docker pull mysql:8.0.31

docker pull mysql:8.0.31

启动镜像，注意挂载路径，否则容器删除后数据将丢失。

docker run \
-d \
--name mysql \
#【可选修改】数据库 root 用户的密码 
-e MYSQL_ROOT_PASSWORD=jasmine888 \
-p 3306:3306 \
#【需修改】挂载数据库文件保存路径。 
# 注意：只需要将冒号前的路径改为你 Docker 所在设备的某个路径，不要修改冒号后面的内容。 
-v /usr/local/docker/mysql/data:/var/lib/mysql \
-v /usr/local/docker/mysql-files/log:/var/lib/mysql-files \
-v /usr/local/docker/mysql/log:/var/log/mysql \
mysql:8.0.31

docker run \
-d \
--name mysql \
#【可选修改】数据库 root 用户的密码 
-e MYSQL_ROOT_PASSWORD=jasmine888 \
-p 3306:3306 \
#【需修改】挂载数据库文件保存路径。 
# 注意：只需要将冒号前的路径改为你 Docker 所在设备的某个路径，不要修改冒号后面的内容。 
-v /usr/local/docker/mysql/data:/var/lib/mysql \
-v /usr/local/docker/mysql-files/log:/var/lib/mysql-files \
-v /usr/local/docker/mysql/log:/var/log/mysql \
mysql:8.0.31

如果你使用的是 Windows，可能无法识别每一行命令后的\，所以你需要将命令写为一行，如下：

docker run -d --name mysql -e MYSQL_ROOT_PASSWORD=jasmine888 -p 3306:3306 -v /usr/local/docker/mysql/data:/var/lib/mysql -v /usr/local/docker/mysql-files/log:/var/lib/mysql-files -v /usr/local/docker/mysql/log:/var/log/mysql mysql:8.0.31

docker run -d --name mysql -e MYSQL_ROOT_PASSWORD=jasmine888 -p 3306:3306 -v /usr/local/docker/mysql/data:/var/lib/mysql -v /usr/local/docker/mysql-files/log:/var/lib/mysql-files -v /usr/local/docker/mysql/log:/var/log/mysql mysql:8.0.31

注意

如果命令错误：1. 请将命令中的注释删除。2. 将每一行后的斜杠\删除。3. 将所有命令写为一行。

创建数据库

无论你是否曾经安装过数据库，你都需要在 MySQL 中创建一个数据库，数据库名称需要与启动容器命令中参数 --spring.datasource.url 配置的数据库名称相同，如果不需要自定义数据库名称，你可以直接使用如下语句创建数据库。

CREATE DATABASE `blossom` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;

CREATE DATABASE `blossom` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;

提示

如果你不知道如何创建数据库，可查看如何在 Docker 中创建数据库。

拉取应用镜像

docker pull jasminexzzz/blossom:latest

docker pull jasminexzzz/blossom:latest

启动应用容器，注意修改其中标识为红色背景的内容。

docker run -d \
  # 容器名称
  --name blossom-backend \
  # 指定端口映射
  -p 9999:9999 \
  #【需修改】挂载图片保存路径，如果是 windows 环境，可以使用 /c/home/bl/ 来指定磁盘 
  # 注意：只需要将冒号前的路径改为你 Docker 所在设备的某个路径，不要修改冒号后面的内容。 
  -v /home/bl/:/home/bl/ \
  # 启动的镜像名称
  jasminexzzz/blossom:latest \
  #【需修改】配置数据库访问地址
  --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

docker run -d \
  # 容器名称
  --name blossom-backend \
  # 指定端口映射
  -p 9999:9999 \
  #【需修改】挂载图片保存路径，如果是 windows 环境，可以使用 /c/home/bl/ 来指定磁盘 
  # 注意：只需要将冒号前的路径改为你 Docker 所在设备的某个路径，不要修改冒号后面的内容。 
  -v /home/bl/:/home/bl/ \
  # 启动的镜像名称
  jasminexzzz/blossom:latest \
  #【需修改】配置数据库访问地址
  --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. 将所有命令写为一行。

Windows 平台无法识别命令后的\，所以需要在控制台输入下列命令：

docker run -d --name blossom-backend -p 9999:9999 -v /home/bl/:/home/bl/ jasminexzzz/blossom:latest --project.iaas.blos.domain="http://127.0.0.1:9999/pic/" --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

docker run -d --name blossom-backend -p 9999:9999 -v /home/bl/:/home/bl/ jasminexzzz/blossom:latest --project.iaas.blos.domain="http://127.0.0.1:9999/pic/" --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

警告

注意修改配置项 -v /home/bl/:/home/bl/ 的文件挂载路径，否则容器删除的同时会删除保存的图片信息。

查看配置项是否正确

你可以输入以下命令，在容器日志中查看你修改后的配置项是否正常生效：

docker logs blossom-backend

docker logs blossom-backend

在启动日志的最上方会显示你配置的各项参数。

检查是否启动成功

方法一：查看日志

你可以输入以下命令，在容器日志中查看容器是否启动成功：

docker logs blossom-backend

docker logs blossom-backend

如果日志的最底部显示以下内容，则说明容器启动成功。

方法二：直接访问

例如你部署在本地，则可以访问127.0.0.1:9999，如果返回以下内容，则说明部署成功。以下内容是提示没有登录，现在可以使用客户端登录使用。

{
  "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的用户。

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

快速设置

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

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

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

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

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

• 更多关于快速设置的功能可查阅设置。
• 更多关于博客的配置信息可查阅博客/移动端页面。