Bibliotheca 镜像文档

概述

Bibliotheca 是一款基于 Flask 框架开发的自托管 Web 应用镜像，专为个人用户设计，提供图书馆管理与阅读追踪功能。用户可通过该镜像快速部署个人化的藏书管理系统，实现书籍信息的集中管理和阅读进度的实时记录，所有数据本地存储，保障隐私安全。

核心功能与特性

藏书管理

• 支持添加、编辑、删除书籍信息，包括标题、作者、ISBN、分类、封面等元数据
• 支持书籍标签管理，可自定义分类体系
• 支持实体书与电子书统一管理，支持导入/导出书籍数据

阅读追踪

• 记录每本书的阅读状态（未读/在读/已读）
• 跟踪阅读进度（页码、百分比）与阅读笔记
• 支持设置阅读目标与截止日期

数据管理与统计

• 本地 SQLite 数据库存储，数据持久化不依赖第三方服务
• 生成阅读时长、完成率、书籍分类占比等统计报表
• 支持数据备份与恢复

部署特性

• 轻量级架构，资源占用低，适合个人服务器或家庭 NAS 部署
• 无需复杂配置，一键启动，开箱即用

使用场景与适用范围

• 个人藏书管理：家庭用户整理实体书或电子书库，建立个人数字书架
• 阅读*惯培养**：记录每日阅读进度，通过数据统计优化阅读计划
• 学*资料管理**：学生或研究者分类管理专业书籍与文献，关联阅读笔记

使用方法与配置说明

基本部署（Docker Run）

通过以下命令快速启动容器：

docker run -d \
  --name bibliotheca \
  -p 5000:5000 \
  -v /path/to/your/data:/app/data \
  --restart unless-stopped \
  bibliotheca:latest

参数说明：

• -p 5000:5000：映射容器内 Flask 默认端口 5000 到主机端口 5000
• -v /path/to/your/data:/app/data：挂载本地目录至容器内数据目录，确保数据持久化
• --restart unless-stopped：容器异常退出后自动重启

Docker Compose 配置

创建 docker-compose.yml 文件，配置如下：

version: '3.8'
services:
  bibliotheca:
    image: bibliotheca:latest
    container_name: bibliotheca
    ports:
      - "5000:5000"
    volumes:
      - ./bibliotheca-data:/app/data
    environment:
      - FLASK_ENV=production
      - DATA_PATH=/app/data
    restart: unless-stopped

执行 docker-compose up -d 启动服务。

环境变量配置

可通过环境变量自定义应用行为，常用变量如下：

访问与使用

1. 部署完成后，通过浏览器访问 http://<主机IP>:5000 进入应用
2. 首次使用需创建管理员账户（默认管理员账户需在首次访问时设置）
3. 通过「添加书籍」功能录入藏书信息，或通过导入功能批量添加
4. 在「我的书架」中查看所有书籍，点击「开始阅读」记录阅读进度

注意事项

• 数据目录 /app/data 需确保挂载至持久化存储，避免容器删除导致数据丢失
• 生产环境建议设置自定义 SECRET_KEY 以增强安全性
• 如需修改默认端口，需同时调整容器端口映射与 PORT 环境变量