---
title: "用Docker安装transmission"
type: source
tags: [docker, transmission, home-office]
date: 2026-04-14
---

## Source File
- [[raw/Home Office/用Docker安装transmission.md]]

## Summary (用中文描述)
- 核心主题：通过 Docker Compose 在 Home Server 部署 Transmission BT 下载服务
- 问题域：BT 下载服务容器化部署、Web UI 访问、下载目录管理
- 方法/机制：使用 linuxserver/transmission 官方镜像，通过 Docker Compose 定义端口映射、环境变量（PUID/PGID/TZ/认证）、卷挂载（配置目录+下载目录）实现一键部署
- 结论/价值：Transmission 是家庭媒体中心的核心组件，与 Jellyfin/Navidrome 共同构成"下载→整理→播放"媒体工作流

## Key Claims (用中文描述)
- LinuxServer.io 维护的 Transmission 镜像通过 docker-compose 一键部署
- 端口 9091 映射 Web UI 访问，端口 51413/UDP 映射 BT Peer 通信
- PUID/PGID 环境变量实现容器内进程以宿主机用户权限运行，避免文件权限问题
- TZ=Etc/UTC 配置容器时区，可根据需要调整为 Asia/Shanghai
- USER/PASS 环境变量启用 Web UI 认证，保护服务安全

## Key Quotes
> "image: lscr.io/linuxserver/transmission:latest" — LinuxServer.io 官方维护镜像
> "network_mode: bridge" — 采用桥接网络模式，与宿主机网络隔离但可访问
> "restart: unless-stopped" — 容器异常退出后自动重启策略

## Key Concepts
- [[Docker Compose]]：YAML 格式定义多容器应用的配置规范，本文档使用 version: '3.8'
- [[Docker Volume]]：持久化存储机制，/config 目录存储配置和下载状态，/downloads 目录挂载宿主下载目录
- [[PUID/PGID]]：Docker 容器进程以宿主机指定用户运行的环境变量，解决文件权限问题
- [[端口映射]]：-p host:container 格式将容器端口暴露到宿主机网络
- [[桥接网络]]：bridge 网络模式下容器共享宿主机网络栈，实现端口映射访问

## Key Entities
- [[LinuxServer.io]]：开源 Docker 镜像维护组织，transmission 镜像官方来源
- [[Transmission]]：开源 BT 下载客户端，Home Server 媒体中心核心组件
- [[Docker]]：容器化部署平台，本文档使用 docker-compose 管理服务生命周期

## Connections
- [[Transmission]] ← deployed_via ← [[Docker Compose]]
- [[Docker]] ← network_mode ← [[桥接网络]]
- [[Transmission]] ← upstream_image ← [[LinuxServer.io]]

## Contradictions
- 无冲突；与 [[用Docker安装jellyfin]] 形成互补（jellyfin=播放，transmission=下载，共同服务于家庭媒体中心工作流）