Koodo Reader Logo

部署 Docker

 
Docker 版默认将数据保存在浏览器缓存中。为了您的数据安全，请通过 HTTPS 部署和访问，然后将数据保存到您的本地文件夹。或者您也可以启用数据源功能，将数据同步到指定的服务器路径

只部署网页版

如果您只需要部署网页版，直接使用下面的命令即可
docker run -d \
  --name koodo-reader \
  -p 80:80 \
  -p 8080:8080 \
  -p 7200:7200 \
  -e ENABLE_HTTP_SERVER=false \
  -e SERVER_USERNAME=admin \
  -e SERVER_PASSWORD=securePass123 \
  -e ENABLE_OPDS=false \
  -e ENABLE_KOREADER_SERVER=false \
  -v /path/to/host/uploads:/app/uploads \
  ghcr.io/koodo-reader/koodo-reader:master

启用数据源功能和 OPDS 功能

如果您还需要启用数据源功能，实现借助 Docker 实现跨平台的数据同步，请对上方的部署命令作如下修改
  1. 将 ENABLE_HTTP_SERVER 设为 true
  1. 将 SERVER_USERNAME 和 SERVER_PASSWORD 改为您认为安全的用户名和密码
  1. 将 /path/to/host/uploads 改为您希望用来保存阅读数据的文件夹
如果您还需要启用OPDS 功能，让您的图书可以在其他电子书阅读器中访问，除了以上三处修改，还需要做如下修改
  1. 将 ENABLE_OPDS 设为 true
您的 OPDS 用户名和密码就是您设置的SERVER_USERNAME 和 SERVER_PASSWORD，地址就是数据源的地址后面上/opds，示例如下：http://192.168.28.1:8080/opds
部署完成后，在 Koodo Reader 中选择 Docker 作为数据源。
数据源功能默认使用 8080 端口，网页版默认使用 80 端口，您也可以使用其他端口。如果您需要使用 8090 端口，则将 -p 8080:8080 改为 -p 8090:8080
备注：
如果您希望使用 Docker Secrets 来配置服务器密码，请参考docker-compose-secret.yml
如果您希望提高安全性，限制未知来源的请求，可以在部署命令中增加环境变量 ALLOWED_ORIGINS，将请求来源限制为您指定的网址，例如：
ALLOWED_ORIGINS="https://reader.example.com,http://192.168.182.1:3000"

启用 KOReader 同步服务器

Koodo Reader Docker 版本还支持 KOReader 同步服务器的功能，您可以借助此功能在 Koodo Reader 和 KOReader 之间同步图书阅读进度。该功能使用的接口和协议与 KOReader 官方同步服务器完全一致。如需启用此功能，请对上方部署命令进行如下修改：
  1. 将 ENABLE_KOREADER_SERVER 设为 true
  1. 将 /path/to/host/uploads 改为您希望保存同步数据的文件夹
如果您在注册完自己的账号后希望禁止未知用户继续注册，请在上方的部署命令中增加环境变量 ENABLE_KOREADER_REGISTRATION，将其设置为false，例如：
ENABLE_KOREADER_REGISTRATION=false
部署完成后，您即可在 Koodo Reader 中启用将阅读进度同步到 KOReader 的功能。同步服务器地址请填写您的服务器地址，端口号默认为 7200，示例如下：http://192.168.28.1:7200