Tutoriales de VPS
Aria2 y AriaNg en VPS: RPC privado y descargas cloud (2026)
Instala Aria2 con Docker o systemd, protege AriaNg y JSON-RPC con HTTPS, valida actualizaciones de rastreadores y controla tráfico, caché cloud y recuperación de tareas.

Aria2 permite enviar descargas al VPS y dejarlas trabajando aunque cierres el ordenador. Gestiona enlaces HTTP/HTTPS, FTP, Metalink y BitTorrent; AriaNg aporta la interfaz web y JSON-RPC permite automatizar tareas. SFTP depende de cómo se haya compilado la versión instalada.
Para una colección centrada en torrents o rastreadores privados, consulta qBittorrent. Aria2 encaja mejor cuando combinas enlaces directos y automatización. Antes de empezar, comprueba las reglas del proveedor y descarga únicamente contenido que tengas derecho a obtener y distribuir.
| Aspecto | Aria2 | qBittorrent | Transmission |
|---|---|---|---|
| Protocolos | HTTP/HTTPS/FTP, Metalink, BT y magnet; SFTP según compilación | BT y magnet | BT y magnet |
| Interfaz | Cliente externo como AriaNg | WebUI integrada | WebUI integrada |
| Recursos | Ligero; depende de conexiones y caché | Depende del trabajo | Ligero; depende del trabajo |
| API | JSON-RPC | WebAPI | RPC |
| Enlaces directos | Sí | No como función de descarga general | No como función de descarga general |
| Rastreadores privados | Verifica reglas y compatibilidad | Suele ser una opción práctica | Verifica reglas |
| Uso habitual | Protocolos mixtos y automatización | Torrents | Servicio sencillo de torrents |
Estas diferencias orientan la elección; no constituyen mediciones de rendimiento. No añadas rastreadores públicos a torrents privados si sus reglas lo prohíben.
En Ubuntu/Debian:
sudo apt update
sudo apt install -y aria2
aria2c --version
El original propone 1.36 o posterior. Escoge un paquete mantenido con las funciones necesarias y revisa la versión y compilación: BitTorrent no aparece de repente en 1.36. Si necesitas SFTP, comprueba soporte y verificación de la clave del servidor. CentOS 7 requiere migración o una estrategia de paquetes mantenida por separado.
El ejemplo Docker usa una imagen comunitaria. Antes de arrancarla, reemplaza la clave, fija una versión revisada y cambia la publicación RPC a 127.0.0.1:6800:6800. Evalúa los puertos de pares 6881 por separado y ajusta propietario del directorio a PUID/PGID:
# docker-compose.yml
services:
aria2:
image: p3terx/aria2-pro
container_name: aria2
restart: unless-stopped
environment:
- PUID=1000
- PGID=1000
- UMASK_SET=022
- RPC_SECRET=换成你自己的长随机串
- RPC_PORT=6800
- DISK_CACHE=64M
- SPECIAL_MODE=move
volumes:
- ./aria2-config:/config
- /mnt/downloads:/downloads
ports:
- "6800:6800"
- "6881:6881"
- "6881:6881/udp"
RPC_SECRET debe ser una cadena aleatoria privada. AriaNg y los clientes API la necesitarán. Opciones propias de la imagen, como SPECIAL_MODE, requieren configuración y documentación de esa imagen; elimina acciones posteriores a la descarga que no hayas preparado.
docker compose up -d
docker compose logs -f aria2 # 看有没有报错
Crea /etc/aria2/aria2.conf si no existe. Ajusta el acceso RPC antes de iniciar: para proxy o túnel en el mismo host, escucha solo en loopback. Reemplaza secretos y el marcador de rastreadores, y protege los archivos de configuración y sesión:
# 下载目录
dir=/mnt/downloads
# RPC 配置 —— 让 AriaNg 和脚本能连进来
enable-rpc=true
rpc-listen-all=true
rpc-allow-origin-all=true
rpc-listen-port=6800
rpc-secret=换成你自己的长随机串
# 会话文件:重启后保住未完成的下载
save-session=/etc/aria2/aria2.session
input-file=/etc/aria2/aria2.session
save-session-interval=60
# 并发与分片(决定了下载速度)
continue=true
max-concurrent-downloads=5
max-connection-per-server=16
split=16
min-split-size=10M
# 磁盘
file-allocation=falloc
disk-cache=64M
# BT 相关
follow-torrent=true
enable-dht=true
bt-enable-lpd=true
bt-max-peers=128
seed-time=0
bt-tracker=(见下文,别留空)
# 日志
log=/var/log/aria2/aria2.log
log-level=warn
split y max-connection-per-server controlan fragmentos y conexiones por servidor. split=16/max-connection-per-server=16 son ejemplos, sin garantizar que agotes el ancho de banda. Un servidor puede limitar conexiones: prueba 5 o un valor inferior medido.
min-split-size=10M evita dividir archivos pequeños. Bajarlo a 1M puede provocar muchas conexiones y respuestas 403.
rpc-allow-origin-all=true permite orígenes web amplios. Úsalo solo si lo necesitas y el RPC está protegido; un proxy del mismo origen puede evitar abrir CORS innecesariamente.
seed-time=0 detiene la siembra al terminar. También puedes evaluar una política de 60 minutos, siempre respetando las obligaciones del rastreador privado y el tráfico de subida.
En file-allocation, falloc solicita preasignación compatible con el sistema de archivos y none la evita. falloc puede fallar o ser lento en un sistema incompatible; considera trunc. continue=true permite continuar cuando protocolo, servidor y archivos de control lo admiten; no obliga a un servidor HTTP a soportar rangos.
Rastreadores, semillas, pares, DHT y conectividad influyen en BitTorrent. Consulta una lista actual para torrents públicos autorizados:
# 下载最新的 tracker 列表并替换进配置
curl -s https://trackerslist.com/best_aria2.txt
Colócala tras bt-tracker=, separada por comas. No instales sin cambios el siguiente script diario del original: introduce texto de red sin validar en sed y reinicia incluso si la respuesta es incorrecta.
# /etc/cron.daily/aria2-tracker
#!/bin/bash
CONF=/etc/aria2/aria2.conf
NEW=$(curl -s https://trackerslist.com/best_aria2.txt)
sed -i "s|^bt-tracker=.*|bt-tracker=$NEW|" $CONF
systemctl restart aria2
Este patrón alternativo valida la respuesta, trata las URL como datos y sustituye el archivo de forma atómica. Requiere Python 3 y que la cuenta aria2 sea propietaria de su configuración:
#!/usr/bin/env python3
import os
import re
import stat
import tempfile
from pathlib import Path
from urllib.parse import urlsplit
from urllib.request import urlopen
config = Path('/etc/aria2/aria2.conf')
with urlopen('https://trackerslist.com/best_aria2.txt', timeout=20) as response:
raw = response.read(262145)
if len(raw) > 262144:
raise SystemExit('Tracker response exceeds limit; configuration unchanged.')
trackers = [value.strip() for value in raw.decode('utf-8').strip().split(',')]
if not 1 <= len(trackers) <= 500:
raise SystemExit('Invalid tracker count; configuration unchanged.')
for value in trackers:
parsed = urlsplit(value)
if (parsed.scheme not in ('http', 'https', 'udp') or not parsed.hostname
or parsed.username or parsed.password or any(c.isspace() for c in value)):
raise SystemExit('Invalid tracker URL; configuration unchanged.')
original = config.read_text()
if len(re.findall(r'^bt-tracker=.*$', original, re.M)) != 1:
raise SystemExit('Expected one bt-tracker setting; configuration unchanged.')
updated = re.sub(r'^bt-tracker=.*$', lambda _: 'bt-tracker=' + ','.join(trackers), original, flags=re.M)
mode = stat.S_IMODE(config.stat().st_mode)
descriptor, temporary = tempfile.mkstemp(dir=config.parent, prefix='.tracker-')
try:
with os.fdopen(descriptor, 'w') as handle:
handle.write(updated)
handle.flush()
os.fsync(handle.fileno())
os.chmod(temporary, mode)
os.replace(temporary, config)
finally:
if os.path.exists(temporary):
os.unlink(temporary)
Instala el script revisado en /usr/local/sbin/update-aria2-trackers, propiedad de root, ejecutable y sin permiso de escritura para aria2. Una tarea diaria administrada por root puede ejecutar runuser -u aria2 -- /usr/local/sbin/update-aria2-trackers y reiniciar el servicio solo si termina correctamente. Conserva una copia privada de la configuración y programa el reinicio evitando transferencias importantes. Validar formato no demuestra que cada rastreador sea fiable ni adecuado para un torrent privado.
El paquete no siempre crea el servicio que necesitas. Este ejemplo usa aria2:
# /etc/systemd/system/aria2.service
[Unit]
Description=Aria2 Download Service
After=network-online.target
Wants=network-online.target
[Service]
User=aria2
ExecStart=/usr/bin/aria2c --conf-path=/etc/aria2/aria2.conf
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target
# 建个专用用户和目录,别用 root 跑下载器
sudo useradd -r -s /usr/sbin/nologin aria2
sudo mkdir -p /etc/aria2 /var/log/aria2 /mnt/downloads
sudo touch /etc/aria2/aria2.session
sudo chown -R aria2:aria2 /etc/aria2 /var/log/aria2 /mnt/downloads
sudo systemctl daemon-reload
sudo systemctl enable --now aria2
sudo systemctl status aria2
No ejecutes el descargador como root. Comprueba permisos del secreto y de los directorios de descarga, sesiones y registros. Limita cualquier cambio recursivo de propietario a esos directorios. Configura rotación de logs y alertas de espacio.
AriaNg envía peticiones desde el navegador. Revisa su imagen y cambia el puerto publicado a 127.0.0.1:6880:6880 antes de iniciar:
ariang:
image: p3terx/ariang
container_name: ariang
restart: unless-stopped
ports:
- "6880:6880"
http://你的IP:6880 y http://你的IP:6800/jsonrpc muestran acceso directo, pero no son la configuración pública recomendada. localhost en el navegador es el ordenador del lector. Un túnel debe reenviar ambos puertos necesarios; con HTTPS utiliza el endpoint del proxy:
- Introduce la dirección RPC alcanzable desde el navegador.
- Guarda
RPC_SECRETde forma privada; una extensión o página con esa clave puede controlar tus descargas.
La clave no debe viajar por conexiones públicas sin cifrar. Caddy puede servir la interfaz y reenviar JSON-RPC:
aria.yourdomain.com {
reverse_proxy /jsonrpc localhost:6800
reverse_proxy localhost:6880
}
Los certificados automáticos necesitan DNS correcto y acceso para su desafío. HTTP-01 normalmente requiere 80 además de 443. Considera restricciones de identidad o IP para administración remota.
- En AriaNg configura
https://aria.yourdomain.com/jsonrpc. - Mantén privados 6800 y 6880; conserva SSH autorizado y la ruta de validación del certificado.
sudo ufw allow 443/tcp
sudo ufw deny 6800
sudo ufw deny 6880
UFW por sí solo no cierra necesariamente los puertos publicados por Docker. Primero enlázalos a loopback o elimina su publicación. Verifica exposición desde una red externa autorizada, incluyendo IPv6 y el backend de firewall. Consulta Caddy.
Pega un enlace directo, magnet o torrent autorizado en AriaNg. El VPS realiza la transferencia; puedes cerrar el dispositivo que envió la petición.
Aria2 Explorer y extensiones similares envían enlaces al RPC configurado. Revisa permisos y confianza antes de entregarles claves o cookies, y úsalas en dispositivos y cuentas que controles.
Estos ejemplos JSON-RPC 2.0 se ejecutan en el VPS, donde localhost alcanza el servicio privado. Sustituye el marcador sin divulgar la clave real:
# 添加一个下载任务
curl -s http://localhost:6800/jsonrpc \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": "1",
"method": "aria2.addUri",
"params": ["token:你的RPC_SECRET", ["https://example.com/file.zip"]]
}'
# 查看所有下载任务
curl -s http://localhost:6800/jsonrpc -H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":"1","method":"aria2.tellActive","params":["token:你的RPC_SECRET"]}'
# 全局暂停
curl -s http://localhost:6800/jsonrpc -H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":"1","method":"aria2.pauseAll","params":["token:你的RPC_SECRET"]}'
No omitas token:. Los métodos aria2.addUri, aria2.tellActive, aria2.tellStatus, aria2.pause/pauseAll, aria2.remove y aria2.getGlobalStat permiten añadir, consultar y gestionar tareas. Una automatización RSS necesita además evitar duplicados, gestionar credenciales, registrar fallos y recuperarse de ellos.
AriaNg se adapta al navegador móvil. Usa el endpoint HTTPS protegido y conserva la clave fuera de enlaces compartidos y capturas.
Puedes señalar un montaje rclone como destino:
dir=/mnt/cloud/downloads
Esto no elimina el uso de disco local. Los torrents pueden escribir en posiciones distintas y la caché VFS necesita espacio mientras se completa la subida.
- Revisa
--vfs-cache-mode fully la compatibilidad del proveedor con escrituras aleatorias. - Un archivo de 50G puede ocupar decenas de G de caché local. Vigila el disco y confirma que se haya subido antes de borrar la única copia.
Consulta montajes rclone, verifica df -h antes de tareas grandes y utiliza recuperación de disco lleno si hace falta.
rpc-secret autentica RPC, pero no cifra por sí mismo el transporte. Usa túnel privado o HTTPS protegido. rpc-listen-all=true amplía la escucha y requiere controles reales de red; la exposición a 0.0.0.0 no se vuelve segura por añadir una clave.
Limita la velocidad según tu plan, teniendo en cuenta descarga y siembra:
# 全局限速 10M/s
curl -s http://localhost:6800/jsonrpc -H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":"1","method":"aria2.changeGlobalOption","params":["token:你的RPC_SECRET",{"max-overall-download-limit":"10M"}]}'
También puedes fijar max-overall-download-limit=10M en configuración. Configura alertas de tráfico. Revisa condiciones de descarga y distribución del proveedor: una reclamación o un uso prohibido puede suspender la máquina.
AriaNg no conecta: comprueba systemctl status aria2, escucha de ss -lntp | grep 6800, endpoint alcanzable, proxy, firewall y secreto. Añade rpc-allow-origin-all=true únicamente si un origen permitido lo necesita.
Unauthorized: clave incorrecta o ausencia del prefijo token:.
BT sin velocidad: revisa bt-tracker, semillas, DHT, UDP y política del proveedor. No atribuyas un porcentaje universal de fallos a los rastreadores.
HTTP falla a mitad: verifica caducidad del enlace, rangos y límites. Baja split/max-connection-per-server a 1–2; si la cuenta requiere cookies, usa --header="Cookie: xxx" o --load-cookies con un archivo privado obtenido de tu propia sesión.
I/O saturado: revisa file-allocation/falloc, compatibilidad de preasignación y concurrencia. Consulta I/O de disco.
Tareas desaparecidas al reiniciar: save-session y input-file deben señalar el mismo archivo persistente y escribible. Conserva también datos y archivos de control de Aria2.
VPS de 1 núcleo/1 GB: puede servir con poca carga, sin garantizar rendimiento. disk-cache y los buffers consumen RAM. Como punto inicial reduce disk-cache a 16M, split a 8 y tareas simultáneas a 2, y mide.
-
rpc-secretes aleatorio, fuerte y privado. - RPC utiliza túnel privado o HTTPS protegido.
- 6800/6880 cerrados, también en Docker; SSH y desafíos siguen disponibles.
- Cuenta dedicada sin privilegios root.
-
continue=true,save-sessionyinput-filepermiten recuperación persistente. -
bt-trackerrevisado y actualizado con validación. -
max-overall-download-limitrespeta tráfico contratado, incluida subida. - Alertas de disco y tráfico mensual comprobadas.
- Montaje cloud con
vfs-cache-mode full, caché suficiente y subida confirmada.