绿联NAS搭建ZNote私有笔记

一、ZNote介绍

ZNote是一款小而美的纯笔记应用,原生支持 Markdown 所见即所得,一处部署,随处可用。使用Bun + Hono.js + libSQL + Vue3开发。

20260708135713574-image

特点

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

待办事项列表

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

Docker Compose: 

# docker-compose.yml 配置文件
# 定义了整个应用的服务、网络和存储等

services:                         # 定义所有服务(容器)的集合
  znote:                          # 服务名称,可自定义,这里命名为 znote
    container_name: znote         # 指定容器的名称,启动后可用 docker ps 看到名为 znote 的容器
    image: helloz/znote:latest    # 使用的 Docker 镜像及标签,表示从 Docker Hub 拉取 helloz/znote 的最新版本
    ports:                        # 端口映射设置,将宿主机的端口映射到容器内部端口
      - "3888:3888"               # 将宿主机的 3888 端口映射到容器的 3888 端口,外部通过宿主机IP:3888 访问服务
    volumes:                      # 数据卷挂载,用于持久化数据或共享文件
      - "./data:/app/data"        # 将当前目录下的 ./data 目录挂载到容器内的 /app/data,使数据保存在宿主机,避免容器删除后丢失
    restart: always               # 重启策略:无论容器因何退出,都自动重启,保证服务持续运行
    environment:                  # 环境变量设置,向容器内传递配置参数
      TZ: Asia/Shanghai           # 设置容器内时区为 Asia/Shanghai(北京时间),影响日志时间等
      ZNOTE_ALLOW_REGISTER: "false"   # 是否允许新用户注册,可选值为 true 或 false,默认 false(不允许注册)

二、绿联NAS部署

1、打开文件管理器-选择共享文件夹-选择docker-新建文件夹-znote

20260708132915866-image

20260708132955202-image

2、打开docker应用-选择项目-创建

20260708133113251-image

3、输入项目名称znote-存放路径自动带出

20260708133213418-image

4、复制上方docker compose配置粘贴-点击立即部署

20260708133336770-image

5、等待下载镜像和配置生效-等待下载完成后点击完成

20260708133542708-image

20260708133626798-image

6、此时项目就启动了

20260708133658540-image

7、初始化

安装完毕后,局域网访问 http://设备ip:3888 ,首次使用会引导创建管理员账号。绿联支持uglink反代,在外网可以直接访问(路径:docker界面-容器-找到znote-点击快速访问)

20260708134058274-image

20260708134113534-image

20260708134212832-image

8、输入用户名、邮箱、密码进行初始化

20260708134320533-image

9、使用刚刚初始化使用的账号密码进行登录

20260708134357854-image

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

三、其他补充:

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、作者的演示站

© 版权声明
THE END
喜欢就支持一下吧
点赞9赞赏 分享