nowen-note

自托管的私有知识库，对标群晖 Note Station。

A self-hosted private knowledge base. English README · 作者感言 · 在线体验

功能概览

富文本 + Markdown 双引擎：Tiptap 3 + CodeMirror 6，共享 AI、版本历史、评论等上层能力；支持表格（单元格水平/垂直居中）、图片、附件
AI 助手：支持通义千问 / OpenAI / Gemini / DeepSeek / 豆包 / Ollama，覆盖写作辅助、生成标题、推荐标签、RAG 知识问答；AI 思考过程自动过滤，仅展示最终回答
知识管理：无限层级笔记本、彩色标签、收藏、回收站（笔记锁定，禁止编辑/收藏/锁定操作）、FTS5 全文搜索
待办事项：任务中心支持树形任务、看板视图、日历视图、甘特图 / 时间轴、任务依赖、重复任务、AI 拆任务、提醒系统、任务模板
思维导图：节点拖拽 / 多选 / 复制粘贴、文件夹管理、导图模板、全屏编辑、滚轮缩放、从笔记生成、收藏与搜索
说说 / 动态：轻量社交化笔记，支持图文混排
分享与权限：4 档权限（仅查看 / 可评论 / 可编辑 / 可编辑需登录）+ 访客留言 + 密码 / 有效期 + 分享链接可撤销、版本回溯
实时同步：基于 Yjs + WebSocket 的多端实时协作，删除 / 回收站操作跨端即时同步；IndexedDB 本地离线缓存
文件管理：图片缩略图（webp 三档自适应，密集图床场景流量降至 1/100）、「我的上传」分类（已引用 / 未引用细分）、孤儿清理；附件按 YYYY/MM 分目录存储
导出：Markdown / PDF / Word / PNG / JPG 多格式导出；Android 导出图片可直接保存到系统相册
备份与恢复：定时自动备份、邮件备份推送、一键恢复；Docker / NAS 部署开箱即用
多端：Web / Electron（Win/macOS/Linux）/ Android（Capacitor）
自动化：沙箱插件系统、Webhook、审计日志
开发者生态：MCP Server、TypeScript SDK、CLI、浏览器剪藏扩展、OpenAPI 3.0（见 packages/）

技术栈

层	技术
前端	React 18 + Vite + TypeScript + Tailwind CSS + Tiptap 3 + CodeMirror 6
后端	Hono + better-sqlite3 + WebSocket + Yjs + sharp + sqlite-vec
桌面端	Electron（Win / macOS / Linux）
移动端	Capacitor Android
存储	SQLite（FTS5 全文搜索） + 本地附件目录 + S3 / R2 / MinIO 对象存储
同步	实时同步（Yjs + WebSocket） + IndexedDB 本地离线缓存
导出	Markdown / PDF / Word / PNG / JPG

截图

桌面端

AI 写作助手	AI 服务商配置

移动端（Android / Capacitor）

侧边栏	笔记列表	编辑器

在线体验

不想本地部署？可以直接打开作者维护的官方体验站点：

地址：https://note.nowen.cn/
账号：demo
密码：demo123456

⚠ 体验账号为只读演示用途，数据可能被定期重置，请勿存放任何敏感或重要内容。生产使用请按下方「快速开始」自托管部署。

快速开始

默认管理员：admin / admin123，首次登录后请立即修改密码。

Docker（推荐）

git clone https://github.com/cropflre/nowen-note.git
cd nowen-note
docker-compose up -d

访问 http://<你的IP>:3001。

本地开发

需要 Node.js 20+。

git clone https://github.com/cropflre/nowen-note.git
cd nowen-note
npm run install:all
npm run dev:backend   # 后端 :3001
npm run dev:frontend  # 前端 :5173

访问 http://localhost:5173。

桌面端 / 移动端

npm run electron:dev      # Electron 开发
npm run electron:build    # 打包 Windows / macOS / Linux

Android 可直接从 Releases 下载 APK，或 npx cap sync android && npx cap open android 自行构建。

飞牛 fnOS（.fpk 一键安装）

从 Releases 下载最新 nowen-note-x.y.z.fpk，在飞牛 NAS 「应用中心 → 设置 → 手动安装应用」选中文件即可。安装后桌面出现「弄文笔记」图标，浏览器打开 http://<飞牛IP>:3001。

当前 .fpk 仅支持 x86_64 飞牛设备（platform=x86）。手动打包参见 scripts/fpk/README.md。

配置

环境变量	默认值	说明
`PORT`	`3001`	服务端口
`DB_PATH`	`/app/data/nowen-note.db`	数据库文件路径
`TZ`	`Asia/Shanghai`	Docker 容器时区；海外用户可改为 `Europe/London`、`America/Los_Angeles` 等
`OLLAMA_URL`	—	本地 Ollama 地址（可选）

数据持久化：容器需将 /app/data 映射到宿主机（不是 /data）。镜像已声明 VOLUME ["/app/data"]，主流 NAS 面板会自动预填该路径。

Docker 镜像内置 tzdata，docker-compose.yml 默认设置 TZ=Asia/Shanghai，用于保证待办「今日 / 本周 / 逾期」等后端日期判断按本地时区刷新。海外用户可在项目根目录创建 .env 并写入自己的时区，例如 TZ=Europe/London。

备份策略：自动备份默认写入 /app/data/backups，与数据在同一个卷。建议按 3-2-1 原则把 /app/backups 另挂到独立磁盘，并设置 BACKUP_DIR=/app/backups，详见 docker-compose.yml 内的注释。

数据目录说明

/app/data（本地开发时为项目根目录下的 data/）的典型结构如下：

data/
├── nowen-note.db          # SQLite 主数据库
├── backups/               # 自动备份文件
├── attachments/           # 所有附件（笔记图片、文件、任务附件等）
│   ├── 2026/06/           # 新附件按 YYYY/MM 分目录存储
│   │   └── <uuid>.<ext>
│   ├── <uuid>.<ext>       # 旧附件平铺路径，仍兼容读取
│   └── .thumbs/           # 缩略图缓存（webp），不要手动删除
└── fonts/                 # 自定义字体

新附件路径：data/attachments/YYYY/MM/<uuid>.<ext>，按年月自动归档
旧附件兼容：历史版本平铺在 attachments/ 根目录的文件仍可正常读取，无需迁移
.thumbs 目录：缩略图缓存，由系统自动生成和管理。删除后会在下次访问时重新生成，但会导致短暂的缩略图缺失，不建议手动删除
task_attachments：待办任务的图片/附件与普通笔记附件共用同一个 ATTACHMENTS_DIR，通过数据库关联区分归属

文档

浏览器剪藏扩展（Chrome / Edge）：Chrome Web Store
部署指南（本地 / Docker / 桌面 / 移动 / 群晖 / 绿联 / 威联通 / 飞牛 / 极空间 / ARM64）：docs/deployment.md
附件对象存储（S3 / R2 / MinIO）：docs/object-storage.md
飞牛 .fpk 应用打包：scripts/fpk/README.md
ARM64 详解：docs/deploy-arm64.md
邮件备份配置：docs/backup-email-smtp.md
编辑器模式切换：docs/editor-mode-switch.md
多设备同步验证：docs/multi-device-sync-validation.md
iOS 版本说明：docs/iOS-Release.md
隐私策略：docs/PRIVACY.md
OpenAPI：运行后访问 /api/openapi.json

📚 教程中心：docs/tutorials/ — 从快速上手到高级功能的完整教程

快速上手：5 分钟快速上手 · 界面概览 · 创建第一篇笔记
笔记管理：文档树 / 笔记本 · 标签和收藏 · 搜索 · 回收站与恢复 · 批量管理
编辑器：富文本编辑器 · Markdown 编辑器 · 斜杠命令 · 高级块 · 附件管理 · 导入导出
AI 功能：AI 配置 · AI 生成标题和标签 · AI 总结
思维导图：入门 · 从笔记生成 · 导出 · Mermaid 图表
待办事项：任务中心
说说 / 动态：说说功能
分享与协作：分享 · 实时协作 · 版本历史 · 工作区
多端：桌面端 · 移动端 · Android · 鸿蒙 · Web
部署与运维：Docker · NAS · 备份与迁移 · 安全
开发者：API · SDK · CLI · MCP · Webhook · 剪藏扩展
常见问题：附件问题 · 登录问题 · 性能问题 · 同步问题

常见问题

macOS 首次打开报错 / 无法启动 / "ERR_DLOPEN_FAILED"

由于本应用未做 Apple 公证（notarization），系统会把 dmg 里下载来的 .app 打上 quarantine 隔离属性，导致内部的 better-sqlite3 原生模块加载失败、后端启动卡住 30 秒后报"后端启动超时"。

终端执行一行命令解除隔离即可（路径换成你实际拖过去的位置）：

sudo xattr -dr com.apple.quarantine "/Applications/Nowen Note.app"
# 或
sudo xattr -dr com.apple.quarantine ~/Downloads/Nowen\ Note.app

执行后双击重新打开即可。Apple Silicon 用户若用了 x64 版本，需要 Rosetta 2 （系统会自动提示安装）。

问题反馈

QQ 群：1093473044

支持作者

如果这个项目对你有帮助，欢迎扫码请作者喝杯咖啡 ☕

开源协议

更新日志

最近 5 个版本的更新内容，完整历史见 CHANGELOG.md。

v1.3.0 - 2026-07-07

本版本无可展示的 commit 变更（可能全部是合并 / 工作流修改）

v1.2.9 - 2026-07-07

✨ 新增

support custom desktop data directory (#168) (82babec)

v1.2.8 - 2026-07-07

✨ 新增

combine notebook tree expand toggle (5a283c6)
add notebook tree expand collapse actions (#162) (add6eba)
标题输入框增加 IME 输入法状态感知，避免拼音串被误保存为标题 (9051ece)
add browser-side size check and asset reference filtering for Siyuan import (fd6879a)

🐛 修复

align notebook tree toggle icon state (3d37362)
restore cross-device editor sync (da772b4)
scroll markdown preview outline headings (#163) (b385fb9)
support markdown default preview and siyuan callouts (#164) (4e94e0a)

v1.2.7 - 2026-07-06

✨ 新增

HTML 预览资源/大纲提取与编辑器联动优化 (8f46ae0)
任务重复/到期计算、导入导出、编辑器与任务面板优化 (25c6050)

v1.2.6 - 2026-07-06

✨ 新增

add EditorSplitView component (e574cbd)
add NoteTabsBar and tab navigation system (b4dbfe9)
add SiYuan SY parser and enhance import service (7d5d4c9)
add SiYuan note import service (28cd137)

🐛 修复

support manual note sorting (510bed7)
修复安全设置、任务中心及分享笔记等问题 (8f2565d)
优化登录页组件 (4c8be41)
优化登录页组件与国际化 (797be4c)
优化桌面端登录与导航组件 (539faf9)
优化Electron构建、日记中心及笔记列表 (865dc02)
优化笔记列表与标签页组件 (adec6f1)
improve NoteTabsBar and AppContext integration (6a589a8)
update Sidebar component (8b0ece9)
update DataManager and i18n (aea3ac0)
handle deleted notebooks in export/import flow (bf74ff9)
enhance SiYuan import media asset handling (dd1d64a)
improve SiYuan import service and i18n (ad29c60)

Name		Name	Last commit message	Last commit date
Latest commit History 1,103 Commits
.agents/skills		.agents/skills
.claude/skills		.claude/skills
.github/workflows		.github/workflows
.playwright-mcp		.playwright-mcp
.vscode		.vscode
backend		backend
build		build
docs		docs
electron		electron
frontend		frontend
nowen-harmony		nowen-harmony
packages		packages
scripts		scripts
.dockerignore		.dockerignore
.env.example		.env.example
.gitignore		.gitignore
.mailmap		.mailmap
AGENTS.md		AGENTS.md
AUTHOR_STORY.en.md		AUTHOR_STORY.en.md
AUTHOR_STORY.md		AUTHOR_STORY.md
CHANGELOG.md		CHANGELOG.md
Dockerfile		Dockerfile
Gitea.docx		Gitea.docx
LICENSE		LICENSE
README.en.md		README.en.md
README.md		README.md
docker-compose.postgres.yml		docker-compose.postgres.yml
docker-compose.yml		docker-compose.yml
docker-entrypoint.sh		docker-entrypoint.sh
fix_sidebar.ps1		fix_sidebar.ps1
fix_sidebar_notes.patch		fix_sidebar_notes.patch
package-lock.json		package-lock.json
package.json		package.json
ugcli		ugcli
weixin.jpg		weixin.jpg

Folders and files

Latest commit

History

Repository files navigation

nowen-note

功能概览

技术栈

截图

桌面端

移动端（Android / Capacitor）

在线体验

快速开始

Docker（推荐）

本地开发

桌面端 / 移动端

飞牛 fnOS（.fpk 一键安装）

配置

数据目录说明

文档

常见问题

macOS 首次打开报错 / 无法启动 / "ERR_DLOPEN_FAILED"

问题反馈

支持作者

开源协议

最近重要更新

移动端体验

存储与附件

跨端同步

编辑器

思维导图

分享

搜索与 AI

更新日志

v1.3.0 - 2026-07-07

v1.2.9 - 2026-07-07

✨ 新增

v1.2.8 - 2026-07-07

✨ 新增

🐛 修复

v1.2.7 - 2026-07-06

✨ 新增

v1.2.6 - 2026-07-06

✨ 新增

🐛 修复

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 49

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages