Auto-sync: 2026-04-22 04:02

wiki/sources/用docker安装transmission.md

@@ -0,0 +1,47 @@
+---
+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=下载，共同服务于家庭媒体中心工作流）