收起左侧

超实用!在 NAS 实现自动备份语雀文档,小白也能3分钟搞定!

0
回复
333
查看
[ 复制链接 ]

105

主题

11

回帖

0

牛值

fnOS系统内测组

fnOS1.0上线纪念勋章社区上线纪念勋章

YuqueSync:

一款跨平台的语雀文档同步工具。支持实时监控、多格式导出、知识库完整备份,确保您的知识资产安全无忧。

主要特性:

  • • 智能同步引擎:实时监控语雀文档变更,自动更新本地备份
  • • 多格式导出:支持 PDF 和 Markdown 两种导出格式
  • • 知识库整体同步:一次性同步整个知识库,无需逐个操作
  • • 智能变更检测:精准识别文档更新,避免重复下载
  • • 保留原文档格式:完整保留原始文档样式和结构
  • • Docker 部署:开箱即用,支持容器化部署

准备

部署前需要先获取语雀凭证,打开你需要同步的知识库网址(例如:https://www.yuque.com/david-gshie/nasbox)

按 F12 右侧就会出现开发者工具,切换到网络(Network)

刷新页面会出现很多信息,点击搜索按钮

搜索 yuque_ctoken 和 _yuque_session(两个都在一起的,搜索其中一个就行),回车确定就能找到了

选择出现在 Cookie 里的,复制 Cookie 到空文本里

在里面找到 yuque_ctoken 和 _yuque_session 两个参数的值

安装

Docker Compose

services:
  yuque-sync:
    image: heizi**/yuque-sync:latest
    container_name: yuque-sync
    environment:
      - YUQUE_TOKEN=你的token
      - YUQUE_SESSION=你的session
    volumes:
      - ./data:/data
    restart: always

参数说明(更多参数建议去看文档)

:::YUQUE_TOKEN(环境变量):语雀 Token

YUQUE_SESSION(环境变量):语雀 Session

YUQUE_BASE_URL(环境变量,可选):语雀网站地址

SAVE_PATH(环境变量,可选):文档保存路径

MONITOR_INTERVAL_MINUTES(环境变量,可选):同步间隔(分钟)

EXPORT_FORMAT(环境变量,可选):导出格式 (pdf/markdown)

:::

使用

目前还没有可视化界面,只能看容器的运行日志

能看到已经识别到知识库,并且开始下载了

来到映射的目录,知识库的文档都同步下载

整体效果还是很不错,排版和代码都没乱,图片这些也都全(不过行与行之间空格间距有点问题)

总结

总的来说,这款语雀文档本地同步工具还是非常实用的,平时部署放着就能自动将云端文档同步到本地。云端服务再怎么安全,也比不上保存在本地来的踏实放心,多一个备份还是很有必要的。上面我演示下载的是 pdf 格式,基本上是没有什么问题的,但如果改为 md 格式的话,会有文档里引用的图片是链接,而不是本地图片的问题。希望开发者后面可以加上可视化操作界面,配置参数也能更加方便,还有就是优化 md 格式下载的问题,毕竟都是希望数据可以完全离线的。

综合推荐:⭐⭐⭐⭐(语雀用户推荐部署)

使用体验:⭐⭐⭐(想法很好,不过还不完善)

部署难易:⭐⭐(简单)︎

收藏
送赞
分享
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则