用途：Grimmory 是自托管应用，用于管理个人书库，支持 EPUB、PDF、MOBI、AZW/AZW3 电子书及 CBZ/CBR/CB7 漫画；具备浏览器内阅读、标注、Kobo/OPDS 同步、KOReader 进度同步、从 Google Books 与 Open Library 补全元数据以及多用户支持。
主要能力：内置阅读器与标注；书架、阅读进度按用户隔离；OPDS 目录供兼容阅读器（Kybook、Chunky、Moon+ Reader 等）访问；Kobo 设备同步与 KOReader 同步插件；BookDrop 自动导入并对元数据补全排队；支持本地认证与 OIDC。
使用方式：需 Docker 与 Docker Compose。先创建 .env（如 APP_USER_ID、APP_GROUP_ID、TZ、DATABASE_URL、DB_USER、DB_PASSWORD、DISK_TYPE、MYSQL_ROOT_PASSWORD、MYSQL_DATABASE），再创建 docker-compose.yml（grimmory 与 mariadb 两个服务，端口 6060，挂载 ./data、./books、./bookdrop），然后运行： docker compose up -d 查看日志：docker compose logs -f grimmory 健康检查：curl http://localhost:6060/api/v1/healthcheck 打开 http://localhost:6060 创建管理员账号。OPDS 地址为 http://<your-host>:6060/opds。
扩展与开发：后端为 Spring Boot + MariaDB，REST API 基路径 /api/v1/，提供 books、shelves 等端点；可从源码构建（./mvnw clean package -DskipTests，或 docker build -t grimmory:local .）。网络存储模式设 DISK_TYPE=NETWORK 可禁用删除/移动/重命名等破坏性操作，保留阅读、元数据与同步功能。
限制：元数据补全需容器具备外网访问；MariaDB 与 Grimmory 至少约 512 MB 内存，上万本书建议 1–2 GB；OIDC 具体变量需参考官网文档；许可为 AGPL-3.0。部分细节暂未提供。