
Transmission Docker镜像是基于Alpine Linux构建的轻量级BT下载服务镜像,包含Transmission的CLI工具、守护进程和Web客户端,适用于个人或小型环境的BT下载需求。
镜像使用以下数据卷存储持久化数据:
/data:用于存储下载文件、配置文件及Transmission运行过程中的持久化数据。通过以下环境变量可配置镜像运行参数,表格列出变量名称、默认值及描述:
| 环境变量 | 默认值 | 描述 |
|---|---|---|
| UID | 1000 | 运行Transmission进程的用户ID |
| GID | 1000 | 运行Transmission进程的组ID |
| RPC_PORT | 9091 | RPC服务端口(Web客户端及CLI连接使用) |
| PEER_PORT | 51413 | 对等连接端口(BT下载的对等节点通信端口) |
| USERNAME | username | Web客户端登录用户名 |
| PASSWORD | $(hostname) | Web客户端登录密码,默认值为宿主机名 |
Docker命令行部署
使用docker run命令快速启动容器,示例如下:
bashdocker run \ -d \ --name transmission \ -p 8080:9091 \ -p 51413:51413 \ -v /your/data:/data \ -e USERNAME=username \ -e PASSWORD=password \ gists/transmission
参数说明:
-d:后台运行容器;--name transmission:指定容器名称为transmission;-p 8080:9091:将主机8080端口映射到容器RPC端口(Web客户端访问端口);-p 51413:51413:将主机51413端口映射到容器对等连接端口(BT节点通信端口);-v /your/data:/data:将主机目录/your/data挂载到容器/data卷,实现数据持久化;-e:设置环境变量,如USERNAME和PASSWORD用于Web客户端登录认证;gists/transmission:使用的Docker镜像名称。Docker Compose部署
通过docker-compose.yml配置文件部署,支持更复杂的服务编排,示例配置如下:
yamltransmission: image: gists/transmission ports: - "8080:9091" - "51413:51413" volumes: - /your/data:/data environment: - USERNAME=username - PASSWORD=password restart: always
配置说明:
image:指定使用的Docker镜像为gists/transmission;ports:映射主机端口到容器端口,8080对应Web客户端端口,51413对应BT对等连接端口;volumes:挂载主机目录/your/data到容器/data卷,确保数据持久化;environment:设置Web客户端登录的用户名和密码;restart: always:配置容器在退出时自动重启,保证服务持续运行。您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。





探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
docker search 限制
站内搜不到镜像
离线 save/load
插件要用 plugin install
WSL 拉取慢
安全与 digest
新手拉取配置
镜像合规机制
manifest unknown
no matching manifest(架构)
invalid tar header(解压)
TLS 证书失败
DNS 超时
域名连通性排查
410 Gone 排查
402 与流量用尽
401 认证失败
429 限流
D-Bus 凭证提示
413 与超大单层
来自真实用户的反馈,见证轩辕镜像的优质服务