绿联NAS搭建ZNote私有笔记

一、ZNote介绍
引用自https://github.com/helloxz/znote
ZNote是一款小而美的纯笔记应用，原生支持 Markdown 所见即所得，一处部署，随处可用。使用Bun + Hono.js + libSQL + Vue3开发。

特点

• 纯笔记应用：无脑图、无清单、无多余功能，只专注于笔记本身
• 原生 Markdown：所见即所得，支持所见即所得，专注内容不打扰
• 无同步困扰：服务端集中存储数据，用户无需折腾同步方案
• AI 智能检索：与 AI 对话，智能检索笔记内容，精准匹配并回答
• 私有部署：提供 Docker 私有部署，数据完全自主掌控，本地存储，隐私无忧
• WEB 访问：浏览器即开即用，无需安装客户端，跨平台无障碍
• 拖拽排序：笔记分类、笔记内容均支持拖拽排序
• 数据导入：支持将本地 .md 文件分类打包 ZIP 后一键导入
• 数据导出： 支持笔记数据导出，方便您迁移到其它笔记
• 公共文档： 一键将笔记本公开分享为类似语雀的文档系统
• 笔记分享： 支持将单篇笔记设置密码公开分享，还可以设置有效期
• 版本历史：自动记录最近 50 个历史版本，随时回滚无惧丢失
• 移动端支持：提供配套的安卓APP，移动端使用更佳
• 多用户支持：支持多账号体系（最多 5 用户），适合个人或家庭使用
• 全局搜索：跨分类全文检索，输入关键词秒级定位所需笔记
• API 支持：提供 RESTful API，方便第三方工具集成与自动化操作
  
  

待办事项列表

• 导出所有笔记
• 文档功能
• 笔记分享
• 手机客户端
• AI功能
• 支持多语言
• 浏览器扩展
• PC客户端
  
  

Docker Compose：

1. <font face="微软雅黑"># docker-compose.yml 配置文件
   
2. # 定义了整个应用的服务、网络和存储等
   
3. 
   
4. services:                         # 定义所有服务（容器）的集合
   
5.   znote:                          # 服务名称，可自定义，这里命名为 znote
   
6.     container_name: znote         # 指定容器的名称，启动后可用 docker ps 看到名为 znote 的容器
   
7.     image: helloz/znote:latest    # 使用的 Docker 镜像及标签，表示从 Docker Hub 拉取 helloz/znote 的最新版本
   
8.     ports:                        # 端口映射设置，将宿主机的端口映射到容器内部端口
   
9.       - "3888:3888"               # 将宿主机的 3888 端口映射到容器的 3888 端口，外部通过宿主机IP:3888 访问服务
   
10.     volumes:                      # 数据卷挂载，用于持久化数据或共享文件
    
11.       - "./data:/app/data"        # 将当前目录下的 ./data 目录挂载到容器内的 /app/data，使数据保存在宿主机，避免容器删除后丢失
    
12.     restart: always               # 重启策略：无论容器因何退出，都自动重启，保证服务持续运行
    
13.     environment:                  # 环境变量设置，向容器内传递配置参数
    
14.       TZ: Asia/Shanghai           # 设置容器内时区为 Asia/Shanghai（北京时间），影响日志时间等
    
15.       ZNOTE_ALLOW_REGISTER: "false"   # 是否允许新用户注册，可选值为 true 或 false，默认 false（不允许注册）</font>

复制代码

二、绿联NAS部署

此时就完成了，可以愉快的玩耍了

三、其他补充：
1、环境变量

可用的环境变量如下：

• ZNOTE_APP_NAME ：网站名称（后续可能发生变更）
• ZNOTE_PORT ：端口号，默认 3888 ，一般不建议修改
• ZNOTE_ALLOW_REGISTER ：是否允许注册，可选值为 true 或 false ，默认 false 不允许注册
  

2、备用镜像

如果您是国内网络，无法拉取Docker进行，可以使用我们提供的备用镜像地址： pub.tcp.mk/helloz/znote

只需要将上面的 helloz/znote 替换为 pub.tcp.mk/helloz/znote

3、作者的演示站

• 演示地址： https://znote.xphub.dev/
• 账号： demo
• 密码： blog.xiaoz.org
  

好用

支持，多发

挺好的，但是好像没有AI功能或者不能接入Ai? 现在要写周报等，没有ai就要自己总结自己写，麻烦呀。

胖子牛蛙

playok 发表于 2026-7-8 19:38
挺好的，但是好像没有AI功能或者不能接入Ai? 现在要写周报等，没有ai就要自己总结自己写，麻烦呀。 ...

有啊🤓有ai

梦梦 发表于 2026-7-8 20:01
胖子牛蛙

我很胖吗？请叫我亲爱的白

峰行 发表于 2026-7-8 16:35
支持，多发

好的👌(｡•̀ᴗ-)✧

momo 发表于 2026-7-8 14:25
好用

多用

蓝小白 发表于 2026-7-8 21:28
有啊🤓有ai

啊，我看演示网站上没有呢