wofeiwo/subfinder

subfinder镜像说明

镜像概述

本镜像基于开源项目subfinder构建，旨在自动扫描指定目录（含子目录）中的视频文件，匹配并下载对应的中英文字幕。默认配置为每30分钟执行一次字幕匹配下载任务，适用于个人媒体库或NAS环境的字幕管理需求。

核心功能

1. 自动扫描指定目录及子目录下的视频文件（支持mp4、mkv、iso等格式）
2. 通过shooter、zimuzu、zimuku等多个源匹配并下载中英文字幕
3. 支持自定义配置字幕格式（ass、srt）及字幕源
4. 定期执行字幕下载任务（默认30分钟一次）

使用场景

• 家庭NAS用户自动补充媒体库中视频的字幕
• 个人本地视频文件夹批量获取字幕
• 媒体服务器（如Emby、Plex）的字幕自动更新辅助工具

配置说明

目录映射要求

1. 将视频文件所在目录映射至容器内的/media路径
2. 将配置文件所在目录映射至容器内的/config路径（需包含subfinder.json配置文件）

配置文件示例（subfinder.json）

json
{
   "exts": ["ass", "srt"],
   "method": ["shooter", "zimuzu", "zimuku"],
   "video_exts": [".mp4", ".mkv", ".iso"],
   "api_urls": {
      "zimuku": "http://www.zimuku.la/search",
      "zimuzu": "http://www.zmz2019.com/search",
      "zimuzu_subtitle_api_url": "http://got001.com/api/v1/static/subtitle/detail"
   }
}

Docker部署示例

docker run命令

bash
docker run -d \
  --name subfinder \
  -v /your/local/media:/media \
  -v /your/local/config:/config \
  wofeiwo/subfinder

docker-compose配置

yaml
version: '3'
services:
  subfinder:
    image: wofeiwo/subfinder
    volumes:
      - /your/local/media:/media
      - /your/local/config:/config
    restart: unless-stopped