开源电子书库管理系统Biblioteca完整部署指南-NAS一键安装Docker Compose配置
作者
小编
发布时间

Biblioteca是开源电子书库管理系统,支持大规模书籍收藏、分类组织和搜索。本文详细介绍Docker快速部署方法,包括配置文件、端口映射、环境变量设置等步骤,帮助用户在NAS或服务器上轻松搭建属于自己的电子书管理平台。
项目介绍
Biblioteca 是一款功能强大的电子书库管理系统,专为处理大规模电子书收藏而设计。这是一个开源的网页应用,致力于帮助用户建立结构清晰、分类规范的电子书库。无论你是个人收藏爱好者还是图书馆管理者,Biblioteca 都能为你提供一套完整的解决方案,让你轻松管理和组织数千本电子书。
项目地址:点我跳转
部署安装
如果你想在外网也能访问项目,建议配置内网穿透服务。可以考虑使用 帕斯内网穿透,先注册账号备用。具体操作步骤可以 参考这里 了解内网穿透的全平台快速上手方法。
使用 Docker Compose 快速部署
Biblioteca 采用现代化的技术栈,包含 PHP 后端、MariaDB 数据库和 Typesense 搜索引擎。推荐使用 Docker Compose 一键部署,最为便捷。
第一步:复制配置文件
将下列 Docker Compose 配置文件保存到你的服务器或 NAS 设备:
1services:2 biblioteca:3 image: ghcr.io/biblioverse/biblioteca:latest4 ports:5 - "8080:8080"6 depends_on:7 db:8 condition: service_started9 typesense:10 condition: service_started11 environment:12 - DATABASE_URL=mysql://biblioteca:biblioteca@db:3306/biblioteca13 - TYPESENSE_API_KEY=xyz14 - TYPESENSE_HOST=typesense15 networks:16 - biblioteca1718 db:19 image: mariadb:12.020 environment:21 - MYSQL_ROOT_PASSWORD=biblioteca22 - MYSQL_DATABASE=biblioteca23 - MYSQL_USER=biblioteca24 - MYSQL_PASSWORD=biblioteca25 ports:26 - "3306:3306"27 volumes:28 - mariadb_data:/var/lib/mysql29 networks:30 - biblioteca3132 typesense:33 image: typesense/typesense:29.034 restart: on-failure35 ports:36 - "8108:8108"37 volumes:38 - typesense_data:/data39 command: '--data-dir /data --api-key=xyz --enable-cors'40 networks:41 - biblioteca4243volumes:44 mariadb_data:45 typesense_data:4647networks:48 biblioteca:49 driver: bridge
第二步:启动服务
打开你的飞牛 NAS 或其他 NAS 设备,进入 Docker 管理界面。
点击 本地镜像 → 添加镜像 → 从 URL 添加。
在镜像地址栏填入:ghcr.io/biblioverse/biblioteca:latest
等待镜像下载完成后,点击 启动按钮 启动容器。
第三步:配置端口映射
勾选 开机自动启动 后进入下一步。
在端口设置页面,你需要配置以下端口映射: 8080 → 容器内的 8080 端口(Biblioteca 主应用) 3306 → 容器内的 3306 端口(MariaDB 数据库) 8108 → 容器内的 8108 端口(Typesense 搜索引擎)
如果你的服务器上这些端口已被占用,可以修改左侧的外部端口号,但请确保格式正确。例如,如果 8080 被占用,可以改为 8888,访问时使用 ip:8888 即可。
第四步:存储配置
在存储位置设置中,建议创建以下目录用于数据持久化:
/biblioteca_data/mariadb - 用于存储数据库文件 /biblioteca_data/typesense - 用于存储搜索索引
这样即使容器重启,你的数据也不会丢失。
第五步:环境变量设置
必须设置的环境变量:
DATABASE_URL - 数据库连接字符串,默认值:mysql://biblioteca:biblioteca@db:3306/biblioteca TYPESENSE_API_KEY - Typesense 搜索引擎的 API 密钥,默认值:xyz
可选设置的环境变量:
TYPESENSE_HOST - Typesense 服务器地址,默认值:typesense
其他配置项保持默认即可,无需特殊修改。
第六步:启动应用
完成上述配置后,点击 启动 按钮。
等待容器启动完成(通常需要 1-2 分钟),然后在浏览器中访问 http://你的服务器IP:8080,就能看到 Biblioteca 的管理界面了。
总结
至此,Biblioteca 电子书库管理系统已成功部署到你的服务器或 NAS 设备上。你现在可以开始上传和管理你的电子书收藏,享受高效便捷的图书管理体验。如有任何问题,可以参考项目的 官方文档。
本篇教程结束。
相关教程

Piwigo是功能强大的开源照片库管理系统,支持批量上传、相册组织、标签管理、用户权限控制等丰富功能。完全开源免费,可自行部署在服务器上,享受完全的数据控制权。适合摄影爱好者、组织和个人使用。

DouyinLiveRecorder是功能强大的多平台直播录制工具,支持抖音、TikTok、快手、B站、虎牙等50+平台自动录制。独有循环值守功能,主播上线即自动录制,让你轻松备份喜爱主播精彩内容。支持Docker一键部署到NAS,配置简单,永久自动化运行。

在飞牛 NAS 上用 Docker 自建照片库 Immich:人脸识别、地图、以图搜图,照片全部落在自己的硬盘上;再用帕斯内网穿透把它开放到公网,人在外面也能翻家里的相册。含拿绝对路径、编排要改的三处、建隧道每一栏怎么填的完整步骤。

自己的音乐文件集中放在 NAS 上,在外面用手机也能听自己的歌单。包含单容器编排、公网首启建管理员及飞牛 PassNAT 插件隧道步骤。