Blossom：开源私有部署的云端双链markdown笔记软件

在信息化、数字化时代，我们每个人的生活和工作都离不开笔记和知识管理。从简单的待办事项，到复杂的项目计划，再到存储大量个人知识的工具，如何选择一个高效、便捷且符合个人需求的笔记软件，成了许多人的难题。最近在逛github的时候发现了一个开源项目Blossom。Blossom 是一款功能强大的开源笔记软件，它支持私有部署。Blossom 的最大特点是，你可以将笔记、图片、个人计划等数据保存在自己的服务器中，并在任意设备间进行实时同步。更重要的是，Blossom 还是一个动态博客平台，允许你在记录笔记的同时，直接分享和展示个人博客内容。

在本文中，我们将详细介绍 Blossom 的主要特点及其优势，以及如何通过私有部署来充分发挥它的潜力。

# 项目介绍

Blossom 是一个支持私有部署的云端双链笔记软件，你可以将你的笔记，图片，个人计划安排保存在自己的服务器中，并在任意设备之间实时同步。同时还是一个动态博客。

支持 Windows，Mac，网页客户端，网页移动端。

目前在github上已有3.1k star

官方文档：https://www.wangyunf.com/blossom-doc/ (opens new window)

试用地址：https://www.wangyunf.com/blossom-demo/#/settingIndex (opens new window)

github地址：https://github.com/blossom-editor/blossom (opens new window)

# Blossom 的特点

完善的文件关系 Blossom 不依赖任何三方存储和图床，其本身就是一个图床，并且提供了完善的图片管理，防勿删，以及图片和文章的双向关系绑定。

基于 Markdown 编写，没有破坏性的语法拓展，在这里编写的内容在任何 Markdown 软件中都能正常显示。

快速迁移

所有图片和文章都支持一键备份和导出，可以在几分钟内轻松迁出。导出的文件可以无缝使用本地软件正常打开。

丰富的附加功能 📅 计划安排 🏷️ 待办事项 🎫 快捷便签 🍅 番茄钟 🧰 多用户、字数统计、字数折线图、编辑热力图、天气预报、主题设置...

Blossom 拥有丰富的功能，不仅仅是知识管理，更是一个可以供多人同时使用的全面实用性工具。我比较喜欢这个项目是因为我们刷手机的时候经常会遇到一些有意思的项目或者知识，手机截图后经常就会忘记，有了这个项目之后我们可以在手机截图之后在浏览器中打开我们的系统，将图片上传到系统之后在记一个代办事项，那么我们就可以在闲暇的时候研究下这些知识了。

# 项目部署

我此处使用的是docker-compose的方式部署的，因为我有现成的mysql数据库，所以此处不需要在额外部署mysql了。

首先我们在服务器上创建一个部署目录blossom,在此目录下创建一个docker-compose.yml文件，内容如下

version: "3.8"
services:
  blossom:
    image: jasminexzzz/blossom:latest
    container_name: blossom-backend
    volumes:
      # 【需修改】挂载图片保存路径，如果是windows环境，可以使用/c/home/bl/img/来指定磁盘
      - ./bl/:/home/bl/
    environment:
      # 配置数据库访问地址
      SPRING_DATASOURCE_URL: jdbc:mysql://192.168.10.20:3306/blossom?useUnicode=true&characterEncoding=utf-8&allowPublicKeyRetrieval=true&allowMultiQueries=true&useSSL=false&&serverTimezone=GMT%2B8
      # 【需修改】配置数据库用户名
      SPRING_DATASOURCE_USERNAME: root
      # 【需修改】配置数据库密码
      SPRING_DATASOURCE_PASSWORD: 123456
      # 【需修改】配置图片上传后对应生成的访问 URL，需要以/pic/结尾。注意，该访问域名(IP:端口)需要与访问后台的域名(IP:端口)相同
      PROJECT_IAAS_BLOS_DOMAIN: http://192.168.10.20:9999/pic/
      # 配置图片保存的磁盘路径，并在 volumes 中将该路径挂载为本地路径，如上方 volumes 中的示例
      PROJECT_IAAS_BLOS_DEFAULT-PATH: /home/bl/img/
    ports:
      - "9999:9999"
    networks:
      - blossomnet
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:9999/sys/alive"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 5s
    restart: always
networks:
  blossomnet:
    driver:
      bridge