Bazarr部署完全手册Docker、Linux、Windows全平台指南【免费下载链接】bazarrBazarr is a companion application to Sonarr and Radarr. It manages and downloads subtitles based on your requirements. You define your preferences by TV show or movie and Bazarr takes care of everything for you.项目地址: https://gitcode.com/gh_mirrors/ba/bazarrBazarr是一款强大的字幕管理工具专为Sonarr和Radarr用户设计能够自动下载和管理影视剧字幕。本终极指南将详细介绍如何在Docker、Linux和Windows三大平台上快速部署Bazarr字幕管理系统让您轻松搭建个人化的字幕自动化解决方案。 Bazarr字幕管理系统简介Bazarr是Sonarr和Radarr的完美伴侣应用专门负责自动下载和管理字幕。它能够根据您的偏好设置为电视剧和电影智能匹配并下载合适的字幕文件。Bazarr支持超过184种语言的字幕包括强制字幕和外文字幕并能与现有的Sonarr和Radarr库无缝集成。 Docker容器化部署方案Docker Compose快速部署使用Docker部署Bazarr是最简单快捷的方式特别适合新手用户。以下是完整的docker-compose配置version: 3.8 services: bazarr: image: linuxserver/bazarr:latest container_name: bazarr environment: - PUID1000 - PGID1000 - TZAsia/Shanghai volumes: - ./config:/config - /path/to/movies:/movies - /path/to/tv:/tv ports: - 6767:6767 restart: unless-stopped部署步骤详解创建配置文件目录mkdir -p /opt/bazarr/config创建docker-compose.yml文件 将上述配置保存为docker-compose.yml文件启动Bazarr服务docker-compose up -d访问Web界面 打开浏览器访问http://服务器IP:6767即可开始配置Docker环境变量说明PUID/PGID设置容器内用户权限确保文件访问正常TZ设置时区确保时间同步准确卷挂载config目录存储配置movies/tv目录映射媒体库 Linux系统原生部署Ubuntu/Debian系统安装对于Linux用户原生部署提供了更好的性能和控制能力安装Python依赖sudo apt update sudo apt install python3 python3-pip python3-venv ffmpeg mediainfo下载Bazarr源码git clone https://gitcode.com/gh_mirrors/ba/bazarr.git cd bazarr创建虚拟环境python3 -m venv venv source venv/bin/activate安装Python依赖包pip install -r requirements.txt启动Bazarr服务python3 bazarr.py创建Systemd服务推荐为了让Bazarr在Linux系统启动时自动运行创建服务文件sudo nano /etc/systemd/system/bazarr.service添加以下配置[Unit] DescriptionBazarr Subtitle Manager Afternetwork.target [Service] Typesimple Useryourusername Groupyourgroup WorkingDirectory/path/to/bazarr ExecStart/path/to/bazarr/venv/bin/python3 /path/to/bazarr/bazarr.py Restarton-failure RestartSec10 [Install] WantedBymulti-user.target启用并启动服务sudo systemctl daemon-reload sudo systemctl enable bazarr sudo systemctl start bazarr Windows系统部署指南Windows原生安装步骤Windows用户可以通过以下步骤轻松部署Bazarr安装Python环境从Python官网下载Python 3.8版本安装时务必勾选Add Python to PATH安装必要软件下载并安装FFmpeg安装MediaInfo工具获取Bazarr源码git clone https://gitcode.com/gh_mirrors/ba/bazarr.git cd bazarr安装依赖包pip install -r requirements.txt启动Bazarrpython bazarr.pyWindows服务化部署将Bazarr配置为Windows服务实现开机自启动使用NSSM创建服务nssm install Bazarr C:\Python39\python.exe C:\bazarr\bazarr.py配置服务参数设置启动类型为自动配置正确的用户权限设置工作目录为Bazarr路径⚙️ Bazarr基础配置教程首次启动配置访问Bazarr Web界面后按以下步骤配置设置Sonarr/Radarr连接进入Settings → General填写Sonarr和Radarr的API密钥和地址测试连接确保正常配置字幕提供商进入Settings → Subtitles启用OpenSubtitles等提供商设置API密钥部分需要注册设置语言偏好配置默认字幕语言设置备用语言选项启用强制字幕检测高级配置选项在bazarr/app/get_args.py中可以找到更多启动参数--config指定配置文件目录--port自定义端口号--debug启用调试模式--no-update禁用自动更新 常见问题与故障排除连接Sonarr/Radarr失败问题Bazarr无法连接到Sonarr或Radarr解决方案检查API密钥是否正确确认Sonarr/Radarr服务正在运行验证网络连接和防火墙设置检查URL地址是否正确包含端口号字幕下载失败问题字幕无法正常下载解决方案检查字幕提供商API密钥是否有效确认网络代理设置如需查看日志文件获取详细错误信息尝试更换其他字幕提供商文件权限问题问题Bazarr无法访问媒体文件解决方案确保Bazarr运行用户有文件读写权限检查挂载点的权限设置在Docker中正确设置PUID/PGID 监控与维护日志查看方法Bazarr提供详细的日志记录帮助诊断问题Docker部署docker logs bazarrLinux系统查看/config/logs/bazarr.logWindows系统查看安装目录下的logs文件夹定期维护建议备份配置文件定期备份config目录更新Bazarr保持最新版本获取新功能清理缓存定期清理不必要的缓存文件监控磁盘空间确保有足够空间存储字幕 性能优化技巧提升字幕搜索速度启用多个字幕提供商增加成功率调整搜索间隔避免频繁请求被限制使用本地缓存减少重复下载资源占用优化调整扫描频率根据需求设置合适的扫描间隔限制并发下载避免占用过多网络资源优化数据库定期清理历史记录 总结Bazarr作为Sonarr和Radarr的最佳伴侣为您的媒体库提供了完整的字幕管理解决方案。无论您是Docker用户、Linux爱好者还是Windows用户都能找到适合自己的部署方式。通过本指南的详细步骤您可以在几分钟内搭建起功能强大的字幕自动化系统。记住成功的部署只是第一步合理的配置和定期的维护才是保证系统长期稳定运行的关键。现在就开始部署您的Bazarr字幕管理系统享受自动化的字幕下载体验吧提示部署完成后建议先在小规模媒体库上测试确认一切正常后再应用到完整库中。祝您部署顺利【免费下载链接】bazarrBazarr is a companion application to Sonarr and Radarr. It manages and downloads subtitles based on your requirements. You define your preferences by TV show or movie and Bazarr takes care of everything for you.项目地址: https://gitcode.com/gh_mirrors/ba/bazarr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Bazarr部署完全手册：Docker、Linux、Windows全平台指南
发布时间：2026/5/25 18:10:38
Bazarr部署完全手册Docker、Linux、Windows全平台指南【免费下载链接】bazarrBazarr is a companion application to Sonarr and Radarr. It manages and downloads subtitles based on your requirements. You define your preferences by TV show or movie and Bazarr takes care of everything for you.项目地址: https://gitcode.com/gh_mirrors/ba/bazarrBazarr是一款强大的字幕管理工具专为Sonarr和Radarr用户设计能够自动下载和管理影视剧字幕。本终极指南将详细介绍如何在Docker、Linux和Windows三大平台上快速部署Bazarr字幕管理系统让您轻松搭建个人化的字幕自动化解决方案。 Bazarr字幕管理系统简介Bazarr是Sonarr和Radarr的完美伴侣应用专门负责自动下载和管理字幕。它能够根据您的偏好设置为电视剧和电影智能匹配并下载合适的字幕文件。Bazarr支持超过184种语言的字幕包括强制字幕和外文字幕并能与现有的Sonarr和Radarr库无缝集成。 Docker容器化部署方案Docker Compose快速部署使用Docker部署Bazarr是最简单快捷的方式特别适合新手用户。以下是完整的docker-compose配置version: 3.8 services: bazarr: image: linuxserver/bazarr:latest container_name: bazarr environment: - PUID1000 - PGID1000 - TZAsia/Shanghai volumes: - ./config:/config - /path/to/movies:/movies - /path/to/tv:/tv ports: - 6767:6767 restart: unless-stopped部署步骤详解创建配置文件目录mkdir -p /opt/bazarr/config创建docker-compose.yml文件 将上述配置保存为docker-compose.yml文件启动Bazarr服务docker-compose up -d访问Web界面 打开浏览器访问http://服务器IP:6767即可开始配置Docker环境变量说明PUID/PGID设置容器内用户权限确保文件访问正常TZ设置时区确保时间同步准确卷挂载config目录存储配置movies/tv目录映射媒体库 Linux系统原生部署Ubuntu/Debian系统安装对于Linux用户原生部署提供了更好的性能和控制能力安装Python依赖sudo apt update sudo apt install python3 python3-pip python3-venv ffmpeg mediainfo下载Bazarr源码git clone https://gitcode.com/gh_mirrors/ba/bazarr.git cd bazarr创建虚拟环境python3 -m venv venv source venv/bin/activate安装Python依赖包pip install -r requirements.txt启动Bazarr服务python3 bazarr.py创建Systemd服务推荐为了让Bazarr在Linux系统启动时自动运行创建服务文件sudo nano /etc/systemd/system/bazarr.service添加以下配置[Unit] DescriptionBazarr Subtitle Manager Afternetwork.target [Service] Typesimple Useryourusername Groupyourgroup WorkingDirectory/path/to/bazarr ExecStart/path/to/bazarr/venv/bin/python3 /path/to/bazarr/bazarr.py Restarton-failure RestartSec10 [Install] WantedBymulti-user.target启用并启动服务sudo systemctl daemon-reload sudo systemctl enable bazarr sudo systemctl start bazarr Windows系统部署指南Windows原生安装步骤Windows用户可以通过以下步骤轻松部署Bazarr安装Python环境从Python官网下载Python 3.8版本安装时务必勾选Add Python to PATH安装必要软件下载并安装FFmpeg安装MediaInfo工具获取Bazarr源码git clone https://gitcode.com/gh_mirrors/ba/bazarr.git cd bazarr安装依赖包pip install -r requirements.txt启动Bazarrpython bazarr.pyWindows服务化部署将Bazarr配置为Windows服务实现开机自启动使用NSSM创建服务nssm install Bazarr C:\Python39\python.exe C:\bazarr\bazarr.py配置服务参数设置启动类型为自动配置正确的用户权限设置工作目录为Bazarr路径⚙️ Bazarr基础配置教程首次启动配置访问Bazarr Web界面后按以下步骤配置设置Sonarr/Radarr连接进入Settings → General填写Sonarr和Radarr的API密钥和地址测试连接确保正常配置字幕提供商进入Settings → Subtitles启用OpenSubtitles等提供商设置API密钥部分需要注册设置语言偏好配置默认字幕语言设置备用语言选项启用强制字幕检测高级配置选项在bazarr/app/get_args.py中可以找到更多启动参数--config指定配置文件目录--port自定义端口号--debug启用调试模式--no-update禁用自动更新 常见问题与故障排除连接Sonarr/Radarr失败问题Bazarr无法连接到Sonarr或Radarr解决方案检查API密钥是否正确确认Sonarr/Radarr服务正在运行验证网络连接和防火墙设置检查URL地址是否正确包含端口号字幕下载失败问题字幕无法正常下载解决方案检查字幕提供商API密钥是否有效确认网络代理设置如需查看日志文件获取详细错误信息尝试更换其他字幕提供商文件权限问题问题Bazarr无法访问媒体文件解决方案确保Bazarr运行用户有文件读写权限检查挂载点的权限设置在Docker中正确设置PUID/PGID 监控与维护日志查看方法Bazarr提供详细的日志记录帮助诊断问题Docker部署docker logs bazarrLinux系统查看/config/logs/bazarr.logWindows系统查看安装目录下的logs文件夹定期维护建议备份配置文件定期备份config目录更新Bazarr保持最新版本获取新功能清理缓存定期清理不必要的缓存文件监控磁盘空间确保有足够空间存储字幕 性能优化技巧提升字幕搜索速度启用多个字幕提供商增加成功率调整搜索间隔避免频繁请求被限制使用本地缓存减少重复下载资源占用优化调整扫描频率根据需求设置合适的扫描间隔限制并发下载避免占用过多网络资源优化数据库定期清理历史记录 总结Bazarr作为Sonarr和Radarr的最佳伴侣为您的媒体库提供了完整的字幕管理解决方案。无论您是Docker用户、Linux爱好者还是Windows用户都能找到适合自己的部署方式。通过本指南的详细步骤您可以在几分钟内搭建起功能强大的字幕自动化系统。记住成功的部署只是第一步合理的配置和定期的维护才是保证系统长期稳定运行的关键。现在就开始部署您的Bazarr字幕管理系统享受自动化的字幕下载体验吧提示部署完成后建议先在小规模媒体库上测试确认一切正常后再应用到完整库中。祝您部署顺利【免费下载链接】bazarrBazarr is a companion application to Sonarr and Radarr. It manages and downloads subtitles based on your requirements. You define your preferences by TV show or movie and Bazarr takes care of everything for you.项目地址: https://gitcode.com/gh_mirrors/ba/bazarr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
