Nowen Note（弄文笔记）

开源、自托管的知识库、每日记录与任务协作工作台

统一知识树 · 富文本 / Markdown 双编辑器 · 离线工作区 · AI RAG 问答 · 每日记录 · 任务中心 · 多端协作

English · 官方网站 / 帮助中心 · nowen.cn（维护中） · 在线体验 · 下载客户端 · 教程中心 · MCP 安装 · 更新日志

Nowen Note 不只是一个编辑器。它希望成为一套由你掌控数据、可长期运行在 NAS / 服务器上，并能通过 Web、桌面端和移动端随时访问的个人与团队知识基础设施。

NAS 远程连接登录：支持部署到 绿联 NAS（UGOS / UGOS Pro） 和 飞牛 NAS（fnOS）。部署完成后，可在 Web、桌面端或 Android 客户端中，通过局域网 IP、IPv6 地址或已配置 HTTPS 的公网域名远程连接并登录。

v1.4.16 已发布

v1.4.16 聚焦 笔记切换稳定性、视频附件授权、Markdown / 代码块编辑体验与桌面发布链路，继续提升 Nowen Note 在多端编辑、局域网媒体访问和桌面客户端分发场景下的可靠性。

• 笔记切换更稳定：阻止旧富文本保存回执在快速切换后重新抢回激活笔记，并补充“提交后迟到回执”回归覆盖。
• 视频首次打开更可靠：首次进入包含视频的笔记前会提前准备附件签名，减少播放器先启动、授权尚未就绪导致的首次加载失败。
• Android / 局域网视频授权修复：局域网附件授权改用原生 HTTP 链路，改善 Android 客户端访问 NAS / 局域网服务时的视频加载稳定性。
• 编辑器细节修复：优化代码块全选快捷键逻辑，并重新清理历史 Markdown 块标记，减少旧内容残留标记对编辑体验的影响。
• 桌面发布链路增强：完善 Windows SignPath 测试 / 正式签名、Authenticode 严格校验、签名后更新元数据，以及 macOS 双架构产物完整性检查。
• 分享兼容性：修复 Edge 浏览器分享链接复制兼容性，并补充剪贴板回归测试。

查看：v1.4.16 Release · 完整更新日志

为什么选择 Nowen Note

核心能力

AI 问答与隐私

Nowen Note 的知识库问答采用 RAG 检索增强方式，不会在每次提问时把全部笔记内容都发送给大模型。

• 知识库模式：先在本地索引中检索相关笔记和附件，再发送匹配到的片段。
• 当前笔记模式：只使用当前打开的笔记。
• 选中文本模式：只使用当前选择或粘贴的文本。
• 本地模型：使用 Ollama 等本地服务时，可让问答内容留在自己的设备或服务器中。

使用在线 Embedding 或在线大模型时，建立索引或回答问题所需的相关文本会发送给你自行配置的服务商。身份证、密码、API Key、助记词等高度敏感信息仍不建议以明文保存。

让 AI 客户端连接 Nowen Note

Nowen Note 支持 MCP Server，可让 Claude Code、Cursor、VS Code 等 AI 客户端在授权范围内搜索、读取、创建和更新笔记。

• MCP Server 中文安装教程
• MCP Server English guide
• nowen-mcp 独立包说明

当前正式可用方式为源码构建：安装 Node.js 20+，构建 packages/nowen-mcp，在 Nowen Note 创建 restricted Personal API Token，再把 packages/nowen-mcp/bin/nowen-mcp.mjs 的绝对路径配置到客户端。dist/scoped-entry.js 是启动器加载的内部构建入口，不应直接配置给客户端。

v1.4.16 重点更新

笔记切换与编辑稳定性

• 快速切换笔记后，旧富文本保存回执不会再把上一条笔记重新设为当前激活笔记。
• 新增“提交后迟到保存回执”回归测试，继续收紧笔记切换竞态边界。
• 优化代码块全选快捷键逻辑，减少代码块与整篇文档选择行为冲突。
• 重新清理历史 Markdown 块标记，降低旧数据残留标记对当前编辑与渲染的影响。

视频、Android 与局域网访问

• 首次打开包含视频附件的笔记前会先准备附件签名，避免播放器早于授权信息初始化。
• Android / 局域网附件授权改用原生 HTTP 链路，提升 NAS、局域网 IP 等场景的视频访问稳定性。
• 为“首次打开前附件授权准备”和“Android 局域网附件授权”补充回归测试。

桌面客户端发布与分发

• Windows 正式发布链路接入并强化 SignPath 签名，包括测试签名、正式签名配置校验和 Authenticode 严格验证。
• 补充签名后 Windows 更新元数据重建 / 刷新流程，确保发布产物与自动更新元数据一致。
• 强化 macOS 发版产物完整性门禁，并兼容双架构压缩包的发布与校验。
• Release 说明进一步明确桌面平台矩阵，降低不同系统下载与安装时的歧义。

分享兼容性

• 修复 Edge 浏览器分享链接复制兼容性，并增加剪贴板兼容性回归测试。

完整记录请查看 CHANGELOG.md 和 v1.4.16 Release。

截图

桌面端

AI 写作助手	AI 服务商配置

移动端

侧边栏	笔记列表	编辑器

官网与在线体验

• 当前官方网站 / 帮助中心：
• 后续官网：（维护中）
• 在线体验：
• 账号：demo
• 密码：demo123456

nowen.cn 仍在维护中。当前请以 作为 Nowen 官方帮助与使用文档入口。

演示账号仅用于体验，数据可能被定期重置。请勿存放敏感或重要内容。

快速部署

Docker Compose（推荐）

要求已安装 Docker Engine 与 Docker Compose v2。

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

打开 http://:3001。

默认管理员账号：

用户名：admin
密码：admin123

首次登录后请立即修改默认密码。公网部署还应配置 HTTPS、备份、正确的公开访问地址，并按需收紧 CORS。

绿联 NAS / 飞牛 NAS 远程连接登录

Nowen Note 支持部署在 绿联 NAS（UGOS / UGOS Pro） 与 飞牛 NAS（fnOS） 上。可使用 Releases 中对应的 .upk / .fpk 安装包，也可以直接通过 Docker Compose 部署。

部署并启动服务后：

• 局域网访问：浏览器打开 http://:3001。
• 远程访问：在 Web、桌面端或 Android 客户端中填写 NAS 的公网域名、IPv4 或 IPv6 服务地址并登录。
• 公网使用建议配置 HTTPS 反向代理，不建议直接暴露未加密的 HTTP 服务。

查看各平台安装包：GitHub Releases。

查看运行状态和日志：

docker compose ps
docker compose logs -f --tail=200 nowen-note

从旧版本升级

升级前先在管理后台创建完整备份，并确认数据库与附件目录已经持久化。

docker compose pull
docker compose up -d

需要固定当前稳定版本时：

NOWEN_IMAGE_TAG=v1.4.16 docker compose up -d

v1.4.16 重点改善笔记切换稳定性、视频首次打开与 Android / 局域网附件授权、Markdown / 代码块编辑细节，以及桌面客户端签名与发布完整性。升级后建议重点检查快速切换笔记、首次视频播放、Android 连接 NAS / 局域网视频、代码块全选和分享链接复制。镜像回滚不等于数据库回滚，生产环境必须保留独立备份。

Docker 在线升级（可选）

在线升级仅支持仓库内的官方 docker-compose.yml，且默认关闭。主应用容器不会挂载 Docker Socket；只有独立、内网隔离并受限运行的 updater 容器拥有 Docker Engine 权限。

cp .env.example .env
printf '\nNOWEN_UPDATER_TOKEN=%s\n' "$(openssl rand -hex 32)" >> .env
NOWEN_IMAGE_TAG=v1.4.16 docker compose --profile updater up -d

启用后，管理员可在「设置 → 关于 → 版本信息」执行升级前检查、完整备份、升级、健康验证和失败回滚。

完整说明见 Docker 在线升级与恢复。

仅运行主应用

docker run -d \
  --name nowen-note \
  --restart unless-stopped \
  -p 3001:3001 \
  -e TZ=Asia/Shanghai \
  -v /opt/nowen-note/data:/app/data \
  cropflre/nowen-note:v1.4.16

数据、备份与配置

持久化目录

容器内的持久化根目录是 /app/data，不是 /data。默认 Compose 使用名为 nowen-note-data 的 Docker Volume。

/app/data/
├── nowen-note.db
├── attachments/
├── backups/
├── fonts/
└── .jwt_secret

• 默认生产数据库为 SQLite，主文件是 /app/data/nowen-note.db。
• 附件默认存储在 /app/data/attachments，新文件按 YYYY/MM 分目录。
• 自动备份默认位于 /app/data/backups。
• 生产环境建议把 BACKUP_DIR 映射到独立物理磁盘，并遵循 3-2-1 备份原则。
• PostgreSQL 适配和迁移仍在验证中，当前正式部署与恢复流程继续以 SQLite 为默认基线。

常用环境变量

完整模板见 .env.example。