chu1shen/bangumikomga

BangumiKomga Docker镜像

概述

BangumiKomga是一个专为漫画爱好者设计的工具，它能够将Bangumi(番组计划)的元数据与Komga漫画服务器无缝集成，实现漫画元数据的自动匹配和收藏状态的同步，从而提升漫画库的管理效率和用户体验。

核心功能和特性

• 元数据自动匹配：通过Bangumi数据库自动为Komga中的漫画匹配详细元数据
• 收藏状态同步：在Bangumi和Komga之间同步漫画收藏状态
• 批量处理能力：支持大批量漫画的元数据更新和状态同步
• 自定义规则：可根据用户需求配置匹配规则和同步选项
• 日志记录：详细记录所有操作，便于问题排查和跟踪

使用场景和适用范围

• 个人漫画服务器管理员
• Komga用户希望提升元数据质量
• Bangumi用户希望同步漫画收藏状态
• 漫画收藏者需要高效管理大量漫画资源

使用方法和配置说明

基本使用（Docker Run）

bash
docker run -d \
  --name bangumikomga \
  -v /path/to/your/config:/app/config \
  -e BANGUMI_USERNAME=your_bangumi_username \
  -e BANGUMI_PASSWORD=your_bangumi_password \
  -e KOMGA_URL=http://your_komga_url \
  -e KOMGA_USERNAME=your_komga_username \
  -e KOMGA_PASSWORD=your_komga_password \
  chu-shen/bangumikomga

Docker Compose配置

yaml
version: '3'
services:
  bangumikomga:
    image: chu-shen/bangumikomga
    container_name: bangumikomga
    volumes:
      - /path/to/your/config:/app/config
    environment:
      - BANGUMI_USERNAME=your_bangumi_username
      - BANGUMI_PASSWORD=your_bangumi_password
      - KOMGA_URL=http://your_komga_url
      - KOMGA_USERNAME=your_komga_username
      - KOMGA_PASSWORD=your_komga_password
      - SYNC_INTERVAL=86400  # 同步间隔（秒），默认为86400秒（24小时）
    restart: unless-stopped

环境变量配置

配置文件

首次运行后，配置文件将在挂载的config目录中生成，您可以根据需要修改配置：

yaml
# config.yaml示例
bangumi:
  username: your_username
  password: your_password
  timeout: 30s

komga:
  url: http://your_komga_url
  username: your_username
  password: your_password
  timeout: 30s

sync:
  interval: 86400
  match_threshold: 80
  auto_confirm: false
  exclude_tags:
    - 已完结
    - 连载中

注意事项

1. 首次运行时，建议先进行手动匹配测试，确认匹配效果后再启用自动同步
2. 匹配精度受漫画命名规范影响，建议保持统一的命名格式
3. 大批量同步可能需要较长时间，请耐心等待
4. 请确保Bangumi和Komga账号具有足够的权限

故障排除

• 如遇匹配问题，可尝试提高匹配阈值或手动调整漫画名称
• 连接问题请检查网络设置和服务地址是否正确
• 认证失败请确认账号密码是否正确
• 详细日志可在容器日志中查看，用于排查具体问题