烧饼的分享站

Quartz 生成的静态网站

5 min read

完全可以！Quartz 生成的静态网站，可以直接部署到你自己的域名下，不管是 GitHub Pages、Vercel、Netlify 还是你自己的服务器，都能轻松绑定。

我给你讲得通俗一点，再给你最通用的部署方案👇 #学习/个人网站/Quartz

一、先搞懂原理：Quartz 生成的是什么？

你运行 npx quartz build 后，会在项目里生成一个 public 文件夹。

  • 这个文件夹里，就是完整的静态网站文件（HTML、CSS、JS、图片等）。
  • 它不需要数据库、不需要后台服务，只要把这些文件上传到任何支持静态网站的服务器/平台，就能正常访问。

所以，只要你能把 public 文件夹的内容放到你域名对应的服务器/托管平台上，就能用你自己的域名访问了。

二、最推荐的 2 种方案（从简单到复杂）

方案1：免费托管 + 绑定你的域名（推荐新手）

用 GitHub Pages / Vercel / Netlify 这类平台托管你的 Quartz 网站，再把你的域名解析过去，全程免费，不用自己管服务器。

以 GitHub Pages 为例（和你之前的 npx quartz sync 无缝衔接）

  1. 先把你的 Quartz 项目推到 GitHub 仓库（npx quartz sync 会自动完成）。
  2. 去你的仓库 → Settings → Pages → 开启 Pages 服务。
  3. 在 Custom domain 里输入你的域名（比如 notes.你的域名.com），保存。
  4. 去你的域名解析后台，添加一条 CNAME 记录：
    • 主机记录：notes（或者你想用的子域名）
    • 记录值：你的用户名.github.io
    • 等待几分钟生效，就能用 https://notes.你的域名.com 访问了。

优势：零成本、不用管服务器，Quartz 更新笔记后 npx quartz sync 一键同步，网站自动更新。

方案2：上传到你自己的服务器/虚拟主机

如果你已经有自己的服务器（比如宝塔面板、阿里云ECS）或者虚拟主机，直接把 public 文件夹里的所有文件，上传到你域名对应的网站根目录即可。

步骤示例（宝塔面板）：

  1. 运行 npx quartz build 生成 public 文件夹。
  2. 用 FTP 工具（比如 FileZilla），把 public 里的所有文件，上传到你网站的根目录（比如 /www/wwwroot/你的域名/）。
  3. 确保服务器已经配置好了你的域名和 SSL 证书（HTTPS）。
  4. 访问你的域名，就能看到 Quartz 网站了。

优势：完全掌控服务器，没有平台限制；缺点是需要自己维护服务器和备份。

三、几个关键注意事项

  1. 路径问题 如果你不是部署在域名根目录（比如 你的域名.com/notes/），需要在 quartz.config.ts 里修改 baseUrl，否则网站的样式、链接会失效。

    // 比如你的网站地址是 https://你的域名.com/notes/
baseUrl: "/notes"

    如果是部署在根目录，就不用改。

  2. HTTPS 支持 你的域名必须开启 HTTPS（大部分平台/服务器都支持免费SSL证书），否则网站的部分功能可能会出问题。

  3. 更新笔记的流程

    • 方案1（托管平台）：修改笔记 → npx quartz build → npx quartz sync，平台会自动更新网站。
    • 方案2（自己服务器）：修改笔记 → npx quartz build → 重新上传 public 文件夹的文件到服务器。

四、一句话总结

Quartz 生成的静态网站，本质就是一堆网页文件。你只要把这些文件放到你域名能访问的地方，再做好域名解析，就能用你自己的域名访问了，非常灵活。

需要我根据你现在的情况（比如你的域名是在哪里买的、有没有服务器），帮你选一个最合适的方案，写一份一步到位的配置步骤吗？

相关链接

Quartz 生成的静态网站 | quartz就是发布静态网站的吗 | 步骤1

Graph View

Backlinks