48 lines
2.6 KiB
Markdown
48 lines
2.6 KiB
Markdown
---
|
||
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=下载，共同服务于家庭媒体中心工作流）
|