【Docker项目实战】使用Docker部署Nanote轻量级笔记应用程序

【Docker项目实战】使用Docker部署Nanote轻量级笔记应用程序

一、Nanote介绍

1.1 Nanote简介

Nanote是一款轻量级、自托管的笔记应用程序，采用文件系统进行数据存储，真正实现100%可移植的笔记管理体验。使用 Nuxt 3 和 TypeScript 构建，界面简洁高效，支持 Markdown 编辑、全局搜索、Docker 部署及类型安全的 API，是追求自由与控制力的用户的理想选择。

1.2 主要特点

• 基于笔记本的组织结构：以文件夹作为笔记本，Markdown 文件作为笔记，结构清晰易管理。

• 全局内容搜索功能：支持跨所有笔记的快速检索，并针对操作系统进行了性能优化。

• 原生 Markdown 支持：无缝处理 .md 文件，提供标准 MIME 类型识别和渲染支持。

• 纯本地文件存储：无需数据库，所有数据都直接保存在你的文件系统中，完全掌控数据归属。

• 开箱即用的 Docker 支持：提供完整的容器化部署方案，包含示例 docker-compose.yml 文件。

• TypeSafe API 接口：后端 RESTful API 全面类型化并带有输入验证，保障接口安全与稳定。

• 极致性能优化：对文件操作和平台特定搜索进行了深度优化，提升响应速度与用户体验。

• 响应式移动设备支持：界面适配手机和平板，支持随时随地查看和编辑笔记内容。

二、本次实践规划

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为Ubuntu 22.04.1。

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎；2.在Docker环境下部署Nanote轻量级笔记应用程序。

三、本地环境检查

3.1 检查Docker服务状态

检查Docker服务是否正常运行，确保Docker正常运行。

root@jeven01:~# systemctl status docker
● docker.service - Docker Application Container Engine
Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
Active: active (running) since Wed 2025-07-02 14:16:57 UTC; 21h ago
TriggeredBy: ● docker.socket
Docs: https://docs.docker.com
Main PID: 878 (dockerd)
Tasks: 28
Memory: 1.2G
CPU: 1min 50.356s
CGroup: /system.slice/docker.service
├─ 878 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock

3.2 检查Docker版本

检查Docker版本

root@jeven01:~# docker -v
Docker version 27.1.1, build 6312585

3.3 检查docker compose 版本

检查Docker compose版本，确保2.0以上版本。

root@jeven01:~# docker compose version
Docker Compose version v2.19.1

四、拉取Nanote镜像

拉取Nanote容器镜像，当前最新版本为0.9.3。

docker pull omarmir/nanote:0.9.3

null

五、部署Nanote服务

5.1 创建部署目录

• 创建部署目录

mkdir -p /data/nanote && cd /data/nanote

5.2 编辑部署文件

docker-cli方式部署，可采纳开以下命令：

docker run -d \
--restart unless-stopped \
--name nanote \
-p 3000:3000 \
-v /data/nanote/notes:/notes \
-e NOTES_PATH=/notes \
-e SECRET_KEY=123456 \
omarmir/nanote:0.9.3

在部署目录下，创建docker-compose.yaml文件，如下所示：

vim docker-compose.yaml

version: '3.9'
services:
nanote:
image: 'omarmir/nanote:0.9.3'
environment:
- SECRET_KEY=123456
- NOTES_PATH=/notes
volumes:
- '/data/nanote/notes:/notes'
ports:
- '3000:3000'
container_name: nanote
restart: always

5.3 创建Nanote容器

执行以下命令，创建Nanote容器。

docker compose up -d

null

5.4 查看Nanote容器状态

检查Nanote容器运行状态，确保Nanote容器正常启动。

root@jeven01:/data/nanote# docker compose ps
WARN[0000] /data/nanote/docker-compose.yaml: the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusion
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
nanote omarmir/nanote:0.9.3 "docker-entrypoint.s…" nanote 36 seconds ago Up 36 seconds 0.0.0.0:3000->3000/tcp, [::]:3000->3000/tcp

5.5 查看Nanote容器日志

检查Nanote容器运行日志，确保Nanote服务正常运行。

docker compose logs

null

六、访问Nanote服务

浏览器地址： http://<个人的服务器IP>:3000，访问Nanote的初始页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。

null

第一次进入Nanote初始页，我们使用设置的默认密钥123456进行登录。

null

null

七、Nanote基本使用

7.1 新建笔记本

在右上角填写笔记本名称后，确认新建笔记本。

null

7.2 新建笔记

在点击笔记本名称后，选择“Add”选项，填写笔记标题并完成新建操作。

null

编辑笔记内容，如下所示：

null

7.3 浏览笔记

笔记编辑完毕后，可双击笔记名称打开在线浏览，效果如下所示：

null

八、总结

通过 Docker 部署 Nanote 轻量级笔记应用，整个过程简洁高效，极大地简化了环境配置和部署流程。借助容器化技术，用户可以快速搭建一个自托管、基于文件系统的笔记管理平台，实现数据的完全掌控与高可移植性。无论是本地开发还是云端部署，Nanote 结合 Docker 都是一个值得推荐的知识管理解决方案。