一键搭建私人图书馆！Docker部署BookLogr全攻略

发表于： 2025年4月16日 2025年4月16日
分类：未分类

一键搭建私人图书馆！Docker部署BookLogr全攻略

兄弟们是不是经常遇到这种情况：书架上堆满了书却总找不到想看的？电子书下载了一堆却记不住哪本读了一半？今天二冰给大家带来一款堪比豆瓣书单的自托管图书馆管理系统，手把手教你在NAS上部署！

一、项目简介

BookLogr（项目地址：https://github.com/Mozzo1000/booklogr）是一款专为读书狂魔打造的开源工具。它能帮你：

✅ 记录藏书清单
✅ 管理读书进度
✅ 撰写读书笔记
✅ 生成阅读报告✅ 分享书单到Mastodon

最牛的是所有数据都掌握在自己手里，再也不用担心平台倒闭或者隐私泄露！

二、四大核心优势

1. 数据私有化 – 完全掌控自己的读书数据
2. 豆瓣级体验 – 支持书籍评分/标签/状态管理
3. 多端适配 – 手机/平板/电脑全平台可用
4. 社交属性 – 可选择性公开个人书单

功能展示

三、Docker部署指南

准备文件

新建docker-compose.yml和.env文件：

version: '3'

services:
  web:
    image: wbsu2003/booklogr-web
    ports:
      - 5173:5173
    env_file:
      - .env

  db:
    image: postgres
    volumes:
      - ./db_data:/var/lib/postgresql/data
    env_file:
      - .env

  api:
    image: wbsu2003/booklogr
    ports:
      - 5004:5000
    env_file:
      - .env

  auth:
    image: wbsu2003/auth-server
    ports:
      - 5003:5000
    env_file:
      - .env

环境变量文件.env配置：

# 数据库配置
POSTGRES_USER=admin
POSTGRES_PASSWORD=yourpassword
POSTGRES_DB=booklogr

# API配置
VITE_API_ENDPOINT=http://你的IP:5004/
VITE_AUTH_API_URL=http://你的IP:5003

一键启动

打开Dockge面板 -> 创建堆栈 -> 设置堆栈名称 -> 粘贴compose代码 -> 30秒启动成功！

四、使用手册

部署完成后访问http://你的IP:5173：

1. 书籍录入 – 支持ISBN扫码录入/手动添加
2. 进度管理 – 在读/已读/想读三状态切换
3. 笔记系统 – 支持Markdown格式读书笔记
4. 数据统计 – 年度阅读报告自动生成

书库管理

五、避坑指南

1. 国内用户需为容器配置科学上网（否则搜不到书籍信息）
2. 首次登录跳过邮箱验证直接使用
3. 建议配合Calibre实现电子书统一管理

六、总结

经过一周深度体验，二冰认为BookLogr特别适合：

藏书超过100本的纸质书爱好者
喜欢写读书笔记的深度阅读者想建立私人书单系统的技术宅

虽然目前还是Beta版（存在部分UI错位），但作为开源项目已经足够惊艳！想要打造专属图书馆的兄弟可以冲了，有部署问题欢迎在评论区交流！

最后，奉上我的超级无敌至尊docker库，二冰平时玩过的docker都整理到了这个仓库中了，一直在更新中，希望有github账号的兄弟能去给点个star，不知道玩啥的，都去这里面找，都给你们分好类了
仓库链接：https://github.com/TWO-ICE/Awesome-NAS-Docker

如果觉得教程有用，别忘了点赞收藏支持一波！评论区等你晒书单～

admin

2126