Tutoriais de VPS
Aria2 e AriaNg no VPS: RPC privado e downloads na nuvem (2026)
Instale Aria2 com Docker ou systemd, proteja AriaNg e JSON-RPC com HTTPS, valide atualizações de trackers e monitore tráfego, cache da nuvem e recuperação de tarefas.

Aria2 recebe tarefas no VPS e continua baixando mesmo depois que você fecha o computador. Ele atende HTTP/HTTPS, FTP, Metalink e BitTorrent; AriaNg fornece a interface web e JSON-RPC permite automação. O suporte a SFTP depende da compilação instalada.
Se o uso principal for torrent ou tracker privado, veja qBittorrent. Aria2 é útil quando você combina links diretos e envio por scripts. Confira as regras do provedor e os direitos sobre o conteúdo antes de baixar ou distribuir.
| Aspecto | Aria2 | qBittorrent | Transmission |
|---|---|---|---|
| Protocolos | HTTP/HTTPS/FTP, Metalink, BT e magnet; SFTP conforme compilação | BT e magnet | BT e magnet |
| Interface | Cliente separado, como AriaNg | WebUI integrada | WebUI integrada |
| Recursos | Leve; depende de conexões e cache | Depende da carga | Leve; depende da carga |
| API | JSON-RPC | WebAPI | RPC |
| Links diretos | Sim | Sem download genérico de links diretos | Sem download genérico de links diretos |
| Trackers privados | Confira regras e compatibilidade | Costuma ser uma escolha prática | Confira regras |
| Melhor uso | Protocolos mistos e automação | Torrents | Serviço simples de torrents |
Essa comparação orienta a escolha, sem prometer desempenho medido. Não adicione trackers públicos a torrents privados contra as regras do serviço.
No Ubuntu/Debian:
sudo apt update
sudo apt install -y aria2
aria2c --version
O original recomenda 1.36 ou posterior. Use um pacote mantido com os recursos necessários e confira versão e compilação: BitTorrent não surgiu apenas na 1.36. Para SFTP, verifique suporte e validação da chave do servidor. CentOS 7 exige migração ou outra estratégia de manutenção de pacotes.
O exemplo Docker usa uma imagem comunitária. Antes de iniciar, substitua o segredo, fixe uma versão revisada e altere a publicação RPC para 127.0.0.1:6800:6800. Avalie as portas de pares 6881 separadamente e ajuste o proprietário dos downloads 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 precisa ser uma sequência aleatória forte e privada. AriaNg e clientes da API usarão esse valor. Opções específicas da imagem, como SPECIAL_MODE, exigem documentação e configuração próprias; remova ações pós-download que você não preparou.
docker compose up -d
docker compose logs -f aria2 # 看有没有报错
Crie /etc/aria2/aria2.conf se necessário. Ajuste RPC antes do primeiro início: para proxy ou túnel no mesmo host, escute somente em loopback. Troque segredos e o marcador de trackers e proteja arquivos de configuração e sessão:
# 下载目录
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 e max-connection-per-server controlam fragmentação e conexões por servidor. split=16/max-connection-per-server=16 são exemplos, sem garantia de ocupar toda a banda. Alguns servidores limitam conexões; experimente 5 ou menos e acompanhe o resultado.
min-split-size=10M evita dividir arquivos muito pequenos. Reduzir para 1M pode criar conexões excessivas e causar respostas 403.
rpc-allow-origin-all=true permite origens web amplamente. Use só quando necessário, com RPC protegido; um proxy na mesma origem pode evitar CORS aberto.
seed-time=0 encerra a distribuição após concluir. Uma alternativa é avaliar 60 minutos, respeitando obrigações dos trackers privados e o orçamento de upload.
Em file-allocation, falloc solicita pré-alocação compatível com o filesystem, enquanto none não pré-aloca. falloc pode falhar ou ficar lento num filesystem incompatível; avalie trunc. continue=true permite retomar quando protocolo, servidor e arquivos de controle suportam; não faz um servidor HTTP aceitar intervalos que ele não oferece.
Trackers, seeds, peers, DHT e conectividade influenciam torrents. Confira uma lista atual para torrents públicos autorizados:
# 下载最新的 tracker 列表并替换进配置
curl -s https://trackerslist.com/best_aria2.txt
Inclua os valores após bt-tracker=, separados por vírgulas. Não instale o script diário abaixo sem alterações: ele insere texto de rede sem validar no sed e reinicia o serviço mesmo com resposta inválida.
# /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 padrão alternativo valida os dados e substitui o arquivo de forma atômica. Requer Python 3 e configuração pertencente à conta aria2:
#!/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)
Instale o script revisado em /usr/local/sbin/update-aria2-trackers, pertencente a root, executável e sem escrita para aria2. Uma tarefa diária gerenciada por root pode executar runuser -u aria2 -- /usr/local/sbin/update-aria2-trackers e reiniciar apenas se o script terminar com sucesso. Guarde um backup privado da configuração e agende reinícios fora de transferências importantes. Formato válido não garante que cada tracker seja confiável ou apropriado para torrent privado.
O pacote nem sempre cria o serviço necessário. O exemplo 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
Não rode o downloader como root. Confira segredo e permissões de diretórios de download, sessão e logs. Restrinja mudanças recursivas de proprietário a esses diretórios. Configure rotação de logs e alertas de espaço.
AriaNg envia solicitações pelo navegador. Revise a imagem e altere a publicação para 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 e http://你的IP:6800/jsonrpc ilustram acesso direto, mas não são a configuração pública recomendada. localhost no navegador é o computador do leitor. Um túnel precisa encaminhar ambas as portas necessárias; com HTTPS, use o endpoint do proxy:
- Defina o endereço RPC realmente acessível pelo navegador.
- Guarde
RPC_SECRETem privado: uma página ou extensão com esse segredo pode controlar downloads.
O segredo não deve atravessar conexões públicas sem criptografia. Caddy pode servir a interface e encaminhar JSON-RPC:
aria.yourdomain.com {
reverse_proxy /jsonrpc localhost:6800
reverse_proxy localhost:6880
}
Certificados automáticos dependem de DNS correto e portas de validação acessíveis. HTTP-01 normalmente precisa de 80 além de 443. Considere restrições de identidade ou IP na administração remota.
- Configure AriaNg com
https://aria.yourdomain.com/jsonrpc. - Mantenha 6800 e 6880 privados, preservando SSH autorizado e a validação do certificado.
sudo ufw allow 443/tcp
sudo ufw deny 6800
sudo ufw deny 6880
Essas regras UFW sozinhas não necessariamente fecham portas publicadas pelo Docker. Primeiro vincule a loopback ou remova a publicação. Confira exposição numa rede externa autorizada, incluindo IPv6 e o backend de firewall. Veja Caddy.
Cole um link direto, magnet ou torrent autorizado no AriaNg. O VPS faz a transferência; o dispositivo que enviou a tarefa pode ser fechado.
Aria2 Explorer e ferramentas semelhantes enviam links ao RPC configurado. Confira confiança e permissões antes de armazenar segredos ou cookies. Use em contas e dispositivos sob seu controle.
Estes exemplos JSON-RPC 2.0 rodam no VPS, onde localhost alcança o serviço privado. Substitua o marcador sem publicar o segredo 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"]}'
Não omita token:. Os métodos aria2.addUri, aria2.tellActive, aria2.tellStatus, aria2.pause/pauseAll, aria2.remove e aria2.getGlobalStat permitem adicionar, consultar e administrar tarefas. Uma automação RSS também precisa evitar duplicatas, administrar credenciais, registrar falhas e recuperar o trabalho.
AriaNg funciona no navegador móvel. Use HTTPS protegido e mantenha o segredo fora de links compartilhados e capturas de tela.
Um destino pode apontar para uma montagem rclone:
dir=/mnt/cloud/downloads
A montagem não elimina o consumo de disco local. Torrents podem escrever fora de sequência; o cache VFS ocupa espaço até o envio terminar.
- Revise
--vfs-cache-mode fulle a compatibilidade do provedor com escrita aleatória. - Um arquivo de 50G pode ocupar dezenas de G de cache. Monitore espaço e confirme envio remoto antes de apagar a única cópia.
Veja montagens rclone, confira df -h antes de tarefas grandes e use recuperação de disco cheio quando necessário.
rpc-secret autentica RPC, mas não criptografa o transporte sozinho. Use túnel privado ou HTTPS protegido. rpc-listen-all=true amplia a escuta e precisa de controles reais; escutar em 0.0.0.0 não fica seguro só por acrescentar um segredo.
Limite velocidade conforme seu plano e conte download e distribuição:
# 全局限速 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"}]}'
Você também pode fixar max-overall-download-limit=10M na configuração. Configure alertas de tráfego. Verifique termos do provedor e direitos de distribuição: reclamações ou uso proibido podem suspender o VPS.
AriaNg não conecta: confira systemctl status aria2, escuta de ss -lntp | grep 6800, endpoint acessível, proxy, firewall e segredo. Acrescente rpc-allow-origin-all=true somente se uma origem permitida precisar.
Unauthorized: segredo incorreto ou falta do prefixo token:.
BT sem velocidade: revise bt-tracker, seeds, DHT, UDP e política do provedor. Não atribua uma porcentagem universal de falhas aos trackers.
HTTP falha no meio: confira validade do link, suporte a intervalos e limites. Reduza split/max-connection-per-server para 1–2; use --header="Cookie: xxx" ou --load-cookies quando sua própria conta exigir cookies, protegendo o arquivo exportado.
I/O saturado: confira file-allocation/falloc, pré-alocação e concorrência. Veja I/O de disco.
Tarefas somem após reiniciar: save-session e input-file precisam apontar para o mesmo arquivo persistente e gravável. Preserve também dados e arquivos de controle do Aria2.
VPS de 1 núcleo/1 GB: pode servir com pouca carga, sem garantir throughput. disk-cache e buffers consomem RAM. Comece reduzindo disk-cache para 16M, split para 8 e tarefas para 2; meça antes de ampliar.
-
rpc-secreté forte, aleatório e privado. - RPC usa túnel privado ou HTTPS protegido.
- 6800/6880 fechados, inclusive no Docker; SSH e validação continuam disponíveis.
- Downloader com usuário dedicado, sem root.
-
continue=true,save-sessioneinput-filepermitem recuperação persistente. -
bt-trackerrevisado e atualizado com validação. -
max-overall-download-limitrespeita plano de tráfego, incluindo upload. - Alertas de disco e tráfego mensal testados.
- Montagem cloud com
vfs-cache-mode full, cache suficiente e envio confirmado.