给NAS装个完全开源且数据私有的笔记知识库Poznote

前言

之前在威联通Qu805上折腾过Qsirch AI Mode、RAGFlow和ConvertX。搜索、知识库问答、文件转换这几个需求都解决了，这次轮到记笔记。

平时记东西的需求很杂。工作上有项目笔记、会议记录，技术上有代码片段、架构草图，生活里有读书摘录、灵感备忘。以前这些东西散落在各种软件里，有的在云笔记，有的在本地文档，有的干脆在聊天记录里。想找个东西经常记不起来放在哪了。所以我想在NAS上装一个自托管的笔记平台，把散落的内容集中管理起来。

选的是Poznote。一个现代化、轻量但功能完整的免费开源自托管笔记与知识管理平台。这篇文章记录在威联通Qu805上的完整部署过程和实际使用体验。

一、Poznote是什么

Poznote的定位很清晰。它既能做个人知识库，也能做文档管理、可视化笔记、多端访问，还具备完善的API扩展能力。

它支持富文本和Markdown两种编辑方式，界面清爽，普通用户能直接上手，技术用户也能写结构化内容。内置了Excalidraw绘图能力，可以随手画流程图、草图、脑图，不需要额外装插件。组织能力上，标签、工作区、全文搜索都好用，笔记、附件、链接都能快速定位。

对NAS用户来说最关键的是两点。第一，所有内容都存在本地，不依赖云服务，不限容量，不限设备，不用担心涨价或者封号。第二，资源占用低，部署简单，群晖、极空间、CasaOS、QNAP都能轻松跑，适合7×24小时在线。

还有一个比较特别的功能，它内置了MCP Server，可以让Claude Desktop、Cursor、Cherry Studio这些AI客户端直接读写你的笔记，轻松构建个人AI知识库。这个功能后面实测会讲到。

二、核心亮点

记笔记的平台很多，Poznote有几个地方让它区别于普通的笔记软件。

首先是内置的Excalidraw绘图能力。很多笔记软件画个流程图都要装插件或者换软件，Poznote直接把可视化绘图集成进来了。做教程、画架构图、整理思维，都可以在一个界面里完成，不需要来回切换工具。

其次是全文搜索和标签管理。笔记多了之后，能不能快速找到才是关键。Poznote的标签、工作区、全文搜索配合起来，笔记、附件、链接都能定位。内容真正做到了可找、可用。

附件和文件管理也很完整。笔记里可以直接上传图片、文档、截图，集中存放在NAS上统一管理，不再散落在各个软件里。

最后是开放的API和AI集成能力。这个对于喜欢折腾的人来说很有吸引力。笔记不只是给人看的，还能给AI读。内置的MCP Server让AI客户端可以读写笔记，等于把笔记库变成了AI可以调用的知识底座。

三、部署准备

在威联通的Docker目录里新建一个poznote文件夹。威联通默认的Docker目录是Container共享文件夹。

mkdir -p /share/Container/poznote

然后确认Container Station已经安装并更新到最新版本。部署全程在图形界面完成，不需要额外开启SSH。

四、部署步骤

打开Container Station，进入应用程序页面，点击创建，选择创建应用程序。应用程序名称随意，然后在方框内粘贴Docker Compose配置。

version: "3.8" services: webserver: image: ghcr.io/timothepoznanski/poznote:6 container_name: poznote-web restart: unless-stopped environment: SQLITE_DATABASE: /var/www/html/data/database/poznote.db HTTP_WEB_PORT: 8040 POZNOTE_OIDC_DISABLE_NORMAL_LOGIN: false POZNOTE_SETTINGS_PASSWORD: "baobaozi" ports: - "8040:80" volumes: - "/share/Container/poznote/data:/var/www/html/data" healthcheck: test: ["CMD", "curl", "-fsS", "http://127.0.0.1/api/health"] interval: 30s timeout: 10s retries: 3 start_period: 10s mcp-server: image: ghcr.io/timothepoznanski/poznote-mcp:6 container_name: poznote-mcp restart: unless-stopped environment: POZNOTE_API_URL: http://webserver:80/api/v1 POZNOTE_DEBUG: false POZNOTE_MCP_PORT: 8045 ports: - "8045:8045" volumes: - "/share/Container/poznote/data:/var/www/html/data:ro" depends_on: - webserver

几个需要根据自己的情况修改的地方。

第一是端口。默认配置用的是8040作为网页端口，8045作为MCP服务器端口。如果这两个端口被NAS上的其他服务占用了，就改成别的，注意冒号前面的端口不要冲突。

第二是密码。配置里的baobaozi是密码保护的自定义设置，改成你自己的。这个密码后面进设置页面的时候要用到。

第三是数据卷路径。配置里把本地目录映射到容器内，冒号前面是NAS上的实际路径。如果你的Docker目录不叫Container，替换成你的实际目录名。

镜像拉取需要自己解决网络问题。ghcr.io的镜像在国内访问可能不稳定，我第一次拉取花了比较久。如果拉不动，可以考虑给Container Station配置镜像加速，或者找朋友帮忙导出镜像再导入。

粘贴配置之后，建议先点一下验证按钮，如果验证通过再点创建。Container Station会自动拉取镜像并启动两个容器。创建完成后，看到两个容器显示正在运行，就说明可以用了。

五、 初次登录与中文设置

部署好后，打开poznote-web容器的详细信息，复制它的端口转发URL，也就是NAS的IP加上端口号，粘贴到浏览器地址栏回车。

首次打开需要输入默认账号密码登录。默认账号是admin_change_me，密码是admin。

登录进来之后主界面是英文的。没关系，点右上角的设置按钮。这个时候会要求输入密码，这个密码就是部署时自定义的密码保护。输入之后回车。

然后在设置里找到Language，选择Chinese Simplified，点击Save保存。这样界面就变成中文了。顺便把时区也改成国内的Asia/Shanghai，这样笔记的时间戳才对。

基础设置部分是需要你单独设置密码访问的，POZNOTE_SETTINGS_PASSWORD: "baobaozi"。记得把这里的密码改成你自己的密码。

六、 实际使用体验

设置完成后创建一个笔记试试。Poznote支持的笔记类型挺多的，Markdown、富文本都有，我个人最喜欢Markdown。

实测Markdown的支持非常友好。我把之前的笔记直接复制粘贴进去，主副标题、表格、图片都能完美识别，还能自定义标签方便日后的搜索和管理。最好用的一点是它实时渲染Markdown的格式，编辑起来很方便。

命令模式也很丰富，基本上能想到的和创作有关的编辑模式它都支持。写文档、记代码、做清单都很顺手。

Excalidraw的集成是加分项。画流程图的时候不用切出去找工具，直接在笔记里就能画，保存后和笔记存在一起，之后能继续编辑。做架构图、整理思路的时候特别方便。

重点说一下 AI Assistant / AI 知识调用能力。

最简单的方法就是用Poznote内置的AI助手，服务的话直接接入自己的AI订阅服务就行，我接的是梁圣的DeepSeek。

按照标准的AI API接入流程配置好AI助手之后就可以开始用了。

使用AI助手的话，直接去仪表盘里面点出现的AI图标就行。

出现AI聊天窗口之后，你可以直接让它处理你内置的笔记文件。

比如我让它新建一个笔记文件，把指定内容放进去，它就很快完成了。

Poznote内置的AI助手能做什么：

搜索和阅读：AI 可以自主搜索和阅读你所有的笔记。你可以直接问它“帮我找找上个月关于项目X的笔记”，它会自动检索。

创建和修改：当你明确要求时，它可以创建新笔记、重命名笔记或重写内容。

隐私保护：Poznote 的 AI 请求是从服务器端发出的，而不是你的浏览器，这能更好地保护隐私。如果你使用的是本地 Ollama 等模型，你的笔记和对话甚至不会离开你的设备

第二种AI用Poznote的方法就是通过 MCP 服务器连接外部 AI（高级用法）。

这是更强大的用法，适合开发者或希望在不同应用（如代码编辑器）中调用笔记的用户。Poznote 内置了 MCP (Model Context Protocol) 服务器。

比如你可以用Cherry Studio的MCP连上Poznote用它。

打开 Cherry Studio，进入 设置 (Settings) 页面。

找到 MCP 选项：在设置页面中，找到 MCP 服务器 (MCP Servers) 选项。

添加服务器：点击 添加服务器 (Add Server) 按钮。

填写配置信息：在弹出的窗口中，你需要填写以下关键信息：

名称 (Name)：可以任意填写，比如 Poznote-MCP。

类型 (Type)：选择 streamable-http（因为 Poznote 的 MCP 服务器仅支持此传输方式）。

URL：填写 Poznote MCP 服务的地址，即 http://192.168.192.141:8045/mcp。

如果你跟我一样还部署了内网穿透，那你直接把http://192.168.192.141:8045/mcp换成你的内网穿透的地址，就可以在异地的时候也能正常调用你放在家里的威联通Qu805上的资料。

其他参数：Cherry Studio 的界面可能还要求填写其他参数，通常保持默认即可。如果涉及到认证（Authorization），你可能需要填写在 Poznote 中生成的 MCP 服务令牌（Service Token）。

小提示：Cherry Studio 也提供了自动安装 MCP 的功能，但由于 Poznote 的 MCP 服务器需要连接到你本地自建的服务，手动添加URL的方式是更直接和可靠的选择。

配置好之后记得去MCP服务器里面启用一下这个。

能看到MCP服务支持39项可自动化执行的工具，全部启用并设置自动批准。然后回到聊天窗口，随便给它下达一个创建笔记的命令，几秒钟就反馈创建成功。打开Poznote主页，能看到确实新增了一个刚才在Cherry Studio端下达的创建任务。

这个功能的实际意义在于，笔记库从单纯的个人记录，变成了AI可以直接调用的知识底座。AI能读你的笔记、查资料、帮写文档、整理知识、生成内容。Poznote 的笔记原始数据默认存储在 NAS；是否向第三方发送笔记内容，取决于你接入的是本地模型还是云端 AI API。

七、 资源占用

Poznote是轻量级应用，资源占用很低。跑了一周观察下来，两个容器加起来的内存占用几乎可以忽略不计，相比RAGFlow那套五六个容器动辄十几个GB内存的吃法，Poznote对NAS来说基本无感。

CPU平时也不占，只有打开页面、编辑笔记、执行搜索的时候会短暂起来一下。7×24小时挂着完全没问题。

存储方面，笔记数据、上传的附件、Excalidraw的绘图文件都存在映射的data目录里。SQLite数据库也在同一个目录下，备份的时候直接把整个data目录复制出来就行，非常方便。

八、踩坑记录

坑一，镜像拉取慢。 ghcr.io的镜像国内直连不稳定，第一次拉取等了很久。解决方法是给Container Station配置镜像加速，或者换个网络环境再拉。

坑二，端口冲突。 8040端口如果被占用，网页就打不开。部署前先确认一下端口有没有被其他服务占用，冲突了就在Compose里改掉冒号前面的端口。

坑三，忘记密码保护。 进设置页面要输部署时自定义的密码，第一次没记住，翻了半天Compose配置才找到。建议把这个密码记下来，或者放在密码管理器里。

坑四，MCP接不上。 配置Cherry Studio的MCP服务器时，URL写错了端口，导致连接失败。注意要填mcp服务器的端口8045，加mcp路径，不是网页的8040端口。

九、总结

Poznote解决了一个很实际的问题。记笔记这件事，大多数人都在用云服务，把内容交给第三方。Poznote把这件事拿回了自己手里，数据全部留在本地，同时功能上一点都不比云笔记弱，反而多了可视化绘图和AI集成的能力。

部署成本很低，Container Station里粘贴一段Compose配置就能跑起来，两个轻量容器对NAS的资源占用几乎可以忽略。装完之后，笔记、文档、附件、绘图集中管理，跨设备网页访问，还能接入AI客户端构建个人知识库。

如果你在NAS上跑Docker，需要一个数据私有、功能完整、能接AI的笔记平台，Poznote是很值得试试的选择。特别是MCP这个能力，把笔记从死的记录变成了AI能用的知识底座，这是很多同类软件做不到的。接下来我打算把工作文档和历史笔记都迁进去，用AI做一次知识整理，看看实际效果怎么样，有结果再更新。