Bazarr Docker 镜像文档

镜像概述和主要用途

Bazarr 是一个与 Sonarr 和 Radarr 集成的字幕管理工具，旨在自动下载、同步和管理您媒体库的字幕。该 Docker 镜像提供了一个简单、隔离的方式来部署和运行 Bazarr 服务，无需手动配置系统依赖。

核心功能和特性

• 自动字幕下载：根据您的媒体文件自动搜索和下载匹配的字幕
• 多语言支持：支持全球多种语言的字幕搜索和管理
• 与媒体服务器集成：可与 Sonarr、Radarr、Plex 和 Emby 无缝集成
• 字幕同步：自动调整字幕时间轴以匹配媒体文件
• 用户友好的 Web 界面：通过浏览器轻松管理所有字幕相关任务
• 定期扫描：自动扫描媒体库以查找新文件并获取缺少的字幕
• 字幕历史记录：跟踪所有下载、更新和删除的字幕操作

使用场景和适用范围

• 家庭媒体服务器：为 Plex 或 Emby 媒体服务器自动管理字幕
• 电影收藏管理：为您的电影库维护多语言字幕
• 电视剧集字幕：自动为新下载的剧集获取字幕
• 多语言家庭：满足家庭成员对不同语言字幕的需求
• 媒体爱好者：简化字幕管理流程，专注于内容欣赏而非技术配置

详细的使用方法和配置说明

基本使用方法

Docker Run 命令

docker run -d \
  --name=bazarr \
  -p 6767:6767 \
  -v /path/to/bazarr/data:/config \
  -v /path/to/media:/media \
  -e TZ=America/New_York \
  --restart unless-stopped \
  lscr.io/linuxserver/bazarr:latest

Docker Compose 配置

version: "2.1"
services:
  bazarr:
    image: lscr.io/linuxserver/bazarr:latest
    container_name: bazarr
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=America/New_York
    volumes:
      - /path/to/bazarr/data:/config
      - /path/to/media:/media
    ports:
      - 6767:6767
    restart: unless-stopped

配置参数说明

端口映射

• 6767:6767 - Bazarr Web 界面和 API 端口

环境变量

数据卷

首次运行和初始配置

1. 启动容器后，通过 http://<your-server-ip>:6767 访问 Bazarr Web 界面
2. 完成初始设置向导：
   • 配置 Sonarr 和/或 Radarr 连接（可选但推荐）
   • 设置首选字幕语言和下载偏好
   • 指定媒体库路径（应与容器内挂载路径一致）
3. 系统将开始扫描您的媒体库并报告缺少的字幕
4. 配置自动下载规则和计划任务

高级配置选项

• 代理设置：在 Web 界面中配置 HTTP 代理以访问受地区限制的字幕服务
• 通知设置：配置邮件或 Slack 通知，接收字幕下载状态更新
• 质量过滤：设置字幕质量、评分和上传日期过滤规则
• 权限设置：调整下载字幕文件的权限和所有权
• 备份配置：启用自动配置备份，防止数据丢失

常见问题解决

• 字幕下载失败：检查网络连接、字幕服务可用性以及媒体文件命名是否规范
• 权限问题：确保宿主机上的媒体目录权限允许容器内用户读取和写入
• 集成问题：验证 Sonarr/Radarr API 密钥和 URL 是否正确配置
• 性能问题：对于大型媒体库，考虑增加扫描间隔或调整资源限制

维护和更新

• 手动更新：停止容器，拉取最新镜像，然后重新启动容器
• 自动更新：可使用 Watchtower 等工具自动监控和更新 Docker 镜像
• 数据备份：定期备份 /config 目录以保存所有设置和历史记录

资源需求

• CPU：最低 1 核，推荐 2 核或更高
• 内存：最低 512MB，推荐 1GB 或更高
• 存储：至少 100MB 用于应用本身，外加字幕文件存储空间

支持和反馈

如果遇到任何问题，请参考官方文档或在 GitHub 上提交 issue：

• Bazarr 官方文档
• Bazarr GitHub 仓库
• Docker 镜像维护者