【Docker项目实战】使用Docker部署Bibliotheca阅读习惯管理工具一、Bibliotheca介绍1.1 Bibliotheca项目简介1.2 Bibliotheca主要特点二、本次实践规划2.1 本地环境规划2.2 本次实践介绍2.3 注意事项三、本地环境检查3.1 检查Docker服务状态3.2 检查Docker版本3.3 检查docker compose 版本四、拉取Bibliotheca镜像五、部署Bibliotheca服务5.1 创建部署目录5.2 编辑部署文件5.3 创建Bibliotheca容器5.4 查看Bibliotheca容器状态5.5 检查Bibliotheca容器日志六、访问Bibliotheca服务6.1 访问Bibliotheca初始页6.2 在线搜索6.3 添加书籍6.4 管理书籍阅读状态七、总结一、Bibliotheca介绍1.1 Bibliotheca项目简介Bibliotheca是一款基于 Flask 开发的可自托管个人阅读管理工具帮助用户轻松记录书籍、追踪阅读进度并可视化阅读成果。1.2 Bibliotheca主要特点通过输入 ISBN 自动抓取书籍信息与封面简化图书添加流程。支持从 Goodreads 导出的 CSV 文件批量导入阅读数据无缝迁移个人书库。提供四种阅读状态分类灵活管理“想读”、“在读”、“已读”等不同阶段的书籍。记录每日阅读活动帮助用户养成持续阅读的习惯并追踪阅读频率。自动生成每月读书总结的视觉化拼图便于分享阅读成就。集成 Google Books API实现快速搜索和精准导入书籍元数据。采用响应式 Bootstrap 界面设计适配桌面与移动设备提升多端使用体验。二、本次实践规划2.1 本地环境规划本次实践为个人测试环境操作系统版本为 Ubuntu 24.04.2 LTS。hostnameIP地址操作系统版本Docker版本部署项目备注jeven192.168.3.88Ubuntu 24.04.2 LTS28.5.0Bibliotheca——2.2 本次实践介绍1.本次实践部署环境为个人测试环境生产环境请谨慎2.在Docker环境下部署Bibliotheca个人电子图书馆。2.3 注意事项Bibliotheca 项目定位为阅读追踪与管理工具不提供书籍内容或在线阅读功能。请确保在合法合规、能科学上网的网络环境下使用本项目严格遵守国家关于互联网使用的各项法律法规。建议通过正规渠道获取图书资源并配合主流电子书管理软件进行个人阅读管理。使用过程中请注意个人信息保护避免访问存在安全风险的网站或下载不明来源的应用程序。三、本地环境检查3.1 检查Docker服务状态检查Docker服务是否正常运行确保Docker正常运行。rootjeven:~# systemctl status docker● docker.service - Docker Application Container Engine Loaded: loaded(/usr/lib/systemd/system/docker.service;enabled;preset: enabled)Active: active(running)since Sat2025-10-0413:29:05 UTC;2days ago TriggeredBy: ● docker.socket Docs: https://docs.docker.com Main PID:888(dockerd)Tasks:65Memory:1.2G(peak:1.4G)CPU: 3min23.296s CGroup: /system.slice/docker.service3.2 检查Docker版本检查Docker版本rootjeven:~# docker -vDocker version28.5.0, build 887030f3.3 检查docker compose 版本检查Docker compose版本确保2.0以上版本。rootjeven:~# docker compose versionDocker Compose version v2.39.4四、拉取Bibliotheca镜像下载Bibliotheca容器镜像镜像名称为pickles4evaaaa/bibliotheca:1.1.0。dockerpull pickles4evaaaa/bibliotheca:1.1.0五、部署Bibliotheca服务5.1 创建部署目录创建部署目录mkdir-p/data/bibliotheca/datacd/data/bibliotheca5.2 编辑部署文件使用docker-cli方式部署可参考以下命令dockerrun-d\--restartunless-stopped\--namebibliotheca\-p5054:5054\-v$(pwd)/data:/app/data\-eTIMEZONEAsia/Shanghai\-eWORKERS6\pickles4evaaaa/bibliotheca:1.1.0在部署目录下创建docker-compose.yaml文件内容如下所示vimdocker-compose.yamlversion:3services:bibliotheca:image:pickles4evaaaa/bibliotheca:1.1.0container_name:bibliothecarestart:alwaysports:-5054:5054volumes:-/data/bibliotheca/data:/app/dataenvironment:-TIMEZONEAsia/Shanghai-WORKERS65.3 创建Bibliotheca容器执行以下命令创建Bibliotheca容器。dockercompose up-d5.4 查看Bibliotheca容器状态检查Bibliotheca容器运行状态确保Bibliotheca容器正常启动。rootjeven:/data/bibliotheca# docker compose psWARN[0000]/data/bibliotheca/docker-compose.yaml: the attributeversionis obsolete, it will be ignored, please remove it to avoid potential confusion NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS bibliotheca pickles4evaaaa/bibliotheca:1.1.0sh -c gunicorn -w …bibliotheca51seconds ago Up50seconds0.0.0.0:5054-5054/tcp,[::]:5054-5054/tcp5.5 检查Bibliotheca容器日志检查容器运行日志确保Bibliotheca服务正常运行。dockercompose logs六、访问Bibliotheca服务6.1 访问Bibliotheca初始页浏览器地址http://个人的服务器IP:5054访问Bibliotheca初始页。如果无法访问请确保宿主机的防火墙已关闭或已放行相关端口对于云服务器还需配置相应的安全组规则。6.2 在线搜索点击“Search Books”选项填写书籍名称后确认搜索可以成功搜索出相关书籍。6.3 添加书籍在搜索列表中我们选择某本书点击“Add Book ”添加到 Library。6.4 管理书籍阅读状态我们可以为图书设置“当前阅读”“已完成”“想读”或“仅限图书馆”等状态清晰管理阅读进度。同时可记录阅读时间追踪每日阅读习惯让阅读更有规划。七、总结通过本次实践我们成功使用Docker部署了Bibliotheca阅读习惯管理工具实现了对个人阅读进度的高效追踪与管理。整个部署过程简洁流畅得益于Docker容器化技术的便捷性与可移植性。Bibliotheca界面清晰、功能实用能够有效帮助用户记录和规划阅读计划。未来可进一步探索其数据备份与多端同步策略提升使用体验。
Docker实战 | 使用Docker部署Bibliotheca阅读习惯管理工具
【Docker项目实战】使用Docker部署Bibliotheca阅读习惯管理工具一、Bibliotheca介绍1.1 Bibliotheca项目简介1.2 Bibliotheca主要特点二、本次实践规划2.1 本地环境规划2.2 本次实践介绍2.3 注意事项三、本地环境检查3.1 检查Docker服务状态3.2 检查Docker版本3.3 检查docker compose 版本四、拉取Bibliotheca镜像五、部署Bibliotheca服务5.1 创建部署目录5.2 编辑部署文件5.3 创建Bibliotheca容器5.4 查看Bibliotheca容器状态5.5 检查Bibliotheca容器日志六、访问Bibliotheca服务6.1 访问Bibliotheca初始页6.2 在线搜索6.3 添加书籍6.4 管理书籍阅读状态七、总结一、Bibliotheca介绍1.1 Bibliotheca项目简介Bibliotheca是一款基于 Flask 开发的可自托管个人阅读管理工具帮助用户轻松记录书籍、追踪阅读进度并可视化阅读成果。1.2 Bibliotheca主要特点通过输入 ISBN 自动抓取书籍信息与封面简化图书添加流程。支持从 Goodreads 导出的 CSV 文件批量导入阅读数据无缝迁移个人书库。提供四种阅读状态分类灵活管理“想读”、“在读”、“已读”等不同阶段的书籍。记录每日阅读活动帮助用户养成持续阅读的习惯并追踪阅读频率。自动生成每月读书总结的视觉化拼图便于分享阅读成就。集成 Google Books API实现快速搜索和精准导入书籍元数据。采用响应式 Bootstrap 界面设计适配桌面与移动设备提升多端使用体验。二、本次实践规划2.1 本地环境规划本次实践为个人测试环境操作系统版本为 Ubuntu 24.04.2 LTS。hostnameIP地址操作系统版本Docker版本部署项目备注jeven192.168.3.88Ubuntu 24.04.2 LTS28.5.0Bibliotheca——2.2 本次实践介绍1.本次实践部署环境为个人测试环境生产环境请谨慎2.在Docker环境下部署Bibliotheca个人电子图书馆。2.3 注意事项Bibliotheca 项目定位为阅读追踪与管理工具不提供书籍内容或在线阅读功能。请确保在合法合规、能科学上网的网络环境下使用本项目严格遵守国家关于互联网使用的各项法律法规。建议通过正规渠道获取图书资源并配合主流电子书管理软件进行个人阅读管理。使用过程中请注意个人信息保护避免访问存在安全风险的网站或下载不明来源的应用程序。三、本地环境检查3.1 检查Docker服务状态检查Docker服务是否正常运行确保Docker正常运行。rootjeven:~# systemctl status docker● docker.service - Docker Application Container Engine Loaded: loaded(/usr/lib/systemd/system/docker.service;enabled;preset: enabled)Active: active(running)since Sat2025-10-0413:29:05 UTC;2days ago TriggeredBy: ● docker.socket Docs: https://docs.docker.com Main PID:888(dockerd)Tasks:65Memory:1.2G(peak:1.4G)CPU: 3min23.296s CGroup: /system.slice/docker.service3.2 检查Docker版本检查Docker版本rootjeven:~# docker -vDocker version28.5.0, build 887030f3.3 检查docker compose 版本检查Docker compose版本确保2.0以上版本。rootjeven:~# docker compose versionDocker Compose version v2.39.4四、拉取Bibliotheca镜像下载Bibliotheca容器镜像镜像名称为pickles4evaaaa/bibliotheca:1.1.0。dockerpull pickles4evaaaa/bibliotheca:1.1.0五、部署Bibliotheca服务5.1 创建部署目录创建部署目录mkdir-p/data/bibliotheca/datacd/data/bibliotheca5.2 编辑部署文件使用docker-cli方式部署可参考以下命令dockerrun-d\--restartunless-stopped\--namebibliotheca\-p5054:5054\-v$(pwd)/data:/app/data\-eTIMEZONEAsia/Shanghai\-eWORKERS6\pickles4evaaaa/bibliotheca:1.1.0在部署目录下创建docker-compose.yaml文件内容如下所示vimdocker-compose.yamlversion:3services:bibliotheca:image:pickles4evaaaa/bibliotheca:1.1.0container_name:bibliothecarestart:alwaysports:-5054:5054volumes:-/data/bibliotheca/data:/app/dataenvironment:-TIMEZONEAsia/Shanghai-WORKERS65.3 创建Bibliotheca容器执行以下命令创建Bibliotheca容器。dockercompose up-d5.4 查看Bibliotheca容器状态检查Bibliotheca容器运行状态确保Bibliotheca容器正常启动。rootjeven:/data/bibliotheca# docker compose psWARN[0000]/data/bibliotheca/docker-compose.yaml: the attributeversionis obsolete, it will be ignored, please remove it to avoid potential confusion NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS bibliotheca pickles4evaaaa/bibliotheca:1.1.0sh -c gunicorn -w …bibliotheca51seconds ago Up50seconds0.0.0.0:5054-5054/tcp,[::]:5054-5054/tcp5.5 检查Bibliotheca容器日志检查容器运行日志确保Bibliotheca服务正常运行。dockercompose logs六、访问Bibliotheca服务6.1 访问Bibliotheca初始页浏览器地址http://个人的服务器IP:5054访问Bibliotheca初始页。如果无法访问请确保宿主机的防火墙已关闭或已放行相关端口对于云服务器还需配置相应的安全组规则。6.2 在线搜索点击“Search Books”选项填写书籍名称后确认搜索可以成功搜索出相关书籍。6.3 添加书籍在搜索列表中我们选择某本书点击“Add Book ”添加到 Library。6.4 管理书籍阅读状态我们可以为图书设置“当前阅读”“已完成”“想读”或“仅限图书馆”等状态清晰管理阅读进度。同时可记录阅读时间追踪每日阅读习惯让阅读更有规划。七、总结通过本次实践我们成功使用Docker部署了Bibliotheca阅读习惯管理工具实现了对个人阅读进度的高效追踪与管理。整个部署过程简洁流畅得益于Docker容器化技术的便捷性与可移植性。Bibliotheca界面清晰、功能实用能够有效帮助用户记录和规划阅读计划。未来可进一步探索其数据备份与多端同步策略提升使用体验。
