saysaucee/chinesesubfinder

ChineseSubFinder Docker镜像文档

镜像概述

ChineseSubFinder是一款专注于自动获取媒体文件中文字幕的工具，通过Docker容器化部署，简化配置流程，支持多媒体目录管理，适用于各类媒体服务器（如Plex、Emby等）环境，帮助用户快速匹配并下载影视资源的中文字幕。

核心功能与特性

• 自动字幕匹配：扫描媒体目录，自动识别视频文件并匹配对应中文字幕
• 多目录支持：可同时挂载多个媒体目录进行字幕批量处理
• 权限管理：支持设置文件权限（PUID/PGID）及权限掩码（UMASK），确保文件访问权限正确
• WebUI界面：通过Web界面管理字幕下载任务及配置，端口***为WebUI端口
• 日志控制：支持限制容器日志大小，避免磁盘空间占用过大

使用场景

• 媒体服务器用户：为Plex、Emby等媒体库自动补充中文字幕
• 影视收藏者：批量处理本地影视文件，统一管理字幕
• 家庭影院环境：简化字幕获取流程，提升观影体验

使用方法

基本部署命令

bash
docker run -d \
    -v /mnt/sda3/down/config:/config   `# 主机配置/日志目录映射，冒号左边需修改为实际路径` \
    -v /NASTOOL:/media     `# 媒体目录映射，冒号左边修改为实际媒体路径；多目录需添加多个-v参数` \
    -e PUID=0 \
    -e PGID=0 \
    -e PERMS=true       `# 是否重设/media目录权限` \
    -e TZ=Asia/Shanghai `# 时区设置，如Asia/Shanghai` \
    -e UMASK=022        `# 权限掩码，控制新文件默认权限` \
    -p 19035:19035 \
    -p 19037:19037 `# WebUI视频列表图片读取端口，请勿暴露到外网` \
    --name chinesesubfinder \
    --hostname chinesesubfinder \
    --log-driver "json-file" \
    --log-opt "max-size=100m" `# 限制日志文件大小，可根据需求调整` \
    saysaucee/ChineseSubFinder

参数说明

挂载卷（-v）

• /config：容器配置文件、日志等数据存储目录，需映射至主机持久化保存
• /media：媒体文件目录，容器将扫描该目录下的视频文件并匹配字幕；多媒体目录需添加多个-v /主机路径:/容器内路径映射

环境变量（-e）

• PUID：运行容器的用户ID，用于权限控制，默认0（root）
• PGID：运行容器的用户组ID，默认0（root）
• PERMS：是否自动重设/media目录权限，true为启用，false为禁用
• TZ：时区设置，如Asia/Shanghai（上海时区）
• UMASK：权限掩码，控制新创建文件的默认权限，默认022

端口映射（-p）

• 19035:19035：WebUI访问端口，通过http://主机IP:19035访问管理界面
• 19037:19037：视频列表图片读取端口，仅用于内部通信，禁止暴露到公网

日志配置

• --log-driver "json-file"：使用json-file驱动记录日志
• --log-opt "max-size=100m"：限制单日志文件大小为100MB，避免日志占用过多磁盘空间

注意事项

1. 确保主机挂载目录权限正确，避免因权限问题导致文件无法读写
2. 媒体目录路径中避免包含中文或特殊字符，防止扫描异常
3. ***端口仅用于内部图片读取，请勿通过端口转发暴露到公网，以保障安全性
4. 首次启动后，通过WebUI完成字幕源等高级配置