跳到主要内容

NAS123.CC 背后的故事:从一张飞书表格到一个完整的静态网站

· 阅读需 5 分钟
超超
超超
地球Online的NPC

很多朋友看到现在的 nas123.cc,可能会觉得这就是一个标准的技术导航和博客网站。但其实在最初的设计蓝图里,它极其简单,甚至简陋——我当时只是想做一张飞书多维表格

今天想和大家聊聊,这个项目是如何从一个“单纯的表格联动想法”,一步步演变成如今使用 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、关于自建服务、关于折腾的一切,我们折腾不止,更新不断。

欢迎大家常来逛逛!