配置说明

MediaBot 的大部分配置都在网页界面里完成，只有部署相关的少数项需要改配置文件。

部署相关

配置项	位置	说明
监听端口	.env 的 WEB_PORT	默认 9015。改完执行 docker compose up -d。
镜像版本	.env 的 APP_VERSION	升级与回滚的版本依据。
数据库连接	安装向导写入 data/config/app.override.json	安装后一般不需要手改。
数据目录	部署目录下的 data/	配置、日志与备份都在这里，容器重建不会丢失。

数据库

安装时选择 MySQL 或 PostgreSQL。两项都支持，推荐 MySQL（线上主流部署同为 MySQL，遇到问题更容易找到参考）。

一键安装自带内置数据库：--with-mysql（MySQL，推荐）或 --with-db（PostgreSQL），适合先跑起来看看；确定长期使用建议接入已有的 MySQL 实例。

连接串、账号与库名只在安装向导里填写一次；后续迁移由应用内嵌的迁移器完成， 升级前请先备份。

通知

在通知设置里添加渠道。当前支持 Telegram、飞书、企业微信与邮件。 通知内容为面向用户的摘要，例如「下载完成 · 某订阅 · 某资源」，不包含内部技术细节。

如果不需要接收推送，可以只保留「待办」页签并关闭全部通知渠道， 未解决的问题仍会累积在待办中。

下载器

支持 qBittorrent 与 Transmission。建议：

• 为 MediaBot 建立独立分类，便于统计和清理；
• 保存目录与媒体库的硬链接或移动策略保持一致，避免重复占用空间；
• 不要和其他自动化工具共用同一个下载实例，任务归属会难以区分。

日志

容器日志：docker compose logs -f app。 应用内也有日志页面，按模块与级别过滤，排查订阅或站点问题时优先看这里。