KOReader with noVNC Docker镜像

镜像概述

本镜像提供KOReader电子书阅读器的浏览器访问方式，通过noVNC技术实现在浏览器中运行KOReader，无需安装客户端即可阅读电子书。支持自定义密码、持久化配置及电子书库挂载，适用于移动设备和桌面浏览器场景。

核心功能

• 浏览器访问：通过noVNC在浏览器中直接使用KOReader，访问地址为http://localhost:8080
• 安全访问：支持自定义VNC密码，默认密码为koreader（建议修改）
• 数据持久化：配置文件存储在持久化卷中，确保设置不丢失
• 灵活挂载：支持挂载电子书目录（可只读）、密码文件（可只读）和配置目录（需可写）
• 场景适配：默认隐藏光标适合移动设备阅读，可通过环境变量显示光标适配桌面浏览器

使用场景

• 移动设备通过浏览器阅读电子书（默认无光标，优化触屏体验）
• 桌面浏览器阅读（可显示光标，支持键盘导航）
• 共享电子书库，多设备通过浏览器访问同一书库
• 无需本地安装KOReader，快速在任意设备上临时使用

使用方法

基本运行命令

docker run -p 8080:8080 -v mybooks:/books:ro -v koreader_config:/config -v passwd:/passwd:ro --name koreader wardwouts/koreader-novnc

运行后通过http://localhost:8080在浏览器中访问KOReader。

更改VNC密码

默认密码为koreader，建议修改为自定义密码，两种方式可选：

方法一：本地创建密码文件并挂载

1. 在本地使用vncpasswd命令创建密码文件：

   vncpasswd  # 按提示输入密码，生成密码文件（默认路径~/.vnc/passwd）
   

2. 运行容器时挂载该文件到/passwd：

   docker run -p 8080:8080 -v /本地密码文件路径:/passwd:ro ... wardwouts/koreader-novnc
   

方法二：在运行中的容器内修改

1. 进入容器终端：

   docker exec -it 容器名称 /bin/bash
   

2. 执行密码修改命令（替换PASSWORD为自定义密码）：

   x11vnc -storepasswd PASSWORD /passwd
   

路径说明

环境变量配置

光标显示控制

默认不显示鼠标光标（优化移动设备阅读体验），如需在桌面浏览器中显示光标，可设置环境变量CURSOR为空值：

docker run -p 8080:8080 --env CURSOR="" -v mybooks:/books -v koreader_config:/config -v passwd:/passwd --name koreader wardwouts/koreader-novnc

设置后，桌面浏览器中使用时将显示鼠标光标，支持鼠标导航。