Instalar qBittorrent WebUI en un VPS: Docker, HTTPS y seguridad (2026)

Poner qBittorrent en un VPS normalmente no se trata simplemente de "instalar un programa de descargas", sino de obtener disponibilidad las 24 horas, una IP pública fija, un WebUI remoto y conexiones de subida más estables. Lo que realmente determina la experiencia no es el número de núcleos de CPU, sino la capacidad y el rendimiento del disco, el tráfico mensual, la estrategia de puertos y si el proveedor permite tráfico BitTorrent a largo plazo.

Este artículo usa Ubuntu 24.04, Docker Compose y la imagen LinuxServer de qBittorrent para configurar el WebUI, HTTPS, los directorios de descarga, los puertos de escucha TCP/UDP, los permisos, los límites de velocidad, las copias de seguridad, las actualizaciones y la solución de problemas. Los ejemplos solo se aplican a imágenes Linux, software de código abierto, material de dominio público y archivos que tienes derecho a distribuir; no los uses para obtener o difundir contenido infractor, ni para eludir los términos de servicio de proveedores de VPS, redes o plataformas de contenido.

Para qué escenarios es adecuado qBittorrent en un VPS

qBittorrent puede ejecutarse sin entorno de escritorio y gestionar tareas a través del navegador, por lo que es adecuado para:

Distribución a largo plazo de tus propios espejos de código abierto, conjuntos de datos o vídeos públicos;
Descarga de ISO de Linux, datos públicos y material con licencia legal;
Proporcionar un nodo en línea estable para la distribución de archivos grandes dentro de un equipo;
Transferencia legal de archivos punto a punto entre tus propios dispositivos;
Entornos de prueba que necesitan una IP pública fija y capacidad de subida continua.

Los casos no adecuados incluyen:

Planes que prohíben explícitamente BitTorrent, P2P o tráfico elevado sostenido;
Un VPS con solo unas decenas de GB de disco de sistema pero con planes de almacenar grandes cantidades de archivos;
Tráfico mensual muy pequeño que genera altos cargos por exceso o suspensión directa al superarse;
Necesidad de almacenar datos privados pero con la intención de exponer el WebUI directamente a Internet;
Suponer que un "puerto de 1Gbps" significa que puedes saturarlo a largo plazo sin límite de tráfico.

qBittorrent en sí es gratuito, pero eso no significa que el ancho de banda, el almacenamiento, las copias de seguridad y el riesgo de derechos de autor también lo sean. Antes de comprar un VPS, lee la Política de Uso Aceptable, el proceso de reclamación de derechos de autor, las restricciones de puertos y las condiciones de facturación del tráfico.

Cómo elegir la configuración del VPS

qBittorrent consume pocos recursos en reposo, pero verificar archivos grandes, conectarse a muchos peers a la vez y escribir en disco a alta velocidad consume notablemente CPU, memoria y E/S.

Escala de uso	Configuración inicial sugerida	Recomendación de almacenamiento	Enfoque del tráfico
Pocas ISO de Linux, pruebas personales	1–2 vCPU, 2GB de RAM	SSD de 80–160GB	Desde 1TB al mes
Multitarea en línea a largo plazo	2–4 vCPU, 4GB de RAM	SSD/HDD de 500GB o más	3–10TB o un plan de alto tráfico explícito
Distribución continua de archivos grandes	4 vCPU, 8GB de RAM	Disco grande dedicado o almacenamiento en bloque de alta capacidad	Alto ancho de banda de subida, política de uso sostenido explícita
Nodo compartido de equipo	4 vCPU, 8GB o más	Disco de datos independiente con monitorización y snapshots	Alertas de presupuesto, límites de salida, auditoría de cumplimiento

Un uso sostenido de 10Mbps durante un mes natural da un volumen de transferencia teórico de aproximadamente 3.24TB; un uso sostenido de 100Mbps da aproximadamente 32.4TB. BitTorrent tiene tanto descarga como subida, y los proveedores pueden contar solo la salida o contar ambas direcciones, así que no puedes basarte solo en las estadísticas de descarga de qBittorrent.

La elección del disco es igual de importante:

NVMe/SSD es adecuado para muchos archivos pequeños, verificación frecuente y múltiples tareas concurrentes;
HDD es barato por capacidad, pero las lecturas/escrituras aleatorias y la subida simultánea de varios archivos son más propensas a esperas de E/S;
El almacenamiento en bloque se usa como un disco local y es adecuado como disco de datos independiente, pero confirma los precios de IOPS, rendimiento y snapshots;
El almacenamiento de objetos no tiene la semántica de escritura de un sistema de archivos normal y no es adecuado directamente como directorio de descarga activo de qBittorrent;
La desconexión de un disco de red puede hacer que los archivos desaparezcan temporalmente, y una configuración incorrecta de gestión automática puede conllevar riesgos de datos.

Tras la puesta en marcha, se recomienda usar nuestro tutorial de monitorización de tráfico y alertas de exceso de VPS y también configurar alertas de facturación del proveedor.

Estructura de despliegue y puertos de este artículo

Este artículo usa la siguiente estructura:

浏览器 -> HTTPS 443 -> Caddy -> 127.0.0.1:8080 -> qBittorrent WebUI
Peer    -> TCP/UDP 6881 -> Docker -> qBittorrent 下载监听端口

Planificación de puertos:

Puerto	Protocolo	Uso	Abierto a Internet
`22`	TCP	SSH del VPS	Mejor solo IP de administrador
`80/443`	TCP	Caddy y HTTPS	Abierto al acceder por dominio
`8080`	TCP	WebUI de qBittorrent	No abierto, solo enlazado a 127.0.0.1
`6881`	TCP + UDP	Conexiones entrantes de peer	Abierto, o cambiar a un puerto alto fijo

El WebUI y el puerto de peer no son lo mismo. El WebUI es solo para administradores, mientras que el puerto de peer se usa para conexiones de datos BitTorrent. Abrir 8080 a toda Internet es innecesario y aumenta el riesgo de fuerza bruta de contraseñas y vulnerabilidades web.

Instalar Docker Engine y Compose

Primero actualiza Ubuntu:

sudo apt update
sudo apt upgrade -y
sudo apt install -y ca-certificates curl gnupg ufw

En producción se recomienda instalar Docker Engine y el plugin Compose desde el repositorio oficial de Docker. Tras la instalación, comprueba:

docker version
docker compose version
sudo systemctl enable --now docker
sudo systemctl status docker --no-pager

Si aún no has establecido hábitos para las comprobaciones de estado de Compose, la rotación de logs, los secretos y la reversión, puedes leer primero la lista de verificación de configuración de producción de VPS Docker Compose.

Los comandos de este artículo asumen que el usuario actual puede ejecutar Docker. Añadir un usuario al grupo docker otorga control del host casi como root y no debe darse a cuentas no confiables.

Crear directorios de configuración y descarga

Crea el directorio del proyecto y un directorio de descarga independiente:

sudo install -d -m 750 /opt/qbittorrent
sudo install -d -m 750 /srv/qbittorrent/downloads
sudo install -d -m 750 /srv/qbittorrent/downloads/incomplete
sudo install -d -m 750 /srv/qbittorrent/downloads/complete
sudo chown -R "$(id -u):$(id -g)" /opt/qbittorrent /srv/qbittorrent
cd /opt/qbittorrent

Confirma el UID, GID y zona horaria reales:

id -u
id -g
timedatectl show --property=Timezone --value

Crea /opt/qbittorrent/.env y reemplaza el UID, GID y zona horaria del ejemplo con la salida real del comando anterior:

PUID=1000
PGID=1000
TZ=Asia/Shanghai
WEBUI_PORT=8080
TORRENTING_PORT=6881

Protege el archivo de entorno:

chmod 600 /opt/qbittorrent/.env

.env no guarda la contraseña del WebUI, pero sigue formando parte de la configuración del despliegue. No confirmes todo el directorio del proyecto directamente en un repositorio Git público.

Escribir el Docker Compose

Crea /opt/qbittorrent/compose.yaml:

services:
  qbittorrent:
    image: lscr.io/linuxserver/qbittorrent:latest
    container_name: qbittorrent
    environment:
      PUID: "${PUID}"
      PGID: "${PGID}"
      TZ: "${TZ}"
      WEBUI_PORT: "${WEBUI_PORT}"
      TORRENTING_PORT: "${TORRENTING_PORT}"
    volumes:
      - ./config:/config
      - /srv/qbittorrent/downloads:/downloads
    ports:
      - "127.0.0.1:${WEBUI_PORT}:${WEBUI_PORT}/tcp"
      - "${TORRENTING_PORT}:${TORRENTING_PORT}/tcp"
      - "${TORRENTING_PORT}:${TORRENTING_PORT}/udp"
    restart: unless-stopped
    stop_grace_period: 30s
    security_opt:
      - no-new-privileges:true
    logging:
      driver: json-file
      options:
        max-size: 10m
        max-file: "3"

Esta configuración tiene varios puntos clave:

8080 se mapea solo al 127.0.0.1 del host, por lo que no se puede acceder directamente desde Internet;
6881 mapea tanto TCP como UDP, y coincide con TORRENTING_PORT;
La configuración y los datos de descarga se colocan en directorios del host, por lo que eliminar el contenedor no elimina los archivos;
Se establecen límites de tamaño y cantidad de logs de Docker para evitar un crecimiento ilimitado;
no-new-privileges impide que los procesos del contenedor obtengan nuevos privilegios mediante mecanismos como setuid.

La documentación oficial de la imagen de LinuxServer enfatiza especialmente: al cambiar el puerto del WebUI, debes cambiar tanto el mapeo de puertos como WEBUI_PORT; al cambiar el puerto de peer, también debes cambiar los mapeos TCP y UDP y TORRENTING_PORT. Cambiar solo un lugar provocará problemas en el WebUI, en la comprobación CSRF o en las conexiones entrantes.

Primero valida el Compose:

cd /opt/qbittorrent
docker compose config
docker compose pull
docker compose up -d
docker compose ps

Obtener la contraseña temporal para el primer inicio de sesión

En el primer arranque, la imagen actual de LinuxServer muestra en los logs del contenedor una contraseña temporal para el usuario admin:

docker compose logs --tail=200 qbittorrent

También puedes filtrar solo los logs relevantes:

docker compose logs qbittorrent | grep -i -E 'password|webui'

A partir de qBittorrent 4.6.1, ya no deberías copiar la contraseña predeterminada fija adminadmin de tutoriales antiguos. La contraseña temporal aparece en los logs de arranque; tras iniciar sesión debes cambiar inmediatamente el nombre de usuario y establecer una contraseña aleatoria fuerte, de lo contrario el contenedor podría generar una nueva contraseña temporal tras reiniciarse.

En este punto, prueba en el propio VPS:

curl -I http://127.0.0.1:8080
docker compose logs --tail=100 qbittorrent

Una respuesta HTTP indica que el WebUI se ha iniciado. Como el puerto solo escucha en la dirección de loopback, acceder directamente a http://VPS-IP:8080 desde tu ordenador personal debería fallar; este es el resultado de seguridad esperado.

Completar la inicialización primero mediante un túnel SSH

En tu propio ordenador, ejecuta:

ssh -L 8080:127.0.0.1:8080 [email protected]

203.0.113.10 es una dirección de ejemplo de la documentación; sustitúyela por la IP real del VPS. Mantén la sesión SSH abierta y luego visita en el navegador:

http://127.0.0.1:8080

Tras iniciar sesión con la contraseña temporal de los logs, entra en la configuración del WebUI y completa:

Cambiar el nombre de usuario y la contraseña de administrador predeterminados;
Mantener activadas la protección CSRF y contra clickjacking;
No habilitar "omitir autenticación para la red local" ni la omisión de autenticación para subredes amplias;
Establecer la ruta de guardado predeterminada en /downloads/complete;
Establecer la ruta de tareas incompletas en /downloads/incomplete;
Confirmar que el puerto de escucha es 6881 y desactivar el puerto de inicio aleatorio;
Establecer velocidades globales de subida y bajada y números de tareas concurrentes razonables;
Guardar y cerrar sesión, y luego iniciar sesión de nuevo con la nueva cuenta.

A fecha de agosto de 2026, la versión estable actual de qBittorrent es 5.2.1. Las versiones seguirán actualizándose; antes de desplegar, consulta la página oficial de versiones de qBittorrent y la página oficial de noticias, y no confíes solo en el número de versión antiguo de la caché de la imagen.

Configurar HTTPS de dominio con Caddy

Primero apunta el registro A/AAAA de downloads.example.com al VPS. Este dominio es solo un ejemplo y debe sustituirse por tu propio dominio.

Añade al Caddyfile:

downloads.example.com {
    encode zstd gzip
    reverse_proxy 127.0.0.1:8080
}

Valida y recarga:

sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy
sudo systemctl status caddy --no-pager
sudo journalctl -u caddy -n 100 --no-pager

Abre HTTP y HTTPS:

sudo ufw allow 80/tcp comment 'Caddy HTTP'
sudo ufw allow 443/tcp comment 'Caddy HTTPS'

Para el proceso completo de instalación de Caddy, DNS, certificados automáticos y logs, consulta la guía completa de Caddy como proxy inverso en un VPS.

Tras iniciar sesión en el WebUI de qBittorrent, establece la lista blanca de dominios del WebUI en el dominio real y activa las cookies seguras. No desactives la Validación de Host Header solo para manejar Unauthorized o errores de Host header; en su lugar, comprueba si el dominio, el Host header del proxy inverso y la configuración del puerto son coherentes.

HTTPS solo protege la conexión de administración del navegador al VPS; el tráfico de peers sigue funcionando según el protocolo BitTorrent. No hagas proxy de 6881/TCP/UDP en Caddy o Cloudflare; un proxy inverso web normal no puede sustituir el puerto de escucha de peers.

Configurar UFW y los grupos de seguridad de la nube

Primero confirma que SSH no quedará bloqueado:

sudo ufw allow OpenSSH
sudo ufw allow 6881/tcp comment 'qBittorrent peer TCP'
sudo ufw allow 6881/udp comment 'qBittorrent peer UDP'
sudo ufw enable
sudo ufw status numbered

El grupo de seguridad de la plataforma en la nube también debe permitir el mismo puerto de peer TCP/UDP. No añadas una regla pública para 8080/tcp.

Verifica la escucha del host:

sudo ss -lntup | grep -E ':8080|:6881'
docker compose ps

Los resultados esperados son:

8080 aparece solo en 127.0.0.1;
6881 tiene mapeos tanto TCP como UDP;
Caddy escucha en el 80/443 público;
El puerto de escucha en la configuración del WebUI coincide con Compose.

Una vez abierto el puerto de peer entrante, qBittorrent tiene más probabilidades de convertirse en un nodo activo y aceptar conexiones, pero la velocidad sigue dependiendo de la disponibilidad de recursos, el número de peers, la ruta, el disco y la política de límites de velocidad. Un puerto abierto no significa que cualquier tarea alcance la velocidad máxima.

Configurar directorios de descarga, permisos y umbrales de disco

En el WebUI, usa rutas del contenedor:

/downloads/incomplete
/downloads/complete

No introduzcas la ruta /srv/qbittorrent/... del host, porque dentro del contenedor solo se ve el /downloads montado.

Comprueba los permisos:

cd /opt/qbittorrent
docker compose exec qbittorrent id
stat -c '%u:%g %a %n' config /srv/qbittorrent/downloads
touch /srv/qbittorrent/downloads/.write-test
rm /srv/qbittorrent/downloads/.write-test

Si aparece Permission denied en los logs del contenedor, primero compara el UID/GID del contenedor, el PUID/PGID en .env y el propietario del directorio del host; no uses chmod -R 777 directamente.

Mantén al menos un 10%–20% de espacio libre y establece umbrales de monitorización:

df -h /srv/qbittorrent/downloads
df -i /srv/qbittorrent/downloads
du -xhd1 /srv/qbittorrent/downloads | sort -h

Las tareas incompletas pueden ocupar tanto espacio preasignado como archivos temporales. Las reglas de eliminación automática también deben usarse con cuidado: eliminar una tarea de qBittorrent y eliminar archivos del disco son dos acciones diferentes, así que lee bien las opciones antes de confirmar.

Limitar velocidad, número de conexiones y tareas concurrentes

No dejes que qBittorrent sature el puerto del VPS a largo plazo. Saturar la subida aumenta la latencia interactiva y puede activar la limitación por uso justo del proveedor.

Puedes empezar con la siguiente configuración conservadora y ajustarla según la monitorización:

Elemento	Punto de partida para un VPS pequeño de 2GB de RAM	Punto de partida para un VPS de 4GB o más
Descargas activas simultáneas	2–3	5–10
Subidas activas simultáneas	3–5	10–20
Número de conexiones global	200–300	500–800
Conexiones por tarea	40–80	80–150
Límite de ancho de banda de subida	70%–80% de la salida medida	70%–85% de la salida medida

Estos son puntos de partida para la solución de problemas, no valores óptimos universales. La configuración razonable varía mucho entre recursos públicos populares, trackers privados, discos mecánicos, NVMe y distintas rutas.

Al limitar la velocidad, presta atención a las unidades: qBittorrent suele mostrar en KiB/s, mientras que los planes de VPS suelen usar Mbps. La conversión aproximada es:

10 Mbps ≈ 1.19 MiB/s
100 Mbps ≈ 11.92 MiB/s

El límite de subida no debe ser tan bajo que apenas se puedan enviar datos de protocolo, de lo contrario el rendimiento de descarga también podría verse afectado. Tras el ajuste, observa al menos un ciclo de negocio completo, no solo unos minutos de pico.

Actualizaciones y reversión

La etiqueta latest facilita seguir las versiones estables, pero antes de actualizar debes leer las notas de cambios, hacer copia de seguridad de la configuración y registrar el digest actual de la imagen:

cd /opt/qbittorrent
docker compose images
docker image inspect lscr.io/linuxserver/qbittorrent:latest \
  --format '{{index .RepoDigests 0}}'
docker compose logs --tail=100 qbittorrent

Haz copia de seguridad de la configuración y luego actualiza:

backup_stamp=$(date +%Y%m%d-%H%M%S)
docker compose stop qbittorrent
sudo tar -C /opt/qbittorrent -czf \
  "/root/qbittorrent-config-${backup_stamp}.tar.gz" \
  config compose.yaml .env
docker compose start qbittorrent

docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=200 qbittorrent

Tras actualizar, comprueba el inicio de sesión del WebUI, la lista de tareas, los directorios de descarga, los puertos de escucha y las conexiones de peers reales. No fuerces la terminación del contenedor mientras las tareas escriben mucho en disco.

Si la nueva imagen tiene problemas, puedes fijar temporalmente la imagen usando el digest registrado antes de la actualización, restaurar la copia de seguridad de la configuración y recrear el contenedor. La reversión de la imagen y la reversión de la configuración de datos son dos cosas distintas: cambiar solo a la imagen antigua puede no leer la configuración ya migrada por la nueva versión, por lo que la copia de seguridad debe hacerse antes de actualizar.

Qué datos hacer copia de seguridad

Prioriza la copia de seguridad de /opt/qbittorrent/config, que normalmente contiene ajustes, estado de tareas, categorías, etiquetas y datos de fastresume. Si hacer copia de seguridad de los archivos descargados depende de si se pueden volver a obtener y de si tienes derecho a almacenarlos y distribuirlos.

Capas sugeridas:

Directorio de configuración: copia de seguridad diaria, conservar varias versiones;
Archivos creados por ti o irremplazables: usar copias de seguridad independientes, no tratar la copia de siembra como única copia de seguridad;
Imágenes públicas que se pueden volver a obtener: puedes conservar solo el estado de las tareas y la información de verificación;
Directorios de descarga grandes: calcula primero el almacenamiento de copia de seguridad y los costes de salida antes de decidir la estrategia.

Tras la copia de seguridad, debes hacer un simulacro de restauración. Puedes consultar el tutorial de simulacro de copia de seguridad y restauración de VPS, pero no subas a almacenamiento público paquetes de configuración que contengan credenciales de trackers privados o historial de descargas.

Solución de problemas comunes

El WebUI no abre o Caddy devuelve 502

Comprueba en orden:

cd /opt/qbittorrent
docker compose ps
docker compose logs --tail=200 qbittorrent
curl -I http://127.0.0.1:8080
sudo systemctl status caddy --no-pager
sudo journalctl -u caddy -n 100 --no-pager
sudo ss -lntp | grep -E ':8080|:443'

Si 8080 local falla, el problema está en el contenedor, las variables de puerto o el arranque de la aplicación; si local funciona pero el dominio devuelve 502, el problema está más probablemente en Caddy, DNS o el destino del proxy.

El inicio de sesión muestra Unauthorized o la contraseña no es válida

Primero revisa la contraseña temporal en los logs de arranque:

docker compose logs qbittorrent | grep -i -E 'password|webui'

Si ya has establecido una contraseña formal pero aún no puedes iniciar sesión, comprueba:

Si el navegador ha guardado cookies antiguas;
Si el dominio está en los dominios permitidos del WebUI;
Si la Validación de Host Header rechaza la solicitud por un dominio no coincidente;
Si varios fallos han activado un bloqueo temporal de IP;
Si el directorio de configuración es escribible, lo que hace que los cambios de contraseña no persistan.

La Wiki oficial de qBittorrent proporciona un proceso de recuperación de contraseña para la versión sin escritorio. Antes de recuperar, detén el contenedor y haz copia de seguridad de la configuración; no elimines sin cuidado todo el directorio sin entender el formato de configuración.

Las tareas se quedan en Stalled o no hay conexiones entrantes

Comprueba cuatro capas:

Si el recurso aún tiene seeds/peers disponibles;
Si el puerto de escucha del WebUI es un 6881 fijo;
Si Docker mapea 6881/TCP y 6881/UDP;
Si UFW y el grupo de seguridad de la nube permiten el mismo puerto.

sudo ss -lntup | grep ':6881'
sudo ufw status numbered
docker compose port qbittorrent 6881/tcp
docker compose port qbittorrent 6881/udp

Una prueba de puerto superada no puede crear peers que no existen. Usar una ISO de Linux conocida, legal y activa como línea base es más fiable que juzgar la red del servidor con una tarea poco popular.

La velocidad de descarga es rápida, pero la E/S de disco está al 100%

Observa el host:

sudo apt install -y sysstat iotop
iostat -xz 1 10
sudo iotop -oPa
docker stats qbittorrent

Las causas comunes incluyen lecturas/escrituras aleatorias en disco mecánico, múltiples tareas verificando simultáneamente, archivos preasignados, configuración de caché irrazonable, latencia del disco de red o disco casi lleno. Primero reduce las tareas activas y el número de verificaciones simultáneas, luego decide si migrar a SSD/NVMe; no aumentes la caché a ciegas por encima de la memoria disponible.

El contenedor se reinicia continuamente o es OOM Kill

docker compose ps
docker inspect qbittorrent --format '{{.State.ExitCode}} {{.State.OOMKilled}}'
docker compose logs --tail=200 qbittorrent
sudo journalctl -k -n 200 --no-pager | grep -i -E 'oom|killed process'
free -h

Reduce el número de conexiones, las tareas activas simultáneas y las tareas de verificación, y deja memoria disponible para el sistema. Swap puede proporcionar un búfer a corto plazo pero no puede sustituir la memoria física suficiente; el swap frecuente durante descargas de alta velocidad amplificará el thrashing de disco.

El disco está lleno pero no se encuentran archivos grandes

df -h
df -i
sudo du -xhd1 /srv/qbittorrent /var/lib/docker | sort -h
sudo lsof +L1
docker system df

El espacio puede estar ocupado no solo por archivos completados, sino también por tareas incompletas, logs de contenedores, imágenes antiguas, archivos eliminados pero aún abiertos por procesos e inodos. No ejecutes directamente docker system prune --volumes que no entiendas; puede eliminar volúmenes que otras aplicaciones aún necesitan.

Lista de verificación de seguridad

Los términos de servicio del VPS permiten el uso legal de BitTorrent/P2P;
Solo se maneja contenido que tienes derecho a descargar, almacenar y distribuir;
El 8080 del WebUI está enlazado solo a 127.0.0.1;
La entrada de administración pública usa HTTPS de dominio;
Se ha reemplazado la contraseña temporal y se usa una contraseña fuerte independiente;
CSRF, clickjacking y Validación de Host Header permanecen activados;
No se ha configurado una subred amplia de omisión de autenticación;
El puerto de peer abre tanto TCP como UDP, y el puerto del WebUI no está abierto;
PUID, PGID y los permisos del directorio de descarga son coherentes, y no se usa 777;
Los logs de Docker tienen rotación configurada, y tanto el disco como los inodos tienen alertas;
La velocidad de subida, las tareas concurrentes y el número de conexiones no saturan el servidor a largo plazo;
El directorio de configuración está respaldado y la restauración se ha probado realmente;
Se registra el digest de la imagen antes de actualizar y se consultan las Notas de Versión oficiales;
Las direcciones de trackers privados, cookies, historial de descargas y copias de seguridad de configuración no se han filtrado.

Preguntas frecuentes

¿qBittorrent en un VPS necesita una IPv4 pública dedicada?

No es estrictamente necesario, pero una dirección pública dedicada y puertos TCP/UDP que se puedan abrir facilitan las conexiones entrantes. En un VPS con NAT compartido debes confirmar si se puede mapear un puerto de peer fijo; de lo contrario, normalmente solo puede actuar como nodo pasivo y la capacidad de conexión puede ser limitada.

¿Se puede ejecutar qBittorrent con 1GB de RAM?

Se puede iniciar con pocas tareas, pero múltiples conexiones, la verificación de archivos grandes y el propio Docker consumen memoria. Para uso a largo plazo, empieza con 2GB y limita el número de conexiones y tareas activas; los nodos de alta concurrencia necesitan 4GB o más.

¿Es necesario abrir el puerto 8080 del WebUI?

No. Este artículo lo enlaza a 127.0.0.1 y se accede a través de HTTPS mediante Caddy. Si solo lo usas tú, también puedes omitir por completo la configuración de dominio y abrir el WebUI solo mediante un túnel SSH.

¿Por qué la contraseña de los logs no es adminadmin?

A partir de qBittorrent 4.6.1, se genera una contraseña temporal del WebUI en el primer arranque. La imagen de LinuxServer imprime la contraseña temporal en los logs del contenedor. Tras iniciar sesión, debes establecer inmediatamente tu propia contraseña fuerte.

¿Por qué el puerto de peer debe abrir tanto TCP como UDP?

Los mecanismos de conexión y descubrimiento de qBittorrent pueden usar ambos protocolos. Mapear solo uno de ellos reduce los tipos de conexiones que se pueden establecer. Compose, UFW, el grupo de seguridad de la nube y el WebUI deben usar el mismo puerto fijo.

¿Se puede colocar el directorio de descarga en almacenamiento de objetos?

No se recomienda montar el almacenamiento de objetos directamente como directorio de descarga activo. BitTorrent realiza lecturas/escrituras aleatorias, verificación y renombrado de archivos, mientras que el almacenamiento de objetos no es un sistema de archivos POSIX normal. Un enfoque más seguro es escribir primero en almacenamiento local o en bloque, y archivar según el uso legal una vez completadas las tareas.

¿Puede Cloudflare hacer proxy del puerto 6881?

El proxy web normal de Cloudflare no puede sustituir puertos de peer TCP/UDP arbitrarios. El proxy de dominio solo es para HTTP/HTTPS del WebUI; el puerto de peer sigue necesitando que el VPS escuche directamente y que se permita en el firewall.

El criterio de un despliegue exitoso no es "el contenedor muestra Up", sino que el WebUI solo sea accesible desde una entrada protegida, la contraseña temporal se haya reemplazado, el puerto de peer sea alcanzable, los permisos de directorio sean correctos, el disco y el tráfico tengan alertas, las actualizaciones puedan revertirse y todo el contenido y uso de red cumplan con la autorización y los términos de servicio. Primero usa una ISO de Linux legal para una prueba de línea base de bajo riesgo, luego aumenta gradualmente las tareas y el número de conexiones.

Recursos oficiales

Escala de uso

Configuración inicial sugerida

Recomendación de almacenamiento

Enfoque del tráfico

Pocas ISO de Linux, pruebas personales

1–2 vCPU, 2GB de RAM

SSD de 80–160GB

Desde 1TB al mes

Multitarea en línea a largo plazo

2–4 vCPU, 4GB de RAM

SSD/HDD de 500GB o más

3–10TB o un plan de alto tráfico explícito

Distribución continua de archivos grandes

4 vCPU, 8GB de RAM

Disco grande dedicado o almacenamiento en bloque de alta capacidad

Alto ancho de banda de subida, política de uso sostenido explícita

Nodo compartido de equipo

4 vCPU, 8GB o más

Disco de datos independiente con monitorización y snapshots

Alertas de presupuesto, límites de salida, auditoría de cumplimiento

Puerto

Protocolo

Uso

Abierto a Internet

22

TCP

SSH del VPS

Mejor solo IP de administrador

80/443

TCP

Caddy y HTTPS

Abierto al acceder por dominio

8080

TCP

WebUI de qBittorrent

No abierto, solo enlazado a 127.0.0.1

6881

TCP + UDP

Conexiones entrantes de peer

Abierto, o cambiar a un puerto alto fijo

sudo install -d -m 750 /opt/qbittorrent sudo install -d -m 750 /srv/qbittorrent/downloads sudo install -d -m 750 /srv/qbittorrent/downloads/incomplete sudo install -d -m 750 /srv/qbittorrent/downloads/complete sudo chown -R "$(id -u):$(id -g)" /opt/qbittorrent /srv/qbittorrent cd /opt/qbittorrent

services: qbittorrent: image: lscr.io/linuxserver/qbittorrent:latest container_name: qbittorrent environment: PUID: "${PUID}" PGID: "${PGID}" TZ: "${TZ}" WEBUI_PORT: "${WEBUI_PORT}" TORRENTING_PORT: "${TORRENTING_PORT}" volumes: - ./config:/config - /srv/qbittorrent/downloads:/downloads ports: - "127.0.0.1:${WEBUI_PORT}:${WEBUI_PORT}/tcp" - "${TORRENTING_PORT}:${TORRENTING_PORT}/tcp" - "${TORRENTING_PORT}:${TORRENTING_PORT}/udp" restart: unless-stopped stop_grace_period: 30s security_opt: - no-new-privileges:true logging: driver: json-file options: max-size: 10m max-file: "3"

Elemento

Punto de partida para un VPS pequeño de 2GB de RAM

Punto de partida para un VPS de 4GB o más

Descargas activas simultáneas

2–3

5–10

Subidas activas simultáneas

3–5

10–20

Número de conexiones global

200–300

500–800

Conexiones por tarea

40–80

80–150

Límite de ancho de banda de subida

70%–80% de la salida medida

70%–85% de la salida medida

backup_stamp=$(date +%Y%m%d-%H%M%S) docker compose stop qbittorrent sudo tar -C /opt/qbittorrent -czf \ "/root/qbittorrent-config-${backup_stamp}.tar.gz" \ config compose.yaml .env docker compose start qbittorrent docker compose pull docker compose up -d docker compose ps docker compose logs --tail=200 qbittorrent

cd /opt/qbittorrent docker compose ps docker compose logs --tail=200 qbittorrent curl -I http://127.0.0.1:8080 sudo systemctl status caddy --no-pager sudo journalctl -u caddy -n 100 --no-pager sudo ss -lntp | grep -E ':8080|:443'

docker compose ps docker inspect qbittorrent --format '{{.State.ExitCode}} {{.State.OOMKilled}}' docker compose logs --tail=200 qbittorrent sudo journalctl -k -n 200 --no-pager | grep -i -E 'oom|killed process' free -h

Para qué escenarios es adecuado qBittorrent en un VPS

Cómo elegir la configuración del VPS

Estructura de despliegue y puertos de este artículo

Instalar Docker Engine y Compose

Crear directorios de configuración y descarga

Escribir el Docker Compose

Obtener la contraseña temporal para el primer inicio de sesión

Completar la inicialización primero mediante un túnel SSH

Configurar HTTPS de dominio con Caddy

Configurar UFW y los grupos de seguridad de la nube

Configurar directorios de descarga, permisos y umbrales de disco

Limitar velocidad, número de conexiones y tareas concurrentes

Actualizaciones y reversión

Qué datos hacer copia de seguridad

Solución de problemas comunes

El WebUI no abre o Caddy devuelve 502

El inicio de sesión muestra Unauthorized o la contraseña no es válida

Las tareas se quedan en Stalled o no hay conexiones entrantes

La velocidad de descarga es rápida, pero la E/S de disco está al 100%

El contenedor se reinicia continuamente o es OOM Kill

El disco está lleno pero no se encuentran archivos grandes

Lista de verificación de seguridad

Preguntas frecuentes

¿qBittorrent en un VPS necesita una IPv4 pública dedicada?

¿Se puede ejecutar qBittorrent con 1GB de RAM?

¿Es necesario abrir el puerto 8080 del WebUI?

¿Por qué la contraseña de los logs no es adminadmin?

¿Por qué el puerto de peer debe abrir tanto TCP como UDP?

¿Se puede colocar el directorio de descarga en almacenamiento de objetos?

¿Puede Cloudflare hacer proxy del puerto 6881?

Recursos oficiales

Cargando…

Para qué escenarios es adecuado qBittorrent en un VPS

Cómo elegir la configuración del VPS

Estructura de despliegue y puertos de este artículo

Instalar Docker Engine y Compose

Crear directorios de configuración y descarga

Escribir el Docker Compose

Obtener la contraseña temporal para el primer inicio de sesión

Completar la inicialización primero mediante un túnel SSH

Configurar HTTPS de dominio con Caddy

Configurar UFW y los grupos de seguridad de la nube

Configurar directorios de descarga, permisos y umbrales de disco

Limitar velocidad, número de conexiones y tareas concurrentes

Actualizaciones y reversión

Qué datos hacer copia de seguridad

Solución de problemas comunes

El WebUI no abre o Caddy devuelve 502

El inicio de sesión muestra Unauthorized o la contraseña no es válida

Las tareas se quedan en Stalled o no hay conexiones entrantes

La velocidad de descarga es rápida, pero la E/S de disco está al 100%

El contenedor se reinicia continuamente o es OOM Kill

El disco está lleno pero no se encuentran archivos grandes

Lista de verificación de seguridad

Preguntas frecuentes

¿qBittorrent en un VPS necesita una IPv4 pública dedicada?

¿Se puede ejecutar qBittorrent con 1GB de RAM?

¿Es necesario abrir el puerto 8080 del WebUI?

¿Por qué la contraseña de los logs no es adminadmin?

¿Por qué el puerto de peer debe abrir tanto TCP como UDP?

¿Se puede colocar el directorio de descarga en almacenamiento de objetos?

¿Puede Cloudflare hacer proxy del puerto 6881?

Recursos oficiales