nikunjsingh/glass-keep

镜像概述和主要用途

该镜像是一款开源、完全免费、自托管的Google Keep替代品，提供类Google Keep的笔记管理体验。支持通过Docker一键部署Web应用及API服务，适合需要私有化部署笔记系统、注重数据隐私的个人或团队使用，可作为Google Keep的自托管替代方案。

核心功能和特性

• 开源免费自托管：完全开源且免费，支持本地服务器部署，数据自主掌控，无需依赖第三方服务
• 一键Docker部署：提供Web应用与API的秒级部署能力，简化安装流程，无需复杂配置
• Google笔记导入：支持从Google Takeout导出的.json文件导入原有Google Keep笔记，实现无缝迁移
• 实时协作清单：支持清单共享及实时协作功能，多人可同时编辑并实时查看勾选状态
• Markdown支持：内置Markdown编辑器与查看器，支持.md格式笔记的创建与预览
• 内置认证机制：无需依赖第三方API，系统内置用户认证功能，保障数据访问安全

使用场景和适用范围

• 个人笔记管理：替代Google Keep作为个人日常笔记、待办事项的管理工具，数据存储在自有服务器
• 团队协作办公：团队成员共享清单进行任务协作，实时更新任务状态，提升协作效率
• 数据隐私保护：对数据隐私有较高要求的用户，通过自托管方式避免数据存储在第三方平台
• Google Keep迁移用户：需要从Google Keep迁移且希望保留原有笔记数据的用户

使用方法和配置说明

基本部署（Docker Run）

通过以下命令快速部署应用：

docker
docker run -d -p 8080:8080 --name keep-alternative --restart unless-stopped [镜像名称]

说明：将[镜像名称]替换为实际镜像名，默认映射8080端口，可根据需求调整端口映射（如-p 自定义端口:8080）

数据持久化配置

为避免容器重启导致数据丢失，建议挂载数据卷：

docker
docker run -d -p 8080:8080 --name keep-alternative -v /本地数据路径:/app/data --restart unless-stopped [镜像名称]

说明：/本地数据路径为宿主机用于存储笔记数据的目录，确保目录权限正确

导入Google Keep笔记

1. 从Google Takeout下载笔记数据（格式为.json）
2. 部署应用后访问Web界面（默认地址：http://localhost:8080%EF%BC%89
3. 进入"设置"→"导入"页面，上传下载的.json文件，系统将自动导入笔记

内置认证设置

应用部署后首次访问需创建管理员账户，后续可通过"用户管理"添加多用户，支持基于角色的访问控制，无需配置第三方认证服务。

PWA使用

在浏览器中访问应用后，点击地址栏"安装"按钮（或通过浏览器菜单"添加到主屏幕"），即可将应用添加为桌面/PWA应用，支持离线访问功能。