wwfnle/chinesesubfinder

chinesesubfinder 镜像文档

镜像概述

chinesesubfinder 是一款自动化中文字幕下载工具，基于 allanpk716 2023年12月稳定版开发。该工具能够自动根据刮削的视频资源匹配并下载主流字幕网站的字幕，适用于个人媒体库管理场景，可与 nastools、moviepilot 等工具搭配使用。

核心功能与特性

• 自动字幕匹配：支持主流字幕网站，可根据视频资源自动匹配并下载中文字幕
• 灵活的媒体目录映射：支持多个媒体目录挂载，满足多文件夹视频资源的字幕下载需求
• 权限管理：可配置权限掩码和目录权限重置，确保媒体文件访问权限正确
• 时区配置：支持自定义时区设置，确保时间相关功能准确

使用场景

• 个人媒体服务器（如 Plex、Emby）的字幕自动补充
• 配合 nastools、moviepilot 等媒体管理工具，实现影视资源字幕的自动化获取
• 本地视频库的批量字幕下载与管理

使用方法与配置说明

基本部署命令

以下命令可直接复制运行，部署完成后通过浏览器访问 你的IP:19035 进入后台配置管理界面：

bash
docker run -d --name chinesesubfinder \
  -v ./config:/config \
  -v ./media:/media \
  -e PUID=1026 \
  -e PERMS=true \
  -e TZ=Asia/Shanghai \
  -e UMASK=022 \
  --restart=always \
  -p 19035:19035 \
  -p 19037:19037 \
  --log-driver "json-file" \
  --log-opt "max-size=100m" \
  --hostname chinesesubfinder \
  wwfnle/chinesesubfinder:latest

参数说明

卷挂载（-v）

• -v ./config:/config：配置文件、日志等数据的存储路径。冒号左边需修改为主机上实际保存配置文件的路径
• -v ./media:/media：视频资源目录。冒号左边需修改为需要下载字幕的视频文件夹路径，多个媒体目录需添加多个 -v 参数映射

环境变量（-e）

• PUID=1026：运行容器的用户ID
• PERMS=true：是否自动重设 /media 目录的权限
• TZ=Asia/Shanghai：时区设置，建议使用 Asia/Shanghai（中国标准时间）
• UMASK=022：权限掩码，控制新创建文件的默认权限

端口映射（-p）

• -p 19035:19035：后台管理界面端口，通过浏览器访问 IP:19035 进入配置页面
• -p 19037:19037：视频列表图片读取端口，用于管理面板显示视频封面，建议不要暴露到外网

其他参数

• --restart=always：容器退出时自动重启
• --log-driver "json-file"：日志驱动类型
• --log-opt "max-size=100m"：限制日志文件大小为100MB，可根据需要调整
• --hostname chinesesubfinder：容器主机名设置

注意事项

• 媒体目录映射时，确保主机目录存在且权限正确，避免因权限问题导致字幕下载失败
• ***端口仅用于内部视频列表图片读取，无需暴露到公网，仅在本地或局域网内访问
• 首次使用需通过 IP:19035 进入后台配置字幕网站账号等信息，以确保字幕下载功能正常工作