
Magic Resume
Magic Resume 是一个现代化的在线简历编辑器,让创建专业简历变得简单有趣。基于 TanStack Start 和 Motion 构建,支持实时预览和自定义主题。
Bookshelf 是一个轻量级、开源的自托管电子书库解决方案。它摒弃了传统复杂的数据库架构,直接将 EPUB 和 PDF 文件存储在对象存储(如 Cloudflare R2)或本地文件系统中。用户只需将书籍放入指定文件夹,即可通过浏览器在线阅读,或通过 OPDS 目录在 Kobo 等电子阅读器上同步阅读。
Bookshelf 是一个轻量级、开源的自托管电子书库解决方案。它摒弃了传统复杂的数据库架构,直接将 EPUB 和 PDF 文件存储在对象存储(如 Cloudflare R2)或本地文件系统中。用户只需将书籍放入指定文件夹,即可通过浏览器在线阅读,或通过 OPDS 目录在 Kobo 等电子阅读器上同步阅读。

需要 Node 24+ 及类 Unix 系统(不支持 Windows)。
git clone https://github.com/murerkinn/bookshelf.git
cd bookshelf
npm install
npm run demo
npm run demo 会自动生成 9 本公有领域书籍(8 本 EPUB + 1 本 PDF)并启动本地服务。
最简单且自带封面生成工具的部署方式。
mkdir books && cp ~/Downloads/*.epub books/
docker compose run --rm sync --create
docker compose up -d
访问 http://localhost:3000 即可查看书库。
修改 bookshelf.config.json 使用文件系统提供者:
{ "storage": { "provider": "fs", "directory": "shelf-data" } }
然后运行:
npm run sync -- --create
npm run build
npm start -w @bookshelf/app
编辑配置文件指向您的 R2 存储桶和 Worker,然后运行:
npx wrangler login
npm run sync -- --create
npm run deploy
| 环境变量 | 作用 |
|---|---|
BOOKSHELF_READ_ONLY | 设为 1 时禁止写入操作,适合公共只读环境。 |
BOOKSHELF_PROVIDER | 覆盖构建时使用的存储提供者(如 fs 或 r2)。 |
BOOKSHELF_DIRECTORY | 指定文件系统提供者查找书籍的目录。 |
BOOKSHELF_SITE_URL | 设置公共访问地址,用于生成正确的预览链接。 |







