一、服务器环境配置
- 实例与系统选择
- 推荐配置：莱卡云 L2型实例（2核4GB内存），系统选择 Ubuntu 22.04 LTS，满足文档处理及多用户访问需求16。
- 端口开放：在莱卡云控制台开放 HTTP（80）、HTTPS（443） 及 Calibre-Web服务端口（如8083）34。
- 安装Docker与依赖
- bashCopy Code
- sudo apt update && sudo apt install -y docker.io docker-compose sudo systemctl enable docker && sudo systemctl start docker
- 验证安装：docker --version 和 docker-compose --version13。
二、Calibre-Web容器化部署
- 创建部署目录与配置文件
- bashCopy Code
- mkdir -p /opt/calibre-web && cd /opt/calibre-web cat > docker-compose.yml <<EOF version: '3.8' services: calibre-web: image: linuxserver/calibre-web:latest # 官方稳定镜像:ml-citation{ref="3,4" data="citationList"} container_name: calibre-web ports: - "8083:8083" # 默认服务端口 volumes: - ./config:/config # 配置文件持久化 - ./books:/books # 电子书存储目录 - /usr/share/fonts:/usr/share/fonts # 挂载字体目录避免中文乱码:ml-citation{ref="3,5" data="citationList"} environment: - PUID=1000 - PGID=1000 - DOCKER_MODS=linuxserver/calibre-web:calibre # 启用Calibre转换功能:ml-citation{ref="3,4" data="citationList"} - OAUTH_ENABLED=false # 禁用外部认证（可选） restart: unless-stopped EOF
- 启动服务与初始化
- bashCopy Code
- docker-compose up -d docker logs -f calibre-web # 查看启动日志
- 访问 http://<服务器ip>:8083，首次登录需设置管理员账号并指定书库路径（如/books）34。
- 支持直接上传 EPUB、PDF、CBZ/CBR 等格式文件，并在线阅读12。
三、域名绑定与HTTPS加密
- Nginx反向代理配置
- nginxCopy Code
- server { listen 80; server_name books.yourdomain.com; return 301 https://$host$request_uri; } server { listen 443 ssl; server_name books.yourdomain.com; ssl_certificate /etc/letsencrypt/live/books.yourdomain.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/books.yourdomain.com/privkey.pem; location / { proxy_pass http://localhost:8083; proxy_set_header Host $host; } }
- 操作步骤：
- 申请SSL证书：sudo certbot certonly --nginx -d books.yourdomain.com13。
- 重启Nginx：sudo systemctl restart nginx36。
四、功能扩展与安全优化
- 核心功能配置
- 元数据抓取：在Calibre-Web后台启用 Google Books/Amazon/豆瓣（需插件） 元数据自动填充15。
- 格式转换：通过环境变量启用Calibre二进制工具，支持 EPUB→MOBI/AZW3 等格式转换34。
- OPDS订阅：通过 http://books.yourdomain.com/opds 提供电子书阅读器订阅服务27。
- 安全加固
- 后台访问限制：通过Nginx配置仅允许内网IP访问 /admin 路径34。
- 定期更新镜像：
- bashCopy Code
- docker-compose pull && docker-compose up -d # 更新至最新版本:ml-citation{ref="3,4" data="citationList"}
五、数据备份与维护
- 定时备份策略
- bashCopy Code
- crontab -e 0 3 * * * tar -czvf /opt/calibre-web-backup.tar.gz /opt/calibre-web/books # 每日备份书库
- 建议将备份文件上传至莱卡云对象存储36。
六、常见问题处理
- 中文乱码：在宿主机安装中文字体并挂载至容器（如 apt install fonts-wqy-microhei）35。
- 格式转换失败：检查宿主机是否安装 calibre 并更新版本：
- bashCopy Code
- sudo apt install calibre # 安装Calibre工具链:ml-citation{ref="3,4" data="citationList"}
- 服务端口冲突：调整 docker-compose.yml 中的端口映射（如 8090:8083）34。
通过以上步骤，可在莱卡云服务器搭建支持多格式在线阅读、元数据管理及跨设备同步的Calibre-Web电子书库，适用于个人或团队的知识管理场景
