开源电子书库管理系统Biblioteca完整部署指南-NAS一键安装Docker Compose配置

项目介绍

Biblioteca 是一款功能强大的电子书库管理系统，专为处理大规模电子书收藏而设计。这是一个开源的网页应用，致力于帮助用户建立结构清晰、分类规范的电子书库。无论你是个人收藏爱好者还是图书馆管理者，Biblioteca 都能为你提供一套完整的解决方案，让你轻松管理和组织数千本电子书。

项目地址：点我跳转

部署安装

如果你想在外网也能访问项目，建议配置内网穿透服务。可以考虑使用帕斯内网穿透，先注册账号备用。具体操作步骤可以参考这里了解内网穿透的全平台快速上手方法。

使用 Docker Compose 快速部署

Biblioteca 采用现代化的技术栈，包含 PHP 后端、MariaDB 数据库和 Typesense 搜索引擎。推荐使用 Docker Compose 一键部署，最为便捷。

第一步：复制配置文件

将下列 Docker Compose 配置文件保存到你的服务器或 NAS 设备：

1services:
2  biblioteca:
3    image: ghcr.io/biblioverse/biblioteca:latest
4    ports:
5      - "8080:8080"
6    depends_on:
7      db:  
8        condition: service_started  
9      typesense:
10        condition: service_started
11    environment:
12      - DATABASE_URL=mysql://biblioteca:biblioteca@db:3306/biblioteca
13      - TYPESENSE_API_KEY=xyz
14      - TYPESENSE_HOST=typesense
15    networks:
16      - biblioteca
17
18  db:
19    image: mariadb:12.0
20    environment:
21      - MYSQL_ROOT_PASSWORD=biblioteca
22      - MYSQL_DATABASE=biblioteca
23      - MYSQL_USER=biblioteca
24      - MYSQL_PASSWORD=biblioteca
25    ports:
26      - "3306:3306"
27    volumes:
28      - mariadb_data:/var/lib/mysql
29    networks:
30      - biblioteca
31
32  typesense:
33    image: typesense/typesense:29.0
34    restart: on-failure
35    ports:
36      - "8108:8108"
37    volumes:
38      - typesense_data:/data
39    command: '--data-dir /data --api-key=xyz --enable-cors'
40    networks:
41      - biblioteca
42
43volumes:
44  mariadb_data:
45  typesense_data:
46
47networks:
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 设备上。你现在可以开始上传和管理你的电子书收藏，享受高效便捷的图书管理体验。如有任何问题，可以参考项目的官方文档。

本篇教程结束。