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

YuqueSync：

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

主要特性：

• 智能同步引擎：实时监控语雀文档变更，自动更新本地备份

• 多格式导出：支持 PDF 和 Markdown 两种导出格式

• 知识库整体同步：一次性同步整个知识库，无需逐个操作

• 智能变更检测：精准识别文档更新，避免重复下载

• 保留原文档格式：完整保留原始文档样式和结构

• Docker 部署：开箱即用，支持容器化部署

准备

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

按 F12 右侧就会出现开发者工具，切换到网络（Network）

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

搜索 yuque_ctoken 和 yuquesession（两个都在一起的，搜索其中一个就行），回车确定就能找到了

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

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

安装

Docker Compose

services: yuque-sync: image: heizicao/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 格式下载的问题，毕竟都是希望数据可以完全离线的。

综合推荐：⭐⭐⭐⭐（语雀用户推荐部署）

使用体验：⭐⭐⭐（想法很好，不过还不完善）

部署难易：⭐⭐（简单）︎

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