跨平台Markdown写作软件：小书匠

news2024/12/25 22:15:01

在这里插入图片描述

本文软件由好友 Eduna 推荐；

什么是小书匠？

小书匠是一款本地优先，去中心化，分布式，支持选择性同步的全平台覆盖笔记软件，是专注于 markdown 写作的客户端编辑器。它支持多种平台，包括 Windows、Mac、Linux 和 Android，并且还提供了 Docker 自部署版本，方便用户在自己的服务器上部署和管理。

在开始折腾前，建议看看官方的视频，会解答你的很多疑问，比如软件是怎么实现的去中心化，又是如何实现分布式的，包括同步的方式等等

小书匠架构介绍，一款本地优先，去中心化，分布式，支持选择性同步的专业知识管理工具

如果不想折腾，也可以去先进行在线体验：https://markdown.xiaoshujiang.com

安装

在群晖上以 Docker 方式安装。

小书匠的 Docker 又分为两个版本，天马版（suziwen/pegasus） 和 天马飞天版（suziwen/dragon） ，从功能上来说，天马飞天版 提供了服务器文章管理，比如服务器全文搜索（lucene），因此可能会需要更高一点的性能要求。

如果你只是想要多端同步，天马版 完全满足你的需求。如果想把服务器做为自己的数据中心，并且想要更好的管理文章，可以考虑使用 天马飞天版。

这里老苏采用的是 天马飞天版（suziwen/dragon）。

在注册表中搜索 dragon ，选择第二个 suziwen/dragon，版本选择 latest。

本文写作时， latest 版本对应为 1.5.0；

卷

在 docker 文件夹中，创建一个新文件夹 xsj，并在其中建一个子文件夹 data

文件夹	装载路径	说明
`docker/xsj/data`	`/opt/couchdb/data`	存放数据文件
`docker/xsj/indexes`	`/opt/couchdb-lucene/indexes`	存放索引文件

端口

本地端口不冲突就行，不确定的话可以用命令查一下

# 查看端口占用
netstat -tunlp | grep 端口号

本地端口	容器端口
`5083`	`80`

默认暴露了 4 个端口，但官方也没介绍，只知道 5984 是 couchdb 数据库的端口，但官方并不建议直接对外开放 5984 端口

所以老苏只留了一个 Web 端口

环境

可变	值
`COUCHDB_USER`	例如设为 `laosu`
`COUCHDB_PASSWORD`	例如设为 `password`

这两个变量是 couchdb 数据库的用户名及密码，都有默认值

可以根据自己的需要进行修改

如果你希望页面需要登录才能访问，可以增加 NGINX_USER 和 NGINX_PASSWORD，如果有一个值为空，表示可以直接访问，不需要登录。

命令行安装

如果你熟悉命令行，可能用 docker cli 更快捷

# 新建文件夹 xsj 和 子目录
mkdir -p /volume1/docker/xsj/{data,indexes}

# 进入 xsj 目录
cd /volume1/docker/xsj

# 运行容器
docker run -d \
   --restart unless-stopped \
   --name story-writer \
   -p 5083:80 \
   -v $(pwd)/data:/opt/couchdb/data \
   -v $(pwd)/indexes:/opt/couchdb-lucene/indexes \
   -e COUCHDB_USER=laosu \
   -e COUCHDB_PASSWORD=password \
   suziwen/dragon:latest

也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件

version: '3'

services:
  story-writer:
    image: suziwen/dragon:latest
    container_name: story-writer
    restart: unless-stopped
    ports:
      - "5083:80"
    volumes:
      - ./data:/opt/couchdb/data
      - ./indexes:/opt/couchdb-lucene/indexes
    environment:
      - COUCHDB_USER=laosu
      - COUCHDB_PASSWORD=password

然后执行下面的命令

# 新建文件夹 xsj 和 子目录
mkdir -p /volume1/docker/xsj/{data,indexes}

# 进入 xsj 目录
cd /volume1/docker/xsj

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d