turgon37/transmission

Docker Bittorrent Transmission

![Build Status]([***]

本镜像包含 Transmission客户端 的实例。该项目灵感来源于 https://github.com/linuxserver/docker-transmission%EF%BC%8C%E5%B9%B6%E7%BB%8F%E8%BF%87%E9%87%8D%E5%86%99%E4%BB%A5%E6%94%AF%E6%8C%81%E9%80%9A%E8%BF%87%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E9%85%8D%E7%BD%AE%E5%A4%A7%E9%83%A8%E5%88%86%E5%8F%82%E6%95%B0%E3%80%82

⚠️ 请留意 更新日志，版本之间可能存在不兼容的变更。

功能特性

Web UI身份验证

需修改settings.json文件启用用户名/密码保护（容器需停止）：

• "rpc-authentication-required": true（默认false，改为true）
• "rpc-username": "your-username"（替换为自定义用户名）
• "rpc-password": "your-password"（替换为自定义密码，重启后自动转为哈希值）

自动更新黑名单

配置外部cron任务实现自动更新（需先设置"blocklist-enabled": true并填入有效blocklist-url）：

bash
0 3 * * * root docker ps | grep --quiet 'transmission

## 下载完成邮件通知
通过环境变量启用邮件通知，支持SMTP认证与加密：
### 必需变量
| 变量名          | 类型          | 描述                     |
|-----------------|---------------|--------------------------|
| SMTP_SERVER     | 主机/地址     | SMTP服务器地址           |
| MAIL_FROM       | 字符串        | 发件人***               |
| MAIL_TO         | 字符串        | 收件人***（分号分隔多个）|

### 可选变量
| 变量名          | 类型          | 描述                     |
|-----------------|---------------|--------------------------|
| SMTP_PORT       | 整数          | SMTP端口（默认25）       |
| SMTP_USERNAME   | 字符串        | SMTP认证用户名           |
| SMTP_PASSWORD   | 字符串        | SMTP认证密码             |
| SMTP_SSL        | yes/no        | 启用SSL连接              |
| SMTP_STARTTLS   | yes/no        | 启用STARTTLS模式         |
| MAIL_SUBJECT    | 字符串        | 邮件主题                 |

# Docker信息
## 暴露端口
| 端口                  | 用途           |
|-----------------------|----------------|
| 9091                  | Web UI访问端口  |
| 51413/tcp 51413/udp   | 对等连接端口    |

## 挂载卷
| 卷路径          | 用途                     |
|-----------------|--------------------------|
| /config         | 存储配置与状态文件       |
| /downloads      | 下载文件存储路径         |
| /watch          | 自动加载torrent的监控目录 |

# 安装与使用
## 安装方式
- 手动构建：`git clone https://github.com/Turgon37/docker-transmission.git && docker build -t turgon37/transmission .`
- 自动拉取：`docker pull turgon37/transmission`

## 基础运行
```bash
docker run -p 80:9091 turgon37/transmission

Docker Compose示例（带SMTP配置）

yaml
services:
  transmission:
    image: turgon37/transmission
    environment:
      - SMTP_SERVER=10.0.0.1
      - MAIL_FROM=***
      - MAIL_TO=***
    ports:
      - "127.0.0.1:51413:51413/tcp"
      - "127.0.0.1:51413:51413/udp"
      - "127.0.0.1:8001:9091/tcp"
    volumes:
      - data-transmission:/config
      - data-transmission-download:/downloads/complete
      - data-transmission-incomplete:/downloads/incomplete
      - data-transmission-watch:/watch
volumes:
  data-transmission:
  data-transmission-download:
  data-transmission-incomplete:
  data-transmission-watch: && docker exec --user transmission transmission /opt/transmission/blocklist-update.sh

下载完成邮件通知

通过环境变量启用邮件通知，支持SMTP认证与加密：

必需变量

可选变量

Docker信息

暴露端口

挂载卷

安装与使用

安装方式

• 手动构建：CODE_TOKEN_8
• 自动拉取：CODE_TOKEN_9

基础运行

CODE_TOKEN_1

Docker Compose示例（带SMTP配置）

CODE_TOKEN_10`yaml services: transmission: image: turgon37/transmission environment: - SMTP_SERVER=10.0.0.1 - MAIL_FROM=*** - MAIL_TO=*** ports: - "127.0.0.1:51413:51413/tcp" - "127.0.0.1:51413:51413/udp" - "127.0.0.1:8001:9091/tcp" volumes: - data-transmission:/config - data-transmission-download:/downloads/complete - data-transmission-incomplete:/downloads/incomplete - data-transmission-watch:/watch volumes: data-transmission: data-transmission-download: data-transmission-incomplete: data-transmission-watch: