使用NAS部署Quartz 4：一站式教程助你快速搭建个人数字花园与知识管理网站

Quartz 是一款高效工具，能够帮助用户免费将个人笔记和数字内容发布为功能完整的网站。Quartz 第四版进行了全面重构，专注于提升最终用户的扩展体验与操作便捷性，适合各类知识管理和内容展示需求。

在线演示地址：
https://quartz.jzhao.xyz

温馨提示：
本教程使用的镜像是基于官方最新版本构建，不保证长期更新。如有后续需求，建议用户参考官方指南自行打包部署。

安装步骤详解

采用 Docker Compose 部署：

services:  
  quartz:  
    image: heizicao/quartz-4:latest  
    container_name: quartz  
    ports:  
      - 8080:8080  
    volumes:  
      - /vol1/1000/docker/quartz/content:/usr/src/app/content  
    restart: unless-stopped

参数释义（更多配置请查阅官方文档）：

• 端口 8080：用于网页访问
• 端口 3001（可选）：WebSocket 端口，具体用途可进一步探索
• 路径 /usr/src/app/content：用于存储笔记文件

使用指南

在浏览器中输入 http://NAS的IP:8080 即可访问您的 Quartz 网站界面。

初始状态下，由于映射的内容目录为空，网站不会显示具体内容。

操作提示：
如果您已有笔记文件，可直接放置到映射目录；若无现有笔记，可参照以下步骤获取示例文档。

访问项目 GitHub 页面，下载 docs 文档压缩包：
https://github.com/jackyzha0/quartz

将下载的文档解压并放置于映射路径中。

刷新网页后，内容将正常显示。若仍未显示，请检查文件权限设置。

网站界面主要分为三大模块：目录导航、正文内容与关系图谱。

用户可自由切换浅色/深色主题模式。

点击书籍图标可进入阅读模式，该模式下仅展示文章内容，侧边栏自动隐藏。

关系图谱功能尤为突出，支持拖拽移动、节点选取与视图缩放。

移动端访问同样经过优化，呈现良好的响应式布局。

总结与推荐

此前我们曾推荐过类似应用 Perlite，它同样支持将 Obsidian 笔记发布为网页。Quartz 与 Perlite 各有优势，但 Quartz 仅需单一容器即可完成部署，比 Perlite 更为简便，且开发团队仍在积极维护更新。若您日常使用 Obsidian 进行知识管理，强烈建议尝试部署 Quartz。

综合推荐指数：⭐⭐⭐⭐（功能全面，部署推荐）
用户体验评分：⭐⭐⭐⭐（界面美观，响应迅捷）
部署难度指数：⭐⭐（操作简单，易于上手）