Obsidian+群晖Webdav+Docsify在线文档同步

前言

Obsidian用于知识输入和记笔记，但有时候需要分享和手机上查看不是很方便。所以产生了想要弄个在线博客或者wiki的想法。

考虑需求后找到了两个合适直接使用 markdown 文件的方案：

• Hexo -- 静态在线博客

• Docsify -- 在线文档

考虑到Hexo还需要提交操作（可用脚本实现自动部署），本人这么懒能省一步是一步，所以放弃Hexo选择了Docsify。

• 实现自动同步方案：

  • Obsidian输入 >> 插件Webdav自动同步 >> 群晖文件同步至Docsify。

  • 这里如果选择直接使用群晖做Webdav服务器，可以忽略阿里云盘和CloudSync套件安装和设置，直接将Docsify容器的docs文件夹映射到Obsidian的同步文件夹即可。

一、前期准备

1. Obsidian 插件安装

Obsidian设置啥的B站上有好多很棒的教程，这里就不再赘述了放上链接：

• 二一的笔记Obsidian新手教程

• 清单控沙牛Obsidian公开课

1.1 Remotely Save 插件

在Obsidian第三方插件中选择社区插件市场浏览，搜索 Remotely Save 并安装（需要科学大家懂的吧）。 插件设置 >> 选择远程服务 >> Webdav ，输入对应的服务器地址、用户名和密码等（后面在群晖里面设置）。

2. 群晖套件安装及设置

2.1 矿神源设置

用于各种扩展套件安装。

• 官方链接 ，群晖套件中心 >> 设置 >> 套件来源 >> 新增。

• 输入名称（自定义）和位置：https://spk7.imnks.com/ ，注意位置这里是要根据自己的群晖版本选择，具体可以看官方介绍。

2.2 Webdav套件安装

用于实现Obsidian的同步。

• 套件中心 >> 社群 >> 阿里云盘Webdav （这里可以自行选择其他Webdav服务）。

• 阿里云盘Webdav设置教程。

• 完成后可以使用DDNS进行域名和公网IP的绑定，加反向代理/端口映射等进行外网访问；或者使用内网穿透（教程很多不赘述）。

• 在Obsidian中可以先进行一次同步。

2.3 Cloud Sync 套件安装及设置

用于Webdav文件和本地文件进行同步。

• 套件中心 >> Cloud Sync 安装

• Cloud Sync >> 添加 >> 选择Webdav >> 填写对应服务器地址(建议直接填写局域网地址)、账户、密码。

• 选择对应本地文件夹和远程文件夹进行同步。

• 其中 /docker/docs 为Docsify容器的映射目录（后面安装Docsify时会提到），可以提前新建文件夹。

  注意：我的文件全都是放在library里面所以只同步这一个文件夹，如果想要同步所有Obsidian库可以使用上一级文件夹。

二、Docsify安装及配置

终于到正题了，放上 官方文档，用于Obsidian同步在线展示和查看。

1. 部署前准备

通过ssh进入群晖，全局安装 docsify-cli 工具，执行以下命令：

sudo -i # 输入群晖密码 npm i docsify-cli -g

初始化项目文件

# 进入docs的上级文件夹 cd /volume1/docker/ # 初始化项目 docsify init ./docs

初始化成功后可以看到 docs 目录下的几个文件。

• index.html 入口文件

• README.md 主页内容渲染

• .nojeky11 用于阻止 GitHub Pages 忽略掉下划线开头的文件（目前用不到）

2. Docker部署Docsify

• 在 docs 文件夹下创建 Dockerfile 文件。

FROM node:latest LABEL description="A demo Dockerfile for build Docsify." WORKDIR /docs RUN npm install -g docsify-cli@latest EXPOSE 3000/tcp ENTRYPOINT docsify serve .

• 构建 docker 镜像，注意最后面那个 . 不要漏掉。

docker build -f Dockerfile -t docsify/demo .

• 运行 docker 镜像。

• 其中 -v /volume1/docker/docs:/docs 为 -v [群晖docs文件夹位置]:/docs 可以自行修改为你的docs文件夹位置。

docker run -itp 3000:3000 --name=docsify -v /volume1/docker/docs:/docs docsify/demo

• 成功后可以使用 群晖IP:3000 查看 Docsify 界面了。

• 同样需要外部访问请参考DDNS和内网穿透教程，万能的值友们。

3. Docsify配置

3.1 Sidebar 边栏菜单配置

这时是默认显示的页面，可以在 index.html 文件中添加

• 在 docs 文件夹下，新建 _sidebar.md 文件 , 并将对应的菜单页面已 markdown 的链接语法写入即可。

• guide.md 为自定义导航页，也可以自己定义其他命名。

3.2 Search 搜索配置

添加搜索，在 index.html 文件中添加

由于个人需求就这些功能够用了，后续的配置就没怎么去折腾了，Docsify还有很多其他的自定义配置可以参考官方文档进行配置。 这里附上B站配置教程链接，有兴趣的小伙伴可以自行去看哈。

• Docsify简易配置 up主：-相依-

• Docsify详细配置 up主：程序猫大刚

附上效果图：

不知道为啥zdm后台输入代码有bug一直不显示，弄了一个小时人麻了，后面就用图片代替了，建议配置方面直接去看上面的视频吧。。。

作者声明本文无利益相关，欢迎值友理性交流，和谐讨论～