hankscafe/omnibus

Omnibus

终极一体化自托管漫画和manga应用。

Omnibus 是一款专为漫画和manga社区打造的自托管网络应用。它无缝连接了数字漫画收藏的发现、请求、下载、管理和阅读等全流程。

基于Next.js 15、Tailwind v4、Prisma和无服务器SQLite引擎构建，Omnibus具有轻量级、高性能特点，且在所有设备上均能响应流畅。

完整文档、截图和深入功能解析，请访问https://github.com/hankscafe/omnibus%E3%80%82

核心功能

• 双元数据引擎：可选择ComicVine（默认）或Metron.Cloud作为主要来源，自动拉取高清封面、剧情简介和创作者信息。
• 一体化流程：发现新发布内容、请求缺失期刊、发送至下载客户端（qBittorrent、SABnzbd等）并阅读——全部在同一界面完成。
• 原生网页阅读器：快速零摩擦的浏览器阅读体验，支持.cbz、.cbr（自动转换为cbz）和.epub格式，提供从左到右（LTR）、从右到左（RTL，适用于Manga）和Webtoon滚动模式。
• 自动化组织与智能匹配：自动提取、重命名下载文件并路由至指定库目录。未匹配的零散文件可通过AI辅助的智能匹配器（支持ComicVine和Metron ID）即时组织。
• 智能阅读列表：粘贴ComicVine或Metron事件ID即可自动构建阅读顺序。支持从CBL文件、CSV（漫画极客联盟）、AniList或MyAnimeList导入外部列表。
• 发布日历与发现：跟踪全球漫画即将发布内容，维护个性化收藏清单（由Metron提供支持），通过彩色编码库徽章直观显示缺失或未发布期刊。
• 多用户与安全：集成NextAuth的OpenID Connect（SSO）、双因素认证（2FA），并为家人朋友提供独立的阅读进度跟踪。
• 外部阅读支持（OPDS & KOReader）：原生OPDS 1.2服务器（带页面流扩展PSE），支持Panels和Mihon等应用，以及KOReader设备的原生电子墨水同步。

安装（Docker Compose）

Omnibus专为Docker部署设计。由于采用无服务器SQLite引擎，所有必要的数据库文件和依赖项均直接捆绑在镜像中，无需外部数据库容器。

1. 将以下内容保存为docker-compose.yml：

yaml
version: '3.8'

services:
  omnibus:
    image: ghcr.io/hankscafe/omnibus:latest
    container_name: omnibus
    restart: unless-stopped
    ports:
      - "3000:3000"
    depends_on:
      - omnibus-redis
    environment:
      - TZ=America/New_York  # 时区设置，例如"Asia/Shanghai"
      
      # 必需：Omnibus实例的标准URL。NextAuth要求此URL必须完全匹配。
      # 仅本地访问：设置为NAS IP和端口（例如：http://192.168.1.50:3000）
      # 外部访问：设置为公共域名（例如：https://omnibus.yourdomain.com）
      # 注意：不要包含尾随斜杠！
      - NEXTAUTH_URL=http://<你的IP:端口>
      
      # 必需：生成随机字符串以确保安全
      # !!注意!! - NEXTAUTH_SECRET同时作为数据库主加密密钥。!!请勿丢失此密钥!!
      - NEXTAUTH_SECRET=
      
      # --- 高级安全设置 ---
      # 默认情况下，Omnibus要求使用HTTPS连接才能使用"以...身份登录"（模拟）功能
      # 以防止会话令牌在网络中被拦截。
      # 如果在没有SSL的安全私有家庭网络（LAN）上运行Omnibus，
      # 可取消以下行注释以绕过此限制（风险自负）。
      # - ALLOW_INSECURE_IMPERSONATION=true
      
      # 必需：后台作业队列的连接URL
      - OMNIBUS_REDIS_URL=redis://omnibus-redis:6379/0
      
      # 必需：数据库连接字符串
      - DATABASE_URL=file:/config/omnibus.db
      
      # 预配置路径：这些会在下方映射的/config卷中自动创建子文件夹
      - OMNIBUS_CACHE_DIR=/config/cache  # 缓存目录
      - OMNIBUS_LOGS_DIR=/config/logs    # 日志目录
      - OMNIBUS_BACKUPS_DIR=/config/backups  # 备份目录

      # 监控文件夹：在单个数据挂载中设置这些以实现快速原子移动！
      - OMNIBUS_WATCHED_DIR=/data/watched       # 监控目录
      - OMNIBUS_AWAITING_MATCH_DIR=/data/unmatched  # 待匹配目录

    volumes:
      # 必需：数据库、日志、备份、缓存和上传图片的持久化存储
      - /path/to/your/nas/config:/config  # 替换为你的配置目录路径
      
      # -------------------------------------------------------------------------
      # 选项1：推荐的单一数据挂载（快速原子移动/硬链接）
      # -------------------------------------------------------------------------
      # 将整个媒体/下载根目录映射到/data以获得最佳性能
      - /path/to/your/nas/data:/data  # 替换为你的数据根目录路径
      
      # -------------------------------------------------------------------------
      # 选项2：分离挂载（较慢的复制/粘贴/删除操作）
      # 如果文件夹位于不同驱动器上，取消以下注释并删除选项1
      # -------------------------------------------------------------------------
      # - /path/to/your/nas/comics:/comics      # 漫画目录
      # - /path/to/your/nas/manga:/manga        # manga目录
      # - /path/to/your/nas/downloads:/downloads  # 下载目录
      # - /path/to/your/nas/watched:/watched    # 监控目录
      # - /path/to/your/nas/unmatched:/unmatched  # 待匹配目录

  omnibus-redis:
    image: redis:alpine
    container_name: omnibus-redis
    restart: unless-stopped
    # 不向主机暴露端口以避免冲突。Omnibus通过Docker内部网络连接到此容器。

2. 运行docker-compose up -d。
3. 打开浏览器，导航至设置的NEXTAUTH_URL以访问初始设置向导！

支持与社区

如遇问题、有建议或想贡献代码，请加入社区：

• https://github.com/hankscafe/omnibus/issues
• 加入***