Jelu Java部署完全指南：3步用单个Jar跑起你的图书追踪器

Jelu Java部署完全指南：3步用单个Jar跑起你的图书追踪器

【免费下载链接】jeluSelf hosted read and to-read list book tracker项目地址: https://gitcode.com/gh_mirrors/je/jelu

Jelu 是一个自托管（self hosted）的图书追踪器，帮你记录已读、在读和想读的书籍，堪称"个人版 Goodreads"。本文带你完成 Jelu Java 部署：只需一个 Jar 文件，3 步即可在本地或服务器上启动你的图书追踪器，全程无需数据库安装——所有数据保存在单文件数据库中，随时备份、随时迁移。

Jelu 图书追踪器能做什么？

Jelu 解决的核心痛点是：在线读书服务关停后数据丢失。Jelu 将你的阅读数据完全掌握在自己手中：

• 📖 记录已读书籍，按月/年查看阅读历史
• 📚 管理"想读清单"（to-read list）
• 🔍 通过书名、作者或 ISBN 自动搜索导入图书元数据（支持 epub/OPF 文件导入、移动端相机扫 ISBN）
• 🏷️ 标签与自定义书架、作者页面（自动从维基百科导入作者信息）
• ✍️ 撰写书评并共享、生成嵌入代码（embed snippet）嵌入博客和 Markdown 笔记
• 🔗 提供完整 API，可对接任何第三方工具；支持多用户（LDAP 登录、代理认证）

下面是 Jelu 图书追踪器的首页，展示阅读统计与待读书单：

部署前准备：检查 Java 环境

Jelu 是一个 Spring Boot fat jar，依赖全部打包在内，唯一前置要求是Java 17 或更高版本（项目构建与 Docker 镜像均基于 Temurin 17）。在终端执行：

java -version

若未安装或版本低于 17，安装 JDK 17 即可。建议将 Jar 放在一个专用目录，例如~/jelu，后续所有步骤都在该目录进行。

3步完成 Jelu Java 部署

第1步：下载 Jelu 单个 Jar 文件

从项目的 releases 区域下载最新版本的jelu-x.x.x.jar，放入你的专用目录（如~/jelu）。这个 Jar 就是全部——前端界面（源码位于 src/jelu-ui/）已编译打包其中。

第2步：一键启动图书追踪器

进入 Jar 所在目录，运行：

java -jar jelu-0.13.0.jar

应用启动入口在 src/main/kotlin/io/github/bayang/jelu/JeluApplication.kt，首次启动会自动创建 SQLite 数据库（默认位于~/.jelu/database/）并完成 Liquibase 数据库迁移。

第3步：打开浏览器访问 localhost:11111

默认端口为11111（配置见 src/main/resources/application.yml）。在浏览器中打开：

http://localhost:11111

看到登录页即部署成功。创建账号后，你就可以开始导入书籍了：

在图书详情页可以标记"正在读/读完/放弃"，并记录阅读事件：

可选：用 application.yml 自定义配置

想微调默认行为时，只需在 Jar 同目录创建application.yml即可覆盖 src/main/resources/application.yml 中的默认值。

1. 让数据库与 Jar 放在一起（方便备份）：

jelu: database: path: .

2. 启用在线自动元数据搜索：该功能依赖 Calibre 的fetch-ebook-metadata工具，Java 部署需手动指定其路径：

jelu: metadata: calibre: path: /usr/bin/fetch-ebook-metadata

配置好后，导入界面可按标题、作者或 ISBN 检索并预览元数据：

搜索命中后的预览结果，导入前还能修改标签等信息：

3. 收紧 CORS 策略（默认接受所有来源，生产环境建议限制）：

jelu: cors.allowed-origins: - https://jelu.myserver.org

可选：从源码构建 Jelu

想自己编译？只需 Java 17 和源码（构建说明见 BUILD.md）：

git clone https://gitcode.com/gh_mirrors/je/jelu cd jelu ./gradlew copyWebDist && ./gradlew assemble

产物在build/libs/jelu-<版本号>.jar，与 releases 发布的 Jar 完全一致。

部署完成后的使用建议

• 🗂️备份简单：所有数据集中在单个 SQLite 文件（jelu.db），连同~/.jelu/files/下的封面图一起拷贝即可完整迁移。
• 🐳更省事的选择：如果熟悉 Docker，官方镜像已内置fetch-ebook-metadata，免配置即可用自动导入（构建流程见 Dockerfile）。
• 📝写书评、分享阅读：部署后即可撰写书评并嵌入外部网站：

作者页面会展示作者简介及其全部作品，方便按作者维度管理书库：

现在，你的自托管图书追踪器已经跑起来了——从 Goodreads 导入历史数据，开始记录每一本书吧！📚

【免费下载链接】jeluSelf hosted read and to-read list book tracker项目地址: https://gitcode.com/gh_mirrors/je/jelu