NAS123.CC 背后的故事:从一张飞书表格到一个完整的静态网站
很多朋友看到现在的 nas123.cc,可能会觉得这就是一个标准的技术导航和博客网站。但其实在最初的设计蓝图里,它极其简单,甚至简陋——我当时只是想做一张飞书多维表格。
今天想和大家聊聊,这个项目是如何从一个“单纯的表格联动想法”,一步步演变成如今使用 Docusaurus 构建的完整静态站点的。
一、 起点:为什么是一张“飞书表格”?
玩 NAS 和自建服务的朋友都知道,工具和知识点实在太碎片化了。市面上的导航站很多,但要么广告满天飞,要么排版密密麻麻,很难让人静下心来查找组织。
我最初的想法很简单:能不能做一个极简、无无打扰的导航?
为了快速验证想法,我最先想到的是用飞书多维表格(Bitable)。
- 优点: 录入极其方便,字段清晰,改完数据直接发布成网页就能分享。
- 初衷: 只要把好用的工具、常用的命令分门别类放进表格,再联动前端生成一个单页卡片布局的站点就行了。
这也是很多轻量级独立项目最完美的“最小可行性产品(MVP)”。
二、 痛点:单页导航的局限性
然而,随着收集的资源越来越多,问题接踵而至。单独的“导航卡片”虽然清爽,但它承载不了深度的内容。
- “知其然,不知其所以然”:导航只能告诉你这个工具叫什么、地址在哪。但怎么配置 PVE 硬件直通?怎么优化 Docker 镜像加速?这些需要长篇图文的“硬核硬货”,单单一个链接根本说不清楚。
- 内容沉淀困难:单纯的导航没有页面层级,无法做深度的分类沉淀,更像是一个临时查阅的黄页,缺乏内容的“生命力”。
- 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、关于自建服务、关于折腾的一切,我们折腾不止,更新不断。
欢迎大家常来逛逛!