---
name: transmission-torrent-skill
description: Guía en español para instalar, configurar y usar transmission-daemon para descargar y disponibilizar (seedear) torrents de forma segura en Debian/Ubuntu.
---

# transmission-torrent-skill

## Alcance
Este skill cubre:

- Instalación de `transmission-daemon` en Debian/Ubuntu.
- Configuración básica y segura del servicio.
- Permisos y propiedad de carpetas de descarga.
- Uso de la interfaz web.
- Flujo para descargar torrents y disponibilizarlos (seeding).
- Recomendaciones de seguridad y operación responsable.

No cubre bypass de bloqueos, ocultación de actividad ilegal ni asesoría legal.

## Requisitos
- Debian o Ubuntu con acceso `sudo`.
- Conexión a internet para instalar paquetes.
- Usuario con permisos administrativos.

## Instalación paso a paso

### 1. Instalar Transmission daemon
```bash
sudo apt update
sudo apt install -y transmission-daemon
```

### 2. Preparar carpetas de trabajo
```bash
sudo mkdir -p /var/lib/transmission-daemon/downloads
sudo mkdir -p /var/lib/transmission-daemon/incomplete
```

### 3. Asignar permisos correctos
```bash
sudo chown -R debian-transmission:debian-transmission /var/lib/transmission-daemon
sudo chmod -R 750 /var/lib/transmission-daemon
```

### 4. Detener el servicio antes de editar configuración
```bash
sudo systemctl stop transmission-daemon
```

### 5. Editar configuración principal
Archivo típico:
`/etc/transmission-daemon/settings.json`

Ajustes recomendados (valores de ejemplo):
- `"download-dir": "/var/lib/transmission-daemon/downloads"`
- `"incomplete-dir": "/var/lib/transmission-daemon/incomplete"`
- `"incomplete-dir-enabled": true`
- `"rpc-bind-address": "127.0.0.1"` (más seguro; acceso local)
- `"rpc-enabled": true`
- `"rpc-authentication-required": true`
- `"rpc-username": "admin_torrent"`
- `"rpc-password": "cambia_esto_por_una_clave_fuerte"`
- `"rpc-whitelist-enabled": true`
- `"rpc-whitelist": "127.0.0.1,192.168.*.*"`
- `"umask": 2` (archivos 664 y directorios 775 en muchos casos)

Nota: al reiniciar, Transmission hashea la contraseña en `settings.json`. Es normal.

### 6. Iniciar y habilitar el servicio
```bash
sudo systemctl start transmission-daemon
sudo systemctl enable transmission-daemon
sudo systemctl status transmission-daemon --no-pager
```

## Uso de la Web UI

Si usas acceso local:
- URL: `http://127.0.0.1:9091/transmission/web/`

Si necesitas acceso desde otra máquina de tu red local:
1. Ajusta `rpc-bind-address` y `rpc-whitelist` con cuidado.
2. Restringe con firewall.
3. Evita exponer el puerto 9091 a internet pública.

Comprobación rápida de puerto:
```bash
sudo ss -tulpn | grep 9091 || true
```

## Descargar y disponibilizar (seeding)

Transmission no solo descarga: también comparte piezas con otros peers mientras descargas y después de completar.

### Flujo recomendado
1. Añade un `.torrent` o magnet desde la Web UI.
2. Verifica que descargue en `download-dir`.
3. Al completar, deja el torrent en estado **Seeding** para disponibilizarlo.
4. Mantén los archivos en su ubicación original; si los mueves fuera de Transmission, el seeding se rompe.

### Ajustes útiles para seeding responsable
En `settings.json` considera:
- `"seedRatioLimit": 1.5` (ejemplo: compartir 1.5x lo descargado)
- `"seedRatioLimited": true`
- `"idle-seeding-limit-enabled": true`
- `"idle-seeding-limit": 60` (minutos sin actividad antes de parar)
- `"speed-limit-up-enabled": true`
- `"speed-limit-up": 300` (KB/s de subida, ajusta según tu red)

Después de editar:
```bash
sudo systemctl restart transmission-daemon
```

### Nota sobre “publicar” torrents
Crear archivos `.torrent` para distribuir contenido propio es posible con herramientas externas, pero este skill se enfoca en operar el daemon de forma segura (descarga + seeding) y no en evadir controles o distribuir material no autorizado.

## Seguridad recomendada

- No expongas RPC (9091) públicamente sin proxy inverso, TLS y autenticación robusta.
- Limita IPs con `rpc-whitelist`.
- Usa contraseñas fuertes y únicas.
- Mantén el sistema actualizado:
```bash
sudo apt update && sudo apt upgrade -y
```
- Si abres el puerto P2P (por defecto 51413), hazlo de forma explícita y controlada.
- Revisa logs cuando haya fallos:
```bash
sudo journalctl -u transmission-daemon -n 100 --no-pager
```

## Solución de problemas

### Error: “403: Forbidden” en Web UI
- Verifica `rpc-whitelist` y `rpc-whitelist-enabled`.
- Confirma que la IP cliente está permitida.
- Reinicia servicio tras cambios:
```bash
sudo systemctl restart transmission-daemon
```

### Cambios en `settings.json` “desaparecen”
- Debes detener el servicio antes de editar:
```bash
sudo systemctl stop transmission-daemon
```
- Edita, guarda, y luego inicia nuevamente.

### Permisos denegados al descargar
- Revisa propietario y permisos de carpetas:
```bash
sudo chown -R debian-transmission:debian-transmission /var/lib/transmission-daemon
sudo chmod -R 750 /var/lib/transmission-daemon
```

### Servicio no inicia
- Revisa sintaxis JSON (comas/llaves).
- Ver logs:
```bash
sudo journalctl -u transmission-daemon -xe --no-pager
```

## Aviso legal y ético

Usa BitTorrent solo para contenido legal y autorizado (software libre, distribuciones Linux, datos públicos, material con licencia válida).  
Descargar o compartir contenido sin derechos puede violar leyes locales e internacionales y causar sanciones civiles o penales.  
Este skill promueve uso responsable, seguro y legal.