个人电子书库管理器Biblioteca
https://i-blog.csdnimg.cn/direct/79afdcce23ed4fe293557993571cf16b.png简介
什么是 Biblioteca ？
Biblioteca 是一个用于管理大型电子书库的网络应用程序。它旨在提供一个简朴易用的界面，帮助用户有效地管理个人图书馆。是 Calibre 和其他类似软件的替代品。
重要特点：
[*]高效的搜刮功能：可以或许快速找到所需册本。
[*]标签和总结：支持使用 ChatGPT 举行标签和册本摘要。
[*]移动友好：界面设计适合各种装备。
[*]Kobo 装备同步：可与 Kobo 电子书阅读器同步。
[*]OPDS 支持：允许通过 OPDS 协议访问册本。
[*]主题自定义：用户可以轻松定制界面外观。
Biblioteca 是一个开源项目，使用 GPL-3.0 允许证，旨在为用户提供一致和良好分类的图书馆管理体验。
作者之所以创建 Biblioteca，是因为想要一个简朴易用的图书馆管理器，但又对现有的解决方案不满足，所以决定自己做。
安装
在群晖上以 Docker 方式安装。
须要注意的是，群晖内核版本太低会碰到下面的错误，这个 AH00141 已经碰到多次了，老苏除了换机器，也没找到其他的办法；
Function not implemented: AH00141: Could not initialize random number generator
官方镜像发布在 ghcr.io，最新版本是 0.6
https://i-blog.csdnimg.cn/img_convert/fb8883469ce5331e55b221e44c7ee3ee.png
服务涉及到多个容器，采用 docker-compose 方式安装
env.txt
env.txt 是软件的环境变量，直接采用了官方的 prod 版本的 .env 的内容，未做任何修改
源文件地址：https://github.com/biblioverse/biblioteca/blob/main/.env
# In all environments, the following files are loaded if they exist,
# the latter taking precedence over the former:
#
#* .env contains default values for the environment variables needed by the app
#* .env.local uncommitted file with local overrides
#* .env.$APP_ENV committed environment-specific defaults
#* .env.$APP_ENV.local uncommitted environment-specific overrides
#
# Real environment variables win over .env files.
#
# DO NOT DEFINE PRODUCTION SECRETS IN THIS FILE NOR IN ANY OTHER COMMITTED FILES.
# https://symfony.com/doc/current/configuration/secrets.html
#
# Run "composer dump-env prod" to compile .env files for production use (requires symfony/flex >=1.2).
# https://symfony.com/doc/current/best_practices.html#use-environment-variables-for-infrastructure-configuration
###> symfony/framework-bundle ###
APP_ENV=prod
APP_SECRET=9653a6c476d291323d2db7417c13a814
###< symfony/framework-bundle ###
###> doctrine/doctrine-bundle ###
# Format described at https://www.doctrine-project.org/projects/doctrine-dbal/en/latest/reference/configuration.html#connecting-using-a-url
# IMPORTANT: You MUST configure your server version, either here or in config/packages/doctrine.yaml
#
# DATABASE_URL="sqlite:///%kernel.project_dir%/var/data.db"
# DATABASE_URL="mysql://app:!ChangeMe!@127.0.0.1:3306/app?serverVersion=8&charset=utf8mb4"
DATABASE_URL="mysql://db:db@db:3306/db?serverVersion=mariadb-10.3.39&charset=utf8"
###< doctrine/doctrine-bundle ###
###> symfony/messenger ###
# Choose one of the transports below
# MESSENGER_TRANSPORT_DSN=amqp://guest:guest@localhost:5672/%2f/messages
# MESSENGER_TRANSPORT_DSN=redis://localhost:6379/messages
MESSENGER_TRANSPORT_DSN=doctrine://default?auto_setup=0
###< symfony/messenger ###
###> symfony/mailer ###
MAILER_DSN=native://default
###< symfony/mailer ###
# .env
TYPESENSE_URL=http://typesense:8108
TYPESENSE_KEY=xyz
BOOK_FOLDER_NAMING_FORMAT="{authorFirst}/{author}/{serie}/{title}"
BOOK_FILE_NAMING_FORMAT="{serie}-{serieIndex}-{title}"
###< kobo/proxy
KOBO_PROXY_USE_DEV=0
KOBO_PROXY_USE_EVERYWHERE=0
KOBO_PROXY_ENABLED=1
###< kobo/proxy
可变值APP_ENV应用程序运行的环境。可以是 dev 或 prod。除非须要调试应用程序，否则应始终使用 prod。APP_SECRET用于保护应用程序的密钥。请确保它是唯一的！DATABASE_URL数据库的 URL。除非使用差别的数据库，否则您不须要更改此项。MESSENGER_TRANSPORT_DSN不要更改它。MAILER_DSN当前未使用。TYPESENSE_URLTypesense 服务器的 URL。除非使用差别的服务器，否则您不须要更改此项。TYPESENSE_KEY访问 Typesense 服务器的密钥。须要与您在 docker-compose 文件中设置的密钥相对应。BOOK_FOLDER_NAMING_FORMAT用于命名存储册本的文件夹的格式。可以使用以下占位符：{authorFirst}, {author}, {title}, {serie}。BOOK_FILE_NAMING_FORMAT用于命名存储册本的文件的格式。可以使用以下占位符：{serie}, {serieIndex}, {title}。KOBO_PROXY_USE_DEV如果设置为 1，将在开发中使用 Kobo 署理。KOBO_PROXY_USE_EVERYWHERE如果设置为 1，将在任何地方使用 Kobo 署理，并将所有请求转发到原始商店。KOBO_PROXY_ENABLED如果设置为 0，将禁用 Kobo 署理。ALLOW_BOOK_RELOCATION如果设置为 0，添加到库中的册本将不会移动到准确的文件夹。这在您想要自己管理文件夹布局时很有用。 关于环境变量的官方说明：https://biblioverse.github.io/biblioteca-doc/installing/dotenv-config
docker-compose.yml
docker-compose.yml 基于官方的版本举行了微调
services:
biblioteca:
image: ghcr.io/biblioverse/biblioteca:main
container_name: biblioteca-web
command: ["/bin/sh", "-c" , "apache2-foreground" ]
ports:
- 8109:8080
depends_on:
- db
stdin_open: true
tty: true
volumes:
- ./covers:/var/www/html/public/covers
- ./books:/var/www/html/public/books
- ./media:/var/www/html/public/media
- ./env.txt:/var/www/html/.env
db:
image: mariadb:10.10
container_name: biblioteca-mariadb
environment:
- MYSQL_ROOT_PASSWORD=db
- MYSQL_DATABASE=db
- MYSQL_USER=db
- MYSQL_PASSWORD=db
volumes:
- ./db:/var/lib/mysql
typesense:
image: typesense/typesense:27.1
container_name: biblioteca-typesense
restart: on-failure
ports:
- 8983
- 8108
volumes:
- ./data:/data
command: '--data-dir /data --api-key=xyz --enable-cors'
然后实行下面的命令
# 新建文件夹 biblioteca 和 子目录
mkdir -p /volume2/docker/biblioteca/{books,covers,data,db,media}
# 进入 biblioteca 目录
cd /volume2/docker/biblioteca
# 修改目录权限
chmod a+rw {books,covers,media}
# 将 docker-compose.yml 放入当前目录
# 一键启动
docker-compose up -d
https://i-blog.csdnimg.cn/img_convert/1f12989b1bc8789edc68aeb3446fa360.png
如果不出意外的话，会有 3 个容器启动
https://i-blog.csdnimg.cn/img_convert/659bc609a9e0b95496fe7f4784bde699.png
运行
在浏览器中输入 http://群晖IP:8109 就能看到登录界面
https://i-blog.csdnimg.cn/img_convert/79cca65c82d2f75440f3dc5ce1e16a5f.png
如果任意输入，会表现错误，因为现在还没有 db.user 表
500 Internal Server Error
An exception occurred while executing a query: SQLSTATE: Base table or view not found: 1146 Table 'db.user' doesn't exist
https://i-blog.csdnimg.cn/img_convert/5d3910b89fc331814cf604d42cd38a00.png
导入数据
依次实行下面的命令创建数据库并新建管理员账号
# 创建数据库
docker-compose exec biblioteca bin/console doctrine:migration:migrate --no-interaction
# 创建管理员用户
docker-compose exec biblioteca bin/console app:create-admin-user
# 示例
docker-compose exec biblioteca bin/console app:create-admin-user admin 123456
# 创建 Typesense 索引
docker-compose exec biblioteca bin/console typesense:create
https://i-blog.csdnimg.cn/img_convert/77d7552e726f10e3f5e36bcb03f0f412.png
登录成功后的主界面
https://i-blog.csdnimg.cn/img_convert/236473be8b13c72bd32c1df69da38292.png
汉化
老苏基于官方的 translations 做了汉化文件，可以在这里下载：https://github.com/wbsu2003/synology/raw/refs/heads/main/Biblioteca/translations.zip
将其放入 biblioteca 根目次
https://i-blog.csdnimg.cn/img_convert/b00028ffc547b21762e75dc590f08e2d.png
解压到当前目次
https://i-blog.csdnimg.cn/img_convert/580ad1da8e75d434c1e126ed69f9d274.png
现在的 translations 目次
https://i-blog.csdnimg.cn/img_convert/2eb937154490629f56d6d1e1850abc5b.png
现在实行下面的命令，先将文件复制到容器内
# 讲中文复制到容器中
docker cp ./translations/. biblioteca-web:/var/www/html/translations
# 清除应用的缓存
docker-compose exec biblioteca bin/console cache:clear
然后清除缓存，否则有可能界面不会有变化
https://i-blog.csdnimg.cn/img_convert/7882c8573a58ce0b1e342ff0775c1080.png
进入 My Profile --> Langue，选择法文
https://i-blog.csdnimg.cn/img_convert/3f53fff73e35c4ad083f44e29c7a06db.png
生存之后，刷新页面，虽然并不全部是中文，但是根本上已经可以看懂了
https://i-blog.csdnimg.cn/img_convert/0c48899d421b915d041f8b3a06a081f0.png
册本
左侧的 上传，先选择文件，再点 Upload 上传
https://i-blog.csdnimg.cn/img_convert/636e40bfb90e2ed34fc1f9c3e8a25aa1.png
须要点 Consume
https://i-blog.csdnimg.cn/img_convert/9cc9b098c003afb3fcda9f277d9d5b70.png
才能在 所有册本 中找到
https://i-blog.csdnimg.cn/img_convert/39c18e45ed00cb69cb98502da41df83c.png
可以上传封面，也可以从文件中提取封面
https://i-blog.csdnimg.cn/img_convert/7420a4f135766419e465a679637b0c6d.png
可以下载，也可以在网页中阅读
https://i-blog.csdnimg.cn/img_convert/15fce869b5172565b14d90e59caee903.png
书架
左侧的 编辑书架 --> 新书架
https://i-blog.csdnimg.cn/img_convert/dd934cc33b98162ab919ba2713ee5e53.png
创建完成后
https://i-blog.csdnimg.cn/img_convert/16bac54fbf38dbeb2fc37ec81ed2bceb.png
可以将册本放入书架
https://i-blog.csdnimg.cn/img_convert/e64fe5e3fc6b1c12ffba30786d99b205.png
现在你的书架上就有书了
https://i-blog.csdnimg.cn/img_convert/cc1128d8ec9150ea2ea35601c88d5a59.png
Biblioteca 现在还在比力早期，Bug 还有点多，像有些电子书，在从文件中提取封面时，比力轻易碰到 500 Internal Server Error
https://i-blog.csdnimg.cn/img_convert/48d7ff5a5c2dc7d699bfd9db26714efc.png
参考文档
biblioverse/biblioteca: Biblioteca is a web application made to manage large ebook libraries and is developed aiming to help you to have consistent and well classified libraries.
地址：https://github.com/biblioverse/biblioteca
Biblioteca Book Management | Biblioteca Docs
地址：https://biblioverse.github.io/biblioteca-doc/
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。
页:
[1]