开箱即用 Markdown 笔记应用,多库协作实时编辑,NAS 极简部署 Many Notes 内网穿透远程访问
作者
小编
发布时间

项目介绍
Many Notes 是一款简洁高效的 Markdown 笔记应用,专为用户提供开箱即用的笔记记录体验。这个项目采用现代化的技术栈构建,支持多用户管理、多个笔记库、实时协作、快速搜索等功能,让你可以轻松组织和管理自己的所有笔记内容。
项目的独特之处在于,它既利用数据库提供强大的功能支持,同时也将文件保存在文件系统中,确保你对笔记结构拥有完全的控制权,并且可以随时随地访问和备份。无论你是个人用户还是团队协作,Many Notes 都能满足你的需求。支持多个笔记库的创建,让你可以根据不同的主题或项目进行分类管理。
项目地址:点我跳转
部署安装
如果你需要在外网也能访问到项目,建议配置内网穿透服务。可以选择 帕斯内网穿透 这样的解决方案,先注册账号备用。具体的操作步骤可以 参考这份全平台上手指南,让你快速掌握内网穿透的使用方法。
Docker Compose 快速部署
这是最简单的部署方式,适合大多数用户。
第一步:创建配置文件
在你的 NAS 或服务器上创建一个 `compose.yaml` 文件,复制以下内容:
1services:2 php:3 image: brufdev/many-notes:latest4 restart: unless-stopped5 environment:6 - APP_URL=http://localhost7 volumes:8 - database:/var/www/html/database/sqlite9 - logs:/var/www/html/storage/logs10 - private:/var/www/html/storage/app/private11 - typesense:/var/www/html/typesense12 ports:13 - 80:80801415volumes:16 database:17 logs:18 private:19 typesense:
第二步:启动服务
打开你的 NAS 设备(飞牛、群晖等),进入 Docker 管理界面,将上述配置文件上传或复制,然后执行以下命令启动容器:
1docker compose up -d
第三步:配置调整
访问地址:根据你的实际情况修改 `APP_URL` 字段。如果你改变了端口(比如改为 8080),需要更新为 `http://localhost:8080`
时区设置:可以添加 `APP_TIMEZONE=Asia/Shanghai` 来设置时区(默认为 UTC)
上传限制:默认文件上传限制为 500M,如需增加可添加以下环境变量:
1- PHP_POST_MAX_SIZE=1G2- PHP_UPLOAD_MAX_FILE_SIZE=1G
环境变量说明:
必须设置:
`APP_URL`:应用访问地址
可选设置:
`APP_TIMEZONE`:时区设置(默认 UTC)
`PHP_POST_MAX_SIZE`:POST 请求大小限制(默认 500M)
`PHP_UPLOAD_MAX_FILE_SIZE`:文件上传大小限制(默认 500M)
如果你需要启用 OAuth 认证(如 GitHub、Google 等),可以添加对应的 `CLIENT_ID` 和 `CLIENT_SECRET` 环境变量。
第四步:访问应用
部署完成后,打开浏览器访问 `http://localhost`(如果改了端口就改成对应的端口号),即可看到 Many Notes 的登录界面。创建账户后就可以开始使用了。
端口说明:
容器内部服务运行在 8080 端口
通过 Docker 映射到主机的 80 端口
如果 80 端口被占用,可以修改为其他端口,比如改为 `8080:8080`
存储说明:
项目使用了四个持久化卷来保存数据:
`database`:SQLite 数据库文件
`logs`:应用日志
`private`:私密文件存储
`typesense`:搜索引擎数据
这些卷会自动创建并持久化保存,无需手动干预。
功能特性
Many Notes 提供了一系列强大的功能:
🔐 多用户支持:通过认证保护你的笔记
📚 多库管理:为不同的项目创建独立的笔记库
🔄 实时协作:邀请他人共同编辑笔记
🔍 快速搜索:支持容错搜索,快速定位笔记
📝 Markdown 编辑:强大的 Markdown 编辑器,自动保存
🏷️ 标签和链接:通过标签、链接和反向链接组织笔记
📄 PDF 导出:将笔记导出为 PDF 格式
🌓 主题切换:自动适配系统亮色/暗色主题
📱 PWA 支持:获得原生应用般的体验
💾 备份恢复:轻松导入导出笔记库
本篇教程结束,祝你使用愉快!