
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
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:配置容器在退出时自动重启,保证服务持续运行。您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。




来自真实用户的反馈,见证轩辕镜像的优质服务