今天想和大家聊聊，这个项目是如何从一个“单纯的表格联动想法”，一步步演变成如今使用 Docusaurus 构建的完整静态站点的。

一、 起点：为什么是一张“飞书表格”？​

玩 NAS 和自建服务的朋友都知道，工具和知识点实在太碎片化了。市面上的导航站很多，但要么广告满天飞，要么排版密密麻麻，很难让人静下心来查找组织。

我最初的想法很简单：能不能做一个极简、无无打扰的导航？

为了快速验证想法，我最先想到的是用飞书多维表格（Bitable）。

• 优点： 录入极其方便，字段清晰，改完数据直接发布成网页就能分享。
• 初衷： 只要把好用的工具、常用的命令分门别类放进表格，再联动前端生成一个单页卡片布局的站点就行了。

这也是很多轻量级独立项目最完美的“最小可行性产品（MVP）”。

二、 痛点：单页导航的局限性​

然而，随着收集的资源越来越多，问题接踵而至。单独的“导航卡片”虽然清爽，但它承载不了深度的内容。

1. “知其然，不知其所以然”：导航只能告诉你这个工具叫什么、地址在哪。但怎么配置 PVE 硬件直通？怎么优化 Docker 镜像加速？这些需要长篇图文的“硬核硬货”，单单一个链接根本说不清楚。
2. 内容沉淀困难：单纯的导航没有页面层级，无法做深度的分类沉淀，更像是一个临时查阅的黄页，缺乏内容的“生命力”。
3. SEO 与访问体验：纯表格或者简单的单页应用对搜索引擎并不友好，加载性能也容易受限。

我意识到，我需要的不仅仅是一个**“指路牌（导航）”，更需要一个能和读者真诚交流、沉淀深度硬核教程的“根据地（完整网站）”**。

三、 蜕变：为什么最终选择了 Docusaurus？​

既然要从单页变成完整网站，选型就成了关键。在对比了多种方案后，我把目光投向了由 Meta 开源的 Docusaurus。

它几乎完美地踩中了我的所有核心诉求：

• 天生强大的文档/博客双系统：Docusaurus 的结构非常清晰。它既可以有结构严密的 docs（用来做分类清晰的系统教程、资源索引），又可以有按时间线更新的 blog（用来发日常动态和深度思考）。
• 基于 Markdown，纯粹的写作体验：作为创作者，我希望把精力100%放在内容本身。在 Docusaurus 里，所有的页面都是用 Markdown 编写的，不需要在复杂的后台点来点去，极其清爽。
• 极佳的性能与静态化体验：构建后生成纯静态 HTML，部署到云端服务器或 Vercel/GitHub Pages 后，访问速度极快，且原生自带完美的 SEO 优化。
• 生态与扩展性：搭配 Tailwind CSS 或是自定义组件，可以非常方便地把原本的“导航”功能作为一个独立的核心模块，无缝嵌入到整个网站的生态里。

从那一刻起，nas123.cc 正式挥别了“单页表格”的设想，向着一个功能完整的、专业的内容站点演进。

四、 核心构建流程（一步步来）​

以下是目前 nas123.cc 的核心构建与部署链路，分享给同样想建站的朋友：

1. 初始化项目​

使用 Docusaurus 脚手架直接初始化（选择经典的经典经典主题模板）：

npx create-docusaurus@latest nas123-site classic

2. 梳理核心目录结构​

为了把“导航”和“内容”融合，我规划了清晰的目录职责：

• /src/pages/：用于构建标志性的极简首页和独立的导航面板。
• /docs/：用来存放分类清晰、适合检索的硬核技术指南（例如 NAS 系统配置、网络搭建等）。
• /blog/：也就是你现在看到的这里，用来记录个人的碎碎念、项目日志和阶段性思考。

3. 本地开发与实时调整​

在本地通过 npm run start 启动开发服务器。Docusaurus 支持热更新，左边写代码和 Markdown，右边浏览器就能秒级看到效果，这种即时反馈的体验非常顺畅。

4. 视觉降噪​

为了贯彻“专业、干净、无打扰”的视觉风格，我在全局配色上做了一些克制的设计，拿掉了多余的视觉干扰，确保所有的焦点都在文字和工具链接本身。

五、 写在最后​

从最初想做的一张“飞书表格”，到如今正式上线的 nas123.cc。这个过程不仅是技术的更迭，更是我对这个网站定位的思考过程。

导航站的本质是高效，而博客和文档的本质是沉淀。我希望 nas123.cc 未来能把这两者很好地结合起来——既能让你在需要找工具时一目了然，也能在你遇到配置难题时，提供一份真诚、详实的硬核指南。

这是本站的第一篇博文，一个全新的起点。关于 NAS、关于自建服务、关于折腾的一切，我们折腾不止，更新不断。

欢迎大家常来逛逛！