## 前言

使用本程序是有前提的，高度依赖 Emby、Jellyfin、Plex、tinyMediaManager 这类软件对你的视频（电影、连续剧）进行削刮。

> 没有削刮的时候，电影可以正常下载字幕，连续剧无法正确下载，如果目录结构不对，也不确定能够下载，也不打算解决类似的问题

### 推荐的电影目录结构

见 [文档](https://github.com/ChineseSubFinder/ChineseSubFinder/blob/docs/DesignFile/%E7%94%B5%E5%BD%B1%E7%9A%84%E6%8E%A8%E8%8D%90%E7%9B%AE%E5%BD%95%E7%BB%93%E6%9E%84.md)

### 推荐的连续剧目录结构

见 [文档](https://github.com/ChineseSubFinder/ChineseSubFinder/blob/docs/DesignFile/%E8%BF%9E%E7%BB%AD%E5%89%A7%E7%9B%AE%E5%BD%95%E7%BB%93%E6%9E%84%E8%A6%81%E6%B1%82.md)

## 镜像标签说明

### latest

- 提供全功能镜像；

- 基于`ubuntu`，包含`chrome` `xorg` `imagemagic`及大量依赖等，镜像大；

- 支持 `linux/amd64` `linux/arm64`；

- **支持**从包括 subhd、zimuku 在内的所有字幕源下载字幕；

- 宿主机是基于 `musl-libc` 的系统，无法正常使用，如 `openwrt` 和 `alpine`。

### latest-lite

- 提供轻量模式镜像，从`v0.33.0`开始才有此镜像；

- 基于`alpine`，不含`chrome` `xorg` `imagemagic`等包，镜像小；

- 支持`linux/amd64` `linux/arm64` `linux/386` `linux/arm/v7`平台；

- **不支持**从 subhd、zimuku 下载字幕，其他字幕源不受影响，针对少了两个字幕来源的问题，建议开启`实验室->共享字幕`功能，可在一定程度上缓解下载字幕难的问题；

- 宿主机无论是基于 `glibc` 还是 `musl-libc` 的系统，都可以使用。

## 创建

> 建议在 v0.31.x 版本开始使用本教程的 Docker 配置，如果是之前的版本见 v0.26.x 的教程即可。
> 
> 注意映射容器内的路径，一定要是 /media 这个目录下，因为容器启动第一步会进行视频文件权限的调整。具体看下面的说明。

### docker cli

```
## latest标签
docker run -d \
    -v $(pwd)/config:/config   `# 冒号左边请修改为你想在主机上保存配置、日志等文件的路径` \
    -v $(pwd)/media:/media     `# 请修改为需要下载字幕的媒体目录，冒号右边可以改成你方便记忆的目录，多个媒体目录需要添加多个-v映射` \
    -v $(pwd)/browser:/root/.cache/rod/browser `# 容器重启后无需再次下载 chrome，除非 go-rod 更新` \
    -e PUID=1026 \
    -e PGID=100 \
    -e PERMS=true       `# 是否重设/media权限` \
    -e TZ=Asia/Shanghai `# 时区` \
    -e UMASK=022        `# 权限掩码` \
    -p 19035:19035 `# 从0.20.0版本开始，通过webui来设置` \
    -p 19037:19037 `# webui 的视频列表读取图片用，务必设置不要暴露到外网` \
    --name chinesesubfinder \
    --hostname chinesesubfinder \
    --log-driver "json-file" \
    --log-opt "max-size=100m" `# 限制docker控制台日志大小，可自行调整` \
    ChineseSubFinder/ChineseSubFinder

## latest-lite标签
docker run -d \
    -v $(pwd)/config:/config   `# 冒号左边请修改为你想在主机上保存配置、日志等文件的路径` \
    -v $(pwd)/media:/media     `# 请修改为需要下载字幕的媒体目录，冒号右边可以改成你方便记忆的目录，多个媒体目录需要添加多个-v映射` \
    -e PUID=1026 \
    -e PGID=100 \
    -e PERMS=true       `# 是否重设/media权限` \
    -e TZ=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" `# 限制docker控制台日志大小，可自行调整` \
    ChineseSubFinder/ChineseSubFinder:latest-lite
```

创建好后访问`http://<ip>:19035`来进行下一步设置。

### docker-compose

新建`docker-compose.yml`文件如下，并以命令`docker-compose up -d`启动。

**`latest` 标签**

```
version: "3"
services:
  chinesesubfinder:
    image: allanpk716/ChineseSubFinder:latest
    volumes:
      - ./config:/config  # 冒号左边请修改为你想在主机上保存配置、日志等文件的路径
      - ./media:/media    # 请修改为你的媒体目录，冒号右边可以改成你方便记忆的目录，多个媒体目录需要分别映射进来
      - ./browser:/root/.cache/rod/browser    # 容器重启后无需再次下载 chrome，除非 go-rod 更新
    environment:
      - PUID=1026         # uid
      - PGID=100          # gid
      - PERMS=true        # 是否重设/media权限
      - TZ=Asia/Shanghai  # 时区
      - UMASK=022         # 权限掩码
    restart: always
    network_mode: bridge
    hostname: chinesesubfinder
    container_name: chinesesubfinder
    ports:
      - 19035:19035  # 从0.20.0版本开始，通过webui来设置
      - 19037:19037  # webui 的视频列表读取图片用，务必设置不要暴露到外网
    logging:
        driver: "json-file"
        options:
          max-size: "100m" # 限制docker控制台日志大小，可自行调整
```

**`latest-lite`标签**

```
version: "3"
services:
  chinesesubfinder:
    image: allanpk716/ChineseSubFinder:latest-lite
    volumes:
      - ./config:/config  # 冒号左边请修改为你想在主机上保存配置、日志等文件的路径
      - ./media:/media    # 请修改为你的媒体目录，冒号右边可以改成你方便记忆的目录，多个媒体目录需要分别映射进来
    environment:
      - PUID=1026         # uid
      - PGID=100          # gid
      - PERMS=true        # 是否重设/media权限
      - TZ=Asia/Shanghai  # 时区
      - UMASK=022         # 权限掩码
    restart: always
    network_mode: bridge
    hostname: chinesesubfinder
    container_name: chinesesubfinder
    ports:
      - 19035:19035
      - 19037:19037  # webui 的视频列表读取图片用，务必设置不要暴露到外网
    logging:
        driver: "json-file"
        options:
          max-size: "100m" # 限制docker控制台日志大小，可自行调整
```

创建好后访问`http://<ip>:19035`来进行下一步设置。

## 关于 PUID/PGID 的说明

如在使用诸如 emby、jellyfin、plex、qbittorrent、transmission、deluge、jackett、sonarr、radarr 等等的 docker 镜像，请在创建本容器时的设置和它们的 PUID/PGID 和它们一样，如若真的不想设置为一样，至少要保证本容器 PUID/PGID 所定义的用户拥有你设置的媒体目录（示例中是`/media`）的读取和写入权限。

进入相应容器中的目录后输入`ls -l`可查看文件的所有者及是否拥有读取写入权限。