爱意满满的作品展示区。
xiaoz
1.03D

开源了一个笔记软件 ZNote,支持 WEB 访问和 Docker 部署

  •  4
     
  •   xiaoz ·
    helloxz · 5h 31m ago · 782 views

    我用过市面上很多笔记软件,比如:印象笔记、有道笔记、为知笔记、Obsidian 、Joplin 、Notion 、思源笔记、UpNote 、TriliumNext...,诚然这些软件都很优秀,但是有的不好看,有的太臃肿,有的同步困难,有的太过复杂,最后也没找到比较符合我胃口的,于是诞生了自己开发一款笔记软件的想法。

    都说独立开发离不开三件套:记账、清单、笔记,但我还是坚持开发了自己的笔记软件,先不说好不好用,至少尘埃落定,心愿已了,圆了当初的想法,如果各位 V 友用得上,可以部署试一下。

    CleanShot 2026-06-26 at 14.41.01@2x.png

    开源地址:https://github.com/helloxz/znote

    演示信息

    帮助文档:https://znote.xphub.dev/doc/guide

    哦,对了,上面的帮助文档也是用 ZNote 生成的,类似语雀文档那种。

    快速开始

    Docker Compose 部署方式如下,新建一个compose.yaml,内容如下:

    services:
      znote:
        container_name: znote
        image: helloz/znote:latest
        ports:
          - "3888:3888"
        volumes:
          - "./data:/app/data"
        restart: always
        environment:
          TZ: Asia/Shanghai
    

    然后docker compose up -d启动,访问 http://ip:3888完成账号初始化。

    部分截图

    笔记页面

    CleanShot 2026-06-29 at 09.51.08@2x.png

    文档模式的界面

    CleanShot 2026-06-29 at 09.52.26@2x.png

    版本历史功能

    CleanShot 2026-06-29 at 09.53.43@2x.png

    单个笔记密码分享功能

    CleanShot 2026-06-29 at 09.55.41@2x.png

    其它

    手机 APP 也在规划中,预计本周上线安卓 APP (如果顺利的话),如果各位有什么建议也可以在本贴留言或者 Github 反馈,感谢大家。

    23 replies    2026-06-29 14:31:00 +08:00
    hellodigua
        1
    hellodigua  
       5h 26m ago   ❤️ 1
    请问笔记内容是存在数据库的还是本地的?
    xiaoz
        2
    xiaoz  
    OP
       5h 23m ago
    @hellodigua #1 ,存你本地的哈,数据库用的 SQLite3 ( libSQL )
    hellodigua
        3
    hellodigua  
       5h 22m ago   ❤️ 1
    我最近也在调研新的笔记软件,但感觉现在真正的痛点不是功能多,而是需要一个编辑体验比 Obsidian 更好看的本地笔记软件。

    笔记软件我还是倾向于本地化。现在纯云同步笔记的优势已经没那么明显了,反而会限制很多玩法。

    尤其是 AI 时代,笔记最大的价值是能和 AI 工作流打通。本地笔记可以直接让 Codex 、Claude Code 、Hermes 这这样的 Agent 读取、搜索、整理,或者和其他本地软件做自动化联动。

    真的,现在大部分开发者的痛点是这个。
    xiaoz
        4
    xiaoz  
    OP
       5h 22m ago
    @hellodigua #1 ,笔记内容存的数据库( SQLite3 ),不是那种原始的.md 文件,原始的不好实现排序和历史版本。

    后台可以导出整个笔记,导出的内容都是原始.md 的,方便迁移。
    brzhang
        5
    brzhang  
       5h 21m ago via Android   ❤️ 1
    技术大牛
    xiaoz
        6
    xiaoz  
    OP
       5h 20m ago
    @hellodigua #3 ,嗯,你的想法和我一致,AI 功能也是在计划中的,必须要跟上 AI 时代。后续准备支持 MCP 和 AI 检索对话。
    hellodigua
        7
    hellodigua  
       5h 20m ago   ❤️ 1
    @xiaoz 用的 SQLite3 的话,那可能还需要提供额外的 MCP ,如果想要换其他的软件可能也很麻烦,如果你能做一个能平替 Obsidian ,那就能和 Obsidian 抢用户了

    要是太封闭的话,很多用户可能会担心迁移成本,反而不敢用

    毕竟独立开发者的持续维护性太差了,很容易担心多久会跑路等问题
    xiaoz
        8
    xiaoz  
    OP
       5h 19m ago
    @brzhang #5 ,不敢当,不敢当,大部分都是 AI 的功劳,我只负责监督和指挥,感谢支持。
    hellodigua
        9
    hellodigua  
       5h 18m ago   ❤️ 1
    我自己在用语雀,实际上语雀功能已经非常强大了,主要就还是担心数据主权问题

    所以我这次是铁了心打算迁移到支持纯本地 Markdown 的软件来维护了🤣

    实际上纯本地 Markdown 我觉得排序和历史版本也是方便做的,无非就是需要有一个和.git 一样的历史记录索引工具
    xiaoz
        10
    xiaoz  
    OP
       5h 17m ago
    @hellodigua #7 ,其实我用的 SQLite3 增强修改版 libSQL ,这个已经原生支持向量数据库,后续扩展相对也比较容易。

    没有打算平替 Obsidian ,Obsidian 用户很多,生态很好,我望尘莫及。

    担心跑路可以理解,不过 ZNote 是完全开源 + 提供了完整导出功能,所以不存在跑路风险,哈哈。
    xiaoz
        11
    xiaoz  
    OP
       5h 16m ago
    @hellodigua #9 ,嗯,可以用 json 的方式来实现排序,就是要麻烦些,纯本地也有本地的好处,就看个人需求和使用习惯了。
    RealYourDad
        12
    RealYourDad  
       5h 0m ago   ❤️ 1
    看起来不错
    xiaoz
        13
    xiaoz  
    OP
       4h 59m ago
    @RealYourDad #12 ,心动不如行动,赶紧跑起来试试。
    Harries
        14
    Harries  
       4h 56m ago   ❤️ 1
    不错哦。在家一个私密保护页面就好了,可以存一些敏感密码啥的
    Joming
        15
    Joming  
       4h 55m ago   ❤️ 1
    Z 大产品必属精品,希望后续能够支持 pq 或 mysql 数据库。
    xiaoz
        16
    xiaoz  
    OP
       4h 54m ago
    @Harries #14 ,密码还是交给专业的软件比较合适,我现在用的 Vaultwarden
    xiaoz
        17
    xiaoz  
    OP
       4h 53m ago
    @Joming #15 ,感谢支持。其实个人和家庭使用,SQLite 3 足够了,简单、轻量。pq 和 mysql 太重了,除非后面自己搞 SAAS 服务。
    ckaiii
        18
    ckaiii  
       4h 49m ago   ❤️ 1
    不错,支持一下
    moxz
        19
    moxz  
       4h 39m ago   ❤️ 1
    感谢开源,看着不错,试用一下!
    kite16x
        20
    kite16x  
       4h 21m ago   ❤️ 1
    先收藏慢慢学习
    BalianWang
        21
    BalianWang  
       3h 46m ago   ❤️ 1
    试用了一下,体验很不错!
    onlychen
        22
    onlychen  
       2h 5m ago   ❤️ 1
    插个旗
    xiaoz
        23
    xiaoz  
    OP
       59 mins ago
    @ckaiii
    @moxz
    @BalianWang
    感谢支持,使用愉快。
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Solana   ·   5556 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 80ms · UTC 07:30 · PVG 15:30 · LAX 00:30 · JFK 03:30
    ♥ Do have faith in what you're doing.