yanded/book

读万卷 Docker 镜像

镜像概述

读万卷 Docker 镜像旨在提供一个轻量级的电子书管理与阅读解决方案，帮助用户快速搭建个人或小型团队的私有阅读平台。该镜像集成了电子书格式解析、文件管理、在线阅读等核心功能，支持多种常见电子书格式，无需复杂配置即可快速部署使用。

核心功能和特性

• 多格式支持：兼容 EPUB、PDF、MOBI 等主流电子书格式
• 文件管理：支持电子书上传、分类、标签管理及搜索功能
• 在线阅读：内置网页版阅读器，支持目录导航、字体调整、阅读进度记忆
• 个人书架：用户可创建自定义书架，整理阅读内容
• 轻量级部署：基于 Alpine 系统构建，镜像体积小，资源占用低
• 数据持久化：支持通过挂载卷保存电子书数据，确保数据不丢失

使用场景和适用范围

• 个人用户搭建私有电子书库
• 小型团队共享阅读资源
• 家庭内部阅读平台建设
• 教育机构提供电子教材阅读服务

使用方法和配置说明

基本部署（docker run）

bash
docker run -d \
  --name duwanjuan \
  -p 8080:8080 \
  -v /path/to/ebooks:/app/ebooks \
  -v /path/to/config:/app/config \
  duwanjuan:latest

• -p 8080:8080：映射容器端口到主机，通过 http://localhost:8080 访问
• -v /path/to/ebooks:/app/ebooks：挂载电子书存储目录，持久化电子书数据
• -v /path/to/config:/app/config：挂载配置文件目录，保存用户设置

Docker Compose 配置

yaml
version: '3'
services:
  duwanjuan:
    image: duwanjuan:latest
    container_name: duwanjuan
    ports:
      - "8080:8080"
    volumes:
      - ./ebooks:/app/ebooks
      - ./config:/app/config
    restart: unless-stopped

环境变量配置

可通过环境变量自定义应用配置：

• USERNAME：默认管理员用户名，默认为 admin
• PASSWORD：默认管理员密码，默认为 password
• PORT：应用运行端口，默认为 8080
• LANGUAGE：界面语言，支持 zh-CN、en-US，默认为 zh-CN

示例（带环境变量的启动命令）：

bash
docker run -d \
  --name duwanjuan \
  -p 8081:8081 \
  -e USERNAME=myuser \
  -e PASSWORD=mypassword \
  -e PORT=8081 \
  -v /path/to/ebooks:/app/ebooks \
  duwanjuan:latest

访问与使用

1. 部署完成后，通过浏览器访问 http://[主机IP]:8080
2. 使用默认或自定义的用户名密码登录
3. 上传电子书：点击"上传"按钮选择本地电子书文件
4. 管理书架：创建分类书架，将电子书添加到对应书架
5. 在线阅读：点击电子书封面即可打开内置阅读器开始阅读

数据备份

定期备份挂载的 ebooks 和 config 目录，确保电子书数据和配置信息安全。