Skip to content

⚙️ 配置说明

Bangumi-syncer 的全部配置都集中在 Web 界面的 「配置管理」 页,按功能分卡片展示,普通用户无需手写 INI。本章节按功能模块拆分为多篇文档,分别介绍各配置项的含义与用法。

配置入口

启动后在浏览器打开 http://localhost:8000,左侧菜单点击 「配置管理」,即可可视化完成全部设置。修改后点击页面下方的 「保存配置」 生效,部分项保存后需重启程序(页面上会标注)。

配置文件

Web 界面背后对应一个 config.ini 文件(INI 格式),首次运行从 config.example.ini 自动复制。查找顺序:

  1. CONFIG_FILE 环境变量
  2. /app/config/config.ini(Docker 挂载)
  3. config.dev.ini(开发)
  4. config.ini(默认)

不要混用

推荐通过 Web 界面修改。若手动编辑 config.ini,需重启程序生效,且编辑期间不要在 Web 界面保存(会覆盖手改内容)。

本章节内容

文档说明
⚙️ 配置说明同步、Bangumi 账号、代理、安全、调度器等核心配置
🔔 通知系统配置通知场景、4 类渠道(Webhook / 邮件 / 企业微信 / 钉钉)、邮件自定义模板
🔀 自定义映射标题对不上时手工指定「标题 → 条目 ID」的兜底机制
🗄️ Bangumi Archive本地归档,把全站数据快照下载到本地,优先查本地降低 API 依赖
🔄 Bangumi Replay写降级与自动补发,API 不可达时入队暂存、恢复后自动补发

配置段速查

config.ini 按功能分若干段,常见段落:

段名用途
[bangumi-oauth]Bangumi OAuth 应用凭证(Client ID / Secret,已内置可覆盖)
[sync]同步行为、屏蔽关键词、评分下限
[emby] / [jellyfin] / [plex]各媒体服务器驱动配置
[feiniu] / [fongmi] / [trakt]拉取型驱动配置
[notify-webhook-{n}] / [notify-email-{n}]通知渠道实例(可多实例)
[archive] / [replay]Archive 与 Replay 配置
[scheduler]调度器时区、任务超时
[summary-{name}]AI 追番总结任务

账号存储位置

Bangumi 账号(用户名、访问令牌、OAuth 令牌等)存储在 SQLite 数据库 data/sync_records.dbbangumi_accounts 表中,不再写入 config.ini。令牌加密存储,数据库文件泄露也不会暴露明文 token。

具体字段含义请查看对应文档。