Docusaurus 笔记站上线记录
· 阅读需 5 分钟
今天把服务器上的 Halo 和 MySQL 下线后，改成了一个更轻量的 Docusaurus 静态笔记站。
这篇文章也作为写作参照：它覆盖了标题、摘要、提示块、表格、代码块、图片、折叠区域、任务清单、引用和链接等常用写法。
为什么换成 Docusaurus
原来的 Halo 需要 Java 服务和 MySQL 数据库，资源占用相对高。当前服务器只有 2 核 CPU、3.8G 内存和 30G 磁盘，更适合托管静态站点。
Docusaurus 的优势：
- 内容直接写 Markdown。
- 构建后是静态文件，运行时内存占用低。
- 不需要数据库，备份更简单。
- 适合长期整理笔记、教程、项目文档和服务器维护记录。
这类“上线记录”适合放在
blog/目录；长期维护的命令清单更适合放在docs/目录。
当前资源对比
| 项目 | 之前的 Halo | 现在的 Docusaurus |
|---|---|---|
| 运行方式 | Java + MySQL | 静态文件服务 |
| 数据库 | 需要 MySQL | 不需要 |
| 内存压力 | 较高 | 较低 |
| 内容格式 | 后台编辑 | Markdown 文件 |
| 备份方式 | 数据库 + 附件 | 项目目录即可 |
部署结构
当前站点目录：
/root/docusaurus-notes
核心目录含义：
docusaurus-notes/
├── blog/ # 文章
├── docs/ # 笔记和文档
├── static/ # 静态资源，例如图片
├── build/ # 构建后的静态站点
└── package.json
发布命令
每次修改文章或笔记后，执行：
发布命令
cd /root/docusaurus-notes
npm run build
pm2 restart docusaurus-notes
pm2 save
也可以检查服务状态：
检查 PM2
pm2 status
curl -I http://127.0.0.1:8090
Docusaurus 提示块
适合记录经验
笔记站不一定要追求复杂后台。内容如果主要是教程、命令和长期说明，Markdown + 静态站点通常更稳。
当前访问方式
站点通过 PM2 托管 Docusaurus 构建产物，再由 nginx 代理到 HTTPS 域名。
注意
服务器当前使用 Node 18，所以 Docusaurus 固定在兼容版本。升级到最新版前，应该先升级 Node 到 20 或更高版本。
不要直接删除未备份内容
删除旧站点、数据库或图片附件前，先确认本地备份可以正常解压和恢复。
折叠内容
点击查看：这次迁移释放了什么资源？
这次清理掉 Halo、MySQL 和不再使用的 NapCat 副号后，服务器可用内存和磁盘空间都明显增加。
- Halo 和 MySQL 容器已删除。
- Halo 数据目录已删除。
- 不再使用的 MySQL/Halo 镜像已删除。
- Docusaurus 运行时只需要一个轻量静态服务。
任务清单
- 备份旧 Halo 数据
- 删除旧 Halo 和 MySQL
- 创建 Docusaurus 项目
- 配置 PM2 托管服务
- 发布示例笔记和文章
- 逐步整理历史笔记
- 设计站点分类和标签
图片写法
公共图片可以放到：
static/img/
然后在 Markdown 中这样引用：
示例：
链接写法
站内链接：
外部链接：
后续计划
接下来可以把这些内容整理进站点：
- 服务器维护命令
- Docker 和 PM2 常用操作
- QQ 机器人部署记录
- Docusaurus 写作规范
- 常见故障排查
最后，给自己留一个简单规则：凡是以后可能重复用到的命令和流程，都写进笔记站。