现代电子书图书馆管理和阅读器Librum

Librum239 月刚出来的时候老苏就关注了,那个时候还没有 docker 版本。后来是在大家的要求下官方才开始支持的 ,但是可能因为作者不熟悉 docker,因此大家在采用 docker 自托管安装时,一直磕磕绊绊的。

老苏遇到的是数据库问题,开始连不上,后来连上了又缺表,再后来是注册失败,反正是一大堆的问题。

偶然逛官方的 Issues,发现有人写了个 MariaDBSQL 脚本,老苏测试一下,发现之前的问题都解决了。

上网查了一下,尚未有 Librum 自托管的文章,估计大家和老苏一样,所以便有了下文


简介

什么是 Librum ?

Librum 是一款旨在简化阅读体验的电子书管理应用程序。它允许用户创建和管理个人在线图书馆,支持多种设备访问。Librum 支持自托管,主要目的是确保用户数据和书籍不与官方云同步,从而增强数据主权和隐私保护。这种自托管方式为用户提供了一种灵活且安全的方式来管理他们的电子书库和阅读体验。Librum  不仅仅是一个电子书阅读器,还具有笔记记录、AI 工具和突出显示等功能,同时提供自定义功能,使其尽可能个性化!

主要特点:

  • 个性化在线图书馆:用户可以随时随地访问自己的图书馆,轻松管理书籍。
  • 超过 70,000 本书籍Librum 提供免费访问大量书籍,丰富用户的阅读选择。
  • 简洁界面:提供简单直观的用户界面,专注于阅读。
  • 精细组织:支持标签、分类和书籍排序,用户可以根据自己的喜好组织库藏。
  • 人工智能集成:通过 AI 功能,用户可以快速获取书籍内容的解释和摘要。
  • 完全可定制:允许用户根据自己的需求定制应用外观和功能。
  • 开源与免费Librum 是一个开源项目,用户可以自由访问源代码,并参与开发。
现代电子书图书馆管理和阅读器Librum

总的来说,Librum 不仅是一个电子书阅读器,更是一个全面的图书管理工具,旨在提高用户的阅读效率和体验。

安装

在群晖上以 Docker 方式安装。

涉及两个容器,采用 docker-compose 安装会比较简便

librum_mariadb.sql

这个文件来自官方的 Issues 39:https://github.com/Librum-Reader/Librum-Server/issues/39

源文件下载地址:https://github.com/user-attachments/files/17483269/librum_mariadb.txt

下载后,需要将扩展名从 txt 改为 sql,并将其放入 initdb 目录中

现代电子书图书馆管理和阅读器Librum

docker-compose.yml

将下面的内容保存为 docker-compose.yml 文件,本文件在官方的基础上做了必要的调整

例如:

  • 增加了卷映射  - ./initdb:/docker-entrypoint-initdb.d,用于初始化数据库;
  • 删除了 SMTP 开始的几个用不上的环境变量;
  • AdminEmailAdminPassword 是无用的,但是如果不设置会报错;
version: "3.8"

services:
  librum:
    image: ghcr.io/librum-reader/librum-server:latest
    # hostname: librum
    container_name: librum
    ports:
      - 5314:5000
    volumes:
      - ./book:/var/lib/librum-server/librum_storage
    #  - ./librum:/var/lib/librum
    environment:
      - JWTValidIssuer=exampleIssuer          # Optional. You can leave it as-is
      - JWTKey=exampleOfALongSecretToken      # Optional. You can leave it as-is
    #  - SMTPEndpoint=smtp.88.com:465          # Example for Gmail: smtp.gmail.com:587
    #  - SMTPUsername=wbsu2003@88.com              
    #  - SMTPPassword=<第三方邮件客户端密码>
    #  - SMTPMailFrom=wbsu2003@88.com
      - DBConnectionString=Server=librum_db;port=3306;Database=librum;Uid=librum;Pwd=mariadb;
      - AdminEmail=wbsu2003@gmail.com         # Admin login username
      - AdminPassword=123456                  # Admin login password
      #- OpenAIToken=                         # Optional. Generate here: https://platform.openai.com/api-keys
    restart: unless-stopped
    depends_on:
      librum_db:
        condition: service_healthy            # Ensures the DB is up before the server.

  librum_db:
    image: mariadb:latest
    # hostname: mariadb
    container_name: librum_db
    ports:
      - 3316:3306
    volumes:
      - ./data:/var/lib/mysql
      - ./initdb:/docker-entrypoint-initdb.d
    environment:
      - MARIADB_USER=librum
      - MARIADB_PASSWORD=mariadb
      - MARIADB_DATABASE=librum
      - MARIADB_ROOT_PASSWORD=mariadb
    restart: unless-stopped
    healthcheck:                              # Ensures the DB is up before the server.
      test: ["CMD", "mariadb-admin", "ping", "-u", "librum", "-p'mariadb'", "-h", "localhost"]
      interval: 20s
      timeout: 40s
      retries: 3
      start_period: 30s
  • librum 的环境变量说明

这些环境变量用于配置 Librum 服务器的运行环境,确保服务器能够正确连接到数据库、处理身份验证和发送邮件等功能。

环境变量 说明
JWTValidIssuer 用于设置 JWTJSON Web Token)的有效发行者。可以根据需要自定义,默认值为 exampleIssuer
JWTKey 用于设置 JWT 的密钥,确保安全性。可根据需要自定义,默认值为 exampleOfALongSecretToken
SMTPEndpoint SMTP 服务器的地址,例如 GmailSMTP 服务器为 smtp.gmail.com:587
SMTPUsername 用于 SMTP 认证的用户名。
SMTPPassword 用于 SMTP 认证的密码。
SMTPMailFrom 发送邮件时使用的发件人邮箱地址。
DBConnectionString 数据库连接字符串,用于连接 MariaDB 数据库。包含数据库服务器地址、端口、数据库名称、用户名和密码。
AdminEmail 管理员的登录邮箱地址,用于管理和通知。
AdminPassword 管理员的登录密码。
OpenAIToken 可选的 OpenAI API 密钥,用于集成 OpenAI 功能。
  • librum_db 的环境变量说明

这些环境变量用于配置 MariaDB 数据库的访问和安全性,确保 Librum 服务器能够成功连接和操作数据库。

环境变量 说明
MARIADB_USER 用于 MariaDB 数据库的用户名,默认值为 librum
MARIADB_PASSWORD 用于 MariaDB 数据库的密码,默认值为 mariadb
MARIADB_DATABASE 初始化时创建的数据库名称,默认值为 librum
MARIADB_ROOT_PASSWORD MariaDB 根用户的密码,默认值为 mariadb

然后执行下面的命令

# 新建文件夹 librum 和 子目录
mkdir -p /volume1/docker/librum/{book,data,initdb}

# 进入 librum 目录
cd /volume1/docker/librum

# 修改目录权限
chmod a+rw book

# 将 docker-compose.yml 放入当前目录

# 一键启动数据库
docker-compose up -d librum_db

# 稍等一会儿再执行一键启动
docker-compose up -d
现代电子书图书馆管理和阅读器Librum

运行

在浏览器中输入 http://群晖IP:5314 会看到下面的提示

Librum-Server is not a web application, so it's not supposed to have a main page. <br>This page is just for health-status checking.
现代电子书图书馆管理和阅读器Librum

因为 Librum-Server 只包含 Librum 客户端应用程序所需的 API、数据库和其他核心基础设施项目,而不是 Web 应用

客户端

在官方主页,可以下载到对应平台的客户端

现代电子书图书馆管理和阅读器Librum

支持 WindowsMacOSLinux,移动端应该也会有

现代电子书图书馆管理和阅读器Librum

下面以 Windows 为例,介绍如何让客户端连接到自托管服务器

  • 打开注册表编辑器(按下Win + R并搜索regedit
  • 导航到HKEY_CURRENT_USERSoftwareLibrum-ReaderLibrum
现代电子书图书馆管理和阅读器Librum
  • 设置 selfHosted=true
  • 设置 serverHost 为前面安装的服务端地址
现代电子书图书馆管理和阅读器Librum

启动客户端,首先需要注册账号

现代电子书图书馆管理和阅读器Librum

注册界面时,密码不能使用太简单的,否则会显示 The provided data is invalid

现代电子书图书馆管理和阅读器Librum

自托管不需要激活,所以老苏环境变量没有设置 SMTP 相关的参数

现代电子书图书馆管理和阅读器Librum

直接用注册的账号密码登录客户端

现代电子书图书馆管理和阅读器Librum

登录成功后的主界面

现代电子书图书馆管理和阅读器Librum

免费图书

现代电子书图书馆管理和阅读器Librum

PDF 工具

现代电子书图书馆管理和阅读器Librum

设置界面

现代电子书图书馆管理和阅读器Librum

添加图书

Librum 支持所有主要的书籍格式:

  • PDF
  • EPUB
  • CBZ (Comic books)
  • FB2
  • TIFF
  • Mobi
  • XPS
  • Images

开始添加图书

现代电子书图书馆管理和阅读器Librum

随便加了几本

现代电子书图书馆管理和阅读器Librum

书籍管理

现代电子书图书馆管理和阅读器Librum

看书

现代电子书图书馆管理和阅读器Librum

多端阅读,理论上是可以同步的,但没有条件测试

现代电子书图书馆管理和阅读器Librum

参考文档

Librum-Reader/Librum-Server: The Librum server
地址:https://github.com/Librum-Reader/Librum-Server

Librum-Reader/Librum: The Librum client application
地址:https://github.com/Librum-Reader/Librum

librumreader.com
地址:https://librumreader.com/

Home · Librum-Reader/Librum Wiki 地址:https://github.com/Librum-Reader/Librum/wiki

Librum – Finally a modern E-Book reader : selfhosted
地址:https://www.reddit.com/r/selfhosted/comments/16a0eg4/librum_finally_a_modern_ebook_reader/

I created the mariadb version of the database. If anyone want to test it. · Issue #39 · Librum-Reader/Librum-Server
地址:https://github.com/Librum-Reader/Librum-Server/issues/39

@所有人:写文不易,如果你都看到了这里,请点个在看,分享给更多的朋友;为确保你能收到每一篇文章,请主页右上角设置星标。点点广告就是对老苏最大的支持。

原文始发于微信公众号(各种折腾):现代电子书图书馆管理和阅读器Librum

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。

文章由极客之音整理,本文链接:https://www.bmabk.com/index.php/post/308394.html

(0)
小半的头像小半

相关推荐

发表回复

登录后才能评论
极客之音——专业性很强的中文编程技术网站,欢迎收藏到浏览器,订阅我们!