支持全文搜索，实力超群的知识库+双链+md编辑器—小书匠

大家好，这里是Cherry，喜爱折腾、捡垃圾、玩数码，热衷于分享数码玩耍经验~

前言

cherry用过不少的软件来书写我的文章，到目前，用的最多的肯定还是markdown格式的文档了，市面上有很多基于markdown格式的文档编辑器，比如ob、思源、blossom等。

最近，cherry又发现了一款很不错的双链笔记+MD编辑器项目——小书匠。该项目是一款去中心化、分布式的知识管理笔记软件，支持Windows、macOS、Linux、iOS和Android多平台使用，并可实现选择性同步。

这款软件提供了强大的编辑功能，包括多光标编辑、代码高亮和语法检查等，可以在一个界面中实现所见即所得的编辑体验。此外，还支持多种文件存储方式，用户可以根据个人需求选择合适的存储方案。

今天，我们主要介绍如何在NAS段安装小书匠的docker版本，该项目docker一共分为天马版和天马飞天版，前者拥有基础功能，后者则在其基础上增加了全文检索能力。本文以天马飞天版为基础进行介绍。

项目特性：

关于部署机

本次项目使用大家熟悉的极空间部署，个人目前使用的是极空间Z423标准版。极空间Z423标准版采用R5 5625U处理器，6核12线程，最高支持64GB DDR4 3200Mhz内存，性能强劲，足以满足各式各样的虚拟机、容器、服务使用，可以说是新人入手即养老。

极空间近期推出了两款全新型号的NAS，第一款极空间Q4，搭载N95处理器，预装8G DDR4内存（最大支持16G），是首款集成了U2/SATA专业硬盘的NAS，拥有4个机械盘位（SATA3 x2；U.2/SATA x2），2个M.2盘位。在网络与数据接口上，包含1个2.5G网口、1个USB3.2 Gen2 Type-C、1个USB3.2 Gen2 Type-A，新品到手价不高于1899！！

另外一款是极空间T2的升级款——极空间T2S，采用RK3588C处理器，4大核4小核的8核配置，AI计算能力位6TOPS，板载8G DDR4X内存，单2.5G网口，1个HDMI输出（可直连电视播放），双M.2 PCIe3.0 SSD盘位。本次T2S核心升级就是内置UPS，可供T2S断电后继续使用数十分钟，搭配内置的WIFI/WLAN模式，可以轻松满足户外使用需求。

此外，极空间T2S还内置安卓模拟器，最大支持同时运行6个独立的虚拟安卓手机，官方测试农药可60FPS游玩，满足多机党的需求。

一、部署系统

1、下载/导入镜像

如果网络好的可以直接下载镜像 suziwen/dragon:latest 镜像。网络不好的可以下载网盘里的镜像包，然后上传到极空间中，并通过 镜像-本地镜像-导入镜像-从极空间导入 。

2、部署项目

镜像下载/导入完成以后， 选择镜像并添加到容器 ，或双击生成容器。

小书匠 天马飞天版 对cpu和内存有一定要求，最低1核510Mb，建议1核1G，所以建议这里取消性能限制。

【文件夹路径】：小书将天马飞天版一共有两个装在路径，分别是索引文件 /opt/couchdb-lucene/indexes ，文档（数据库）文件 /opt/couchdb/data 。

我们在常用的docker目录下新建一个文件夹，取名 story-writer ，然后再其下新建，两个子文件夹，分别映射到索引路径、文档路径下。

【端口】：项目默认提供4369、5984、80、9100四个端口，其中4369和9100端口删除，80端口对应的是webui，5984端口对应的是数据库端口。官方建议大家为了数据安全，不要开放5984端口，所以我们把这条也删除，只保留一个80端口。

最终保留的80端口，在本地端口随便映射一个不冲突的端口就行了，我这里映射了30080。

【环境】：环境变量中，可以更改的是数据库的账号密码，即我蓝框内的。另外需要新增两行，作为webui登录的账号密码（如果webui这两行不增加，则默认无需登录即可打开系统）。

3、设置远程服务

至此，我们已经完成小书将项目的部署。后续建议使用极空间内置的远程访问服务，新建一个链接，输入lucky的地址127.0.0.1:30080保存。

二、系统体验

小书匠客户端除了我们本次部署的docker版本外，还包括windows客户端、mac客户端、linux客户端。其中windows客户端安装文件我也一并放到网盘里了，和docker版本还是有所区别的，后面我也会介绍到。

1、系统简介

登录系统以后，可以看到整个页面分为四个区域。左一是文档列表区、左二是编辑视图、右二是当前页面快速定位、右一是阅读视图。

系统默认创建了三个文档，分别是更新内容、软件使用手册、语法使用手册，具体内容这里就不赘述了，反正是围绕md格式。

在系统正上方，除了标签分类外，还可以切换到编辑分类，在这里可以增加drawio、表格、排序等等内容，在一个新建窗口编辑完成后会自动加入到当前编辑页，不仅方便，而且对格式排版很有帮助。

不过也因为这个原因，工具偏多，上手需要一定的时间。

天马飞天版，相较于天马版，就是多了一个全文搜索功能，点击搜索按钮，支持文字、tag、时间等内容进行全文检索。

最后，该项目支持将文档导出为md、html、zip、png以及自定义模式，也支持一键发布到各类blo地址。

2、关于数据库配置

点击左上角的项目logo，我们可以切换到系统后台，在这里我们可以配置模板、片段，设置数据、导入、导出等。

我们选择数据功能，可以看到默认的非结构化数据库中，我们可以压缩数据（类似归档）、导入数据库、导出数据库、重置数据库等操作，支持外部数据库调用。

除了数据库之外，还有一个索引页面，在这里会根据条件自动生成文本索引，也就是我们全文搜索的基础。我们也可以根据自己的规则进行更改、自动生成。

3、关于文档保存

文档除了会自动保存到数据库外，还支持使用外部存储来保存，docker版本目前仅支持webdav格式。

所以首先我们得开通极空间的webdav功能，打开系统设置-文件及共享服务-webdav，选择开启，并且按照自己的习惯修改HTTP/HTTPS端口。极空间十分贴心的给出了webdav的URL地址，我们点击图中蓝色的 复制 按钮，将URL复制备用。

接着，且回到系统后台，选择绑定。

在这里，我们选择webdav文件系统，点击新增，将刚才复制的URL黏贴到webdav api处，然后在用户名处填写手机号，密码处填写登录密码并确定保存。

后续，当我们需要保存文档时，只需要点击另存为按钮。

在弹框的webdav页面，可以任意选择极空间私有云的云存储空间，这样我们所有的文档数据就有了一个双重备份了。

4、关于桌面客户端

前面提到，小书匠还有一个桌面客户端，大家可以从网盘下载后安装使用。目前桌面客户端的功能相较于docker版本会增加很多，主要在第三方数据保存以及数据库管理、模板等方面。

客户端可用的模板列表，内容还是相当丰富。

以第三方数据为例，这里支持主流的知识库/笔记软件，支持将数据一键备份到其对应的存储空间中。还支持更改图床地址，比如码云、七牛等都支持。

在数据库功能中，客户端版本也支持开启web服务。

而且客户端有一个核心功能，那就是文档的数据同步，不过该功能是收费项目，docker版本只能作为数据库服务器使用。

想在小书匠客户端⁠使用该版本内置的 couchdb 数据库时，我们使用的api接口是【http://ip:80/data/user_1】，然后再小书匠客户端对应的位置【图中的2】填写即可，也支持使用服务器的全文搜索功能。

5、关于会员服务

既然提到会员服务，这里顺便截个图，把小书匠免费版和收费版的功能都展示一下，该项目收费为40/年的订阅制。

这个价格肯定是不贵的，至于和思源比起来的话便宜了太多太多了，但是和OB比起来又显得有些贵，仁者见仁吧。

不过针对教育用户，只要使用带有域名的邮箱用户，在完成邮箱验证后进行付款，成为小书匠会员后，自动奖励两年( 365*2 天)的会员时长。

最后

小书匠作为一款免费&收费并存的自托管markdown编辑器，既是一款知识库管理工具，又是一款双链笔记工具。整个项目给人的初体验是有点复杂，界面也不优美，但是当熟悉使用后，却能发现其不仅功能强大，而且界面交互又刚刚好。

在3、4天的粗浅体验后，我最终还是选择了客户端版本，因为它的支持以及功能比docker版本强大的多，最终的docker版本则被我单独做成了数据库服务器，以实时保存我的文档数据。

如果你对目前使用是双链笔记或者md编辑工具不满意，又想尝试一些新的工具，那小书匠则是你不得不体验一下的项目。