Glass Keep

Glass Keep是什么？

Glass Keep是一个开源的笔记应用，可以说是Google Keep的替代方案，但却拥有更漂亮的玻璃拟态（glassmorphism）风格，也包含更多信息内容。它基于 React + Tailwind 前端和 Express + SQLite 后端构建，支持自托管和 Docker 部署。它不仅能让个人用户管理自己的笔记、列表等信息，还提供多种多人实时协作功能。Glass Keep 对任何规模的团队，即使是个人，都非常友爱。

核心亮点

• 多样化笔记：支持 Markdown、清单、图片上传与压缩、标签、颜色主题、置顶与拖拽排序
• 实时协作：多人可同时编辑 Markdown 笔记和清单，变更即时同步
• 组织与搜索：标签侧边栏、快速筛选、全文搜索（标题、内容、标签、图片名）
• 批量操作：多选笔记进行下载、删除、置顶或改颜色
• 导入导出：支持 JSON 备份/恢复，可直接导入 Google Keep（Google Takeout 导出的 JSON）
• PWA 支持：可安装到桌面或手机，支持离线使用
• 用户与安全：注册/登录、密钥恢复、管理员后台（用户管理、存储统计、删除用户）

技术栈

• 前端：React + Tailwind + Vite
• 后端：Express + SQLite（better-sqlite3）
• 部署：支持 Node.js 环境或 Docker 一键运行

应用场景

• 个人笔记与知识管理
• 小团队的共享任务与协作
• 从 Google Keep 平滑迁移到自托管环境

Glass Keep安装部署及使用教程

一、安装与部署

方式一：开发环境运行

1. 安装依赖：npm install（没有依赖时再加上 concurrently nodemon express better-sqlite3 cors jsonwebtoken bcryptjs）。
2. 启动服务（mac/Linux）：ADMIN_EMAILS=”your-admin-username” npm run dev。
3. 启动服务（Windows PowerShell）：setx ADMIN_EMAILS “your-admin-username” 和然后执行：npm run dev。
4. 前端地址：http://localhost:5173，API 地址：http://localhost:8080。
5. 设置管理员（可选）：直接在文件 server/data.sqlite 上执行 UPDATE users SET is_admin = 1 WHERE email = ‘your-admin-username’;

方式二：Docker 部署

1. 拉取镜像：docker pull nikunjsingh/glass-keep:latest。
2. 创建数据目录：mkdir -p ~/.glass-keep。
3. 运行容器：执行 docker run -d …（包含端口映射、环境变量、数据卷挂载）。
4. 访问应用：http://localhost:8080。
5. 管理后台：http://localhost:8080/#/admin。

二、使用教程

1. 创建笔记：选择 Note/Checklist，内容选择标题，选择标签，选择颜色或者图片，在输入框下侧点击 Add Note。
2. Markdown编辑：编辑可使用 Markdown 支持的工具如标题、加粗、斜体、代码块、引用、列表、链接，也可选择有格式化工具栏和 Smart Enter。
3. 图片管理：上传图片自动压缩，点击可全屏预览、下载或切换。
4. 笔记组织：支持置顶、拖拽排序、标签筛选和全文搜索。
5. 批量操作：多选笔记后可下载、删除、置顶或改颜色。
6. 导入导出：支持 JSON 导出备份、JSON 合并导入以及 Google Keep 的导入。
7. 用户与安全：支持注册登录，下载 Secret Key，恢复登录该账号，管理员后台创建或删除用户和数据存储。