配置项说明文档

本文档详细说明各配置项的用途、取值范围及使用注意事项，帮助您正确配置应用参数。

媒体服务器配置

Emby 服务器

配置项	说明	示例
`EMBY_URL`	Emby服务器的访问地址（需包含端口，如适用）	`[***]`
`EMBY_API_KEY`	Emby服务器的API密钥，用于鉴权访问	`a1b2c3d4e5f6g7h8i9j0`

Plex 服务器

配置项	说明	示例
`PLEX_URL`	Plex服务器的访问地址	`[***]`
`PLEX_TOKEN`	Plex服务器的访问Token，用于鉴权	`x9y8z7a6b5c4d3e2f1g0`

Jellyfin 服务器

配置项	说明	示例
`JELLYFIN_URL`	Jellyfin服务器的访问地址	`[***]`
`JELLYFIN_API_KEY`	Jellyfin服务器的API密钥	`9876543210abcdefghij`
`JELLYFIN_USER`	Jellyfin服务器的用户名，用于关联用户权限	`admin`

下载工具配置

qBittorrent

配置项	说明	示例
`QBITTORRENT_URL`	qBittorrent WebUI的访问地址	`[***]`
`QBITTORRENT_USERNAME`	qBittorrent登录用户名	`admin`
`QBITTORRENT_PASSWORD`	qBittorrent登录密码	`password123`
`QBITTORRENT_DOWNLOAD_PATH`	qBittorrent默认下载路径	`/downloads/torrents`
`QBITTORRENT_CATEGORY`	qBittorrent下载任务默认分类	`jav`

Transmission

配置项	说明	示例
`TRANSMISSION_URL`	Transmission RPC访问地址	`[***]`
`TRANSMISSION_USERNAME`	Transmission登录用户名	`admin`
`TRANSMISSION_PASSWORD`	Transmission登录密码	`password456`
`TRANSMISSION_DOWNLOAD_PATH`	Transmission默认下载路径	`/mnt/downloads`
`TRANSMISSION_LABEL`	Transmission下载任务默认标签	`media`

迅雷

配置项	说明	示例
`THUNDER_URL`	迅雷远程访问地址	`[***]`
`THUNDER_FILE_ID`	迅雷下载目录对应的ID（用于指定下载位置）	`***`
`THUNDER_AUTHORIZATION`	迅雷授权请求参数（如Token/密钥等）	`Bearer abc123def456`

PT站点配置

配置项	说明	示例
`ROUSI_COOKIE`	肉丝PT站点的登录Cookie，用于自动访问站点	`uid=123; pass=abc;`
`PTT_COOKIE`	PTT PT站点的登录Cookie	`session=xyz789;`
`NICEPT_COOKIE`	NicePT站点的登录Cookie	`auth=98765;`
`MTEAM_API_KEY`	馒头(MTeam)站点的API密钥	`mteam-api-987654`

消息推送配置

企业微信推送

配置项	说明	示例
`WECHAT_CORP_ID`	企业微信的企业ID	`ww***abcdef`
`WECHAT_CORP_SECRET`	企业微信应用的密钥	`secret***abcdef`
`WECHAT_AGENT_ID`	企业微信应用ID	`***`
`WECHAT_TOKEN`	企业微信接收消息的Token（用于验证）	`wechat-token-123`
`WECHAT_ENCODING_AES_KEY`	企业微信消息加密的AESKey	`aeskey*abcdef*abcd`
`WECHAT_TO_USER`	推送目标用户（用\|分割，默认@all）	`user1\|user2\|@all`
`WECHAT_PROXY`	企业微信推送使用的代理地址（可选）	`[***]`
`WECHAT_PHOTO`	推送横幅图地址（需外网可访问）	`[***]`
`WECHAT_BANNER`	是否显示推送横幅图（布尔值：True/False）	`True`

*** 推送

配置项	说明	示例
`***_BOT_TOKEN`	*** Bot的Token（从@BotFather获取）	`*:ABCdefGhIJKlmNoPQRstUvWxYz*`
`***_CHAT_ID`	接收消息的Chat ID（个人/群组）	`987654321`
`***_SPOILER`	图片是否启用防剧透（布尔值：True/False）	`True`
`***_WHITELIST`	允许使用Bot的用户ID（用\|分割，可选）	`***\|789012`

网络与代理配置

配置项	说明	示例
`PROXY`	全局HTTP代理地址	`[***]`
`BYPASS_URL`	cloudflarebypassforscraping服务地址（可选）	`[***]`
`EXTERNAL_DOMAIN`	应用的外网访问地址（用于生成可访问链接）	`[***]`

过滤与排序配置

配置项	说明	示例
`DEFAULT_FILTER`	默认资源过滤规则（JSON格式）	`{"only_chinese": false, "only_uc": false,"exclude_uc": false, "only_uhd": false,"only_free": false, "exclude_uhd": true, "include_keywords": "", "exclude_keywords": "", "min_size": "", "max_size": ""}`
`DEFAULT_SORT`	默认资源排序规则（逗号分隔）	`free,chinese,uc,!uc,site,seeders,!uhd,uhd`
`MAX_ACTOR`	最大共演人数（用于筛选演员相关资源）	`3`

定时任务配置

配置项	说明	示例
`RANK_SCHEDULE_TIME`	排行榜每日订阅执行时间（Crontab格式）	`0 20 * * *`（每天20点执行）
`ACTOR_SCHEDULE_TIME`	演员订阅每日执行时间（Crontab格式）	`0 21 * * *`（每天21点执行）
`DOWNLOAD_SCHEDULE_TIME`	订阅任务每日下载执行时间（Crontab格式）	`0 22 * * *`（每天22点执行）

榜单与订阅配置

配置项	说明	示例
`RANK_PAGE`	图书馆榜单自动更新页数（0=不自动订阅）	`5`
`RANK_TYPE`	javdb榜单类型（如：daily/weekly/monthly）	`daily`
`BRAND_TYPE`	厂牌订阅类型（根据站点定义取值）	`s1-0`
`MAIN_SITE`	主站设置（ALL=全部站点，或指定站点标识）	`ALL`

存储与缓存配置

配置项	说明	示例
`ENABLE_PHOTO_CACHE`	开启图片持久化缓存（布尔值：True/False）	`True`
`ENABLE_AUTO_COMPLETE`	跳过已入库资源（布尔值：True/False）	`True`
`IMAGE_MODE`	图片显示模式（可选：INVISIBLE/VISIBLE/BLUR）	`BLUR`

云存储配置（CD2）

配置项	说明	示例
`CLOUDNAS_URL`	CD2（CloudNAS）访问地址	`[***]`
`CLOUDNAS_USERNAME`	CD2登录用户名	`admin`
`CLOUDNAS_PASSWORD`	CD2登录密码	`cd2password`
`CLOUDNAS_SAVEPATH`	CD2文件保存路径	`/115open`

翻译服务配置

配置项	说明	示例
`BAIDU_API_KEY`	百度翻译API密钥	`baidu-api-***`
`BAIDU_APP_ID`	百度翻译APP ID	`***`
`GOOGLE_API_KEY`	谷歌翻译API密钥	`google-api-987654`

BT相关配置

配置项	说明	示例
`ENABLE_BT_ANTI_LEECH`	开启BT种子防吸血（布尔值：True/False）	`True`
`BT_URL`	BT资源请求地址，请求后需返回指定格式数据	`[***]`
`BT_JSON_DATA`	BT请求的JSON数据（POST时使用，GET时留空）	`{"keyword": "jav", "page": 1}`
`BT_HEADER`	BT请求的自定义请求头，需确保请求能正常获取数据	`{"User-Agent": "Mozilla/5.0", "Authorization": "Bearer token123"}`
`BT_METHOD`	BT请求方法（可选：get/post）	`GET`

BT请求返回数据格式要求

核心规则

BT接受的关键字参数必须为 keyword,否则无法接收到BM传入的关键字

BT请求的返回数据必须符合 {data: []} 格式，其中 data 数组内的每个对象需严格匹配以下 Torrent 模型结构：

Torrent 模型定义

字段名	类型	说明	示例
`id`	整数	种子唯一标识	`1001`
`site`	字符串	种子所属站点标识	`BT`
`size_mb`	浮点数	种子大小（单位：MB）	`2048.5`
`seeders`	整数	种子做种人数	`50`
`title`	字符串	种子标题	`XXX-XXXX 高清版`
`chinese`	布尔值	是否有中文字幕/中文标题	`True`
`uc`	布尔值	是否为UC资源（根据业务定义）	`False`
`uhd`	布尔值	是否为超高清（4K/8K等）	`True`
`free`	布尔值	是否免费下载（免流量/免积分）	`True`
`download_url`	字符串	种子下载磁链	`magnet:?....`

完整返回示例

json
{
  "data": [
    {
      "id": 1001,
      "site": "BT",
      "size_mb": 2048.5,
      "seeders": 50,
      "title": "XXX-XXXX 高清中文字幕版",
      "chinese": true,
      "uc": false,
      "uhd": true,
      "free": true,
      "download_url": "magnet:?...."
    },
    {
      "id": 1002,
      "site": "BT",
      "size_mb": 1536.2,
      "seeders": 28,
      "title": "YYY-YYYY 普通版",
      "chinese": false,
      "uc": true,
      "uhd": false,
      "free": false,
      "download_url": "magnet:?...."
    }
  ]
}

查看更多 byte-muse 相关镜像 →