环境要求
运行时
| 资源 | 要求 |
|---|---|
| 运行时 | Node.js 22+ |
| 包管理器 | pnpm（推荐） |
| CPU | 1 核（开发/小团队够用） |
| 内存 | 运行约 512 MB 以上；安装阶段建议 ≥1G 或配置 Swap（见小服务器安装） |
| 磁盘 | 视文档量而定 |
依赖
- 无外部服务依赖：不需要安装数据库、缓存、消息队列等中间件
- SQLite：内嵌在 better-sqlite3 中，零配置
- 文档存储：直接使用文件系统
存储布局
运行时数据集中存储在 ~/.mdocs/ 目录下：
可通过环境变量 MDOCS_DATA_DIR 自定义数据目录位置。
网络
- 默认监听
0.0.0.0:4000（所有网卡，适合服务器直接暴露或通过反向代理） - 本地开发若只想本机访问：
export MDOCS_HOST=127.0.0.1 - 生产部署仍建议通过反向代理对外暴露（见反向代理）