Tutoriais de VPS
RSSHub no VPS: Docker, navegador, cache e feeds privados (2026)
Instale RSSHub padrão ou com navegador, controle concorrência e cache, proteja feeds, mantenha cookies regionais autorizados e monitore RSS válido.

RSSHub gera feeds por rotas compatíveis para você assinar num leitor. Ajuda quando falta feed nativo, mas não é a única opção nem transforma qualquer site numa fonte confiável.
Bilibili, Xiaohongshu, Weibo e Zhihu do original são exemplos do mercado chinês com condições de conta, acesso e rota. Mantenha essas condições; outros leitores podem usar rotas diferentes sem criar essas contas.
O endpoint público rsshub.app é prático, mas:
- Limites compartilhados podem rejeitar requisições frequentes.
- O original registra problemas de acesso na China continental; teste da sua rede real.
- Rotas podem quebrar quando HTML, API ou autenticação mudam.
Hospedar permite controlar ajustes e carga compartilhada, mas não elimina limites, bloqueios ou manutenção da plataforma de origem.
| Produto | Função | Interface |
|---|---|---|
| RSSHub | Buscar dados compatíveis e produzir RSS | URL/API; sem leitor completo |
| FreshRSS | Assinar, organizar e marcar como lido | Web/integrações móveis |
Veja FreshRSS. Comece com leitor e feeds nativos e depois acrescente RSSHub. Ambos continuam dependendo de sites e infraestrutura externos.
Requisições Node.js podem ser leves; sessões Chromium usam centenas de MB e CPU. Tamanhos originais de cerca de 500 MB para diygod/rsshub e 1.2 GB para diygod/rsshub:chromium-bundled variam com tag/arquitetura. Imagem padrão pode usar navegador externo; variante Chromium inclui um.
| VPS inicial | Avaliação |
|---|---|
| 1 vCPU/512 MB | Rotas pequenas sem navegador; monitore |
| 1 vCPU/1 GB | Navegador apertado, possíveis timeouts |
| 1 vCPU/2 GB | Início útil com concorrência limitada |
| 2 vCPU/4 GB | Mais margem para pessoas/rotas |
chromium-bundled pode travar com pouca RAM. Swap/Zram ajuda contra falhas abruptas, sem substituir memória suficiente. Reserve cerca de 20 GB ou mais para imagens/camadas/dados e confira limpeza Docker antes de remover imagens de rollback.
Teste uma rota compatível sem navegador:
docker run -d \
--name rsshub \
--restart unless-stopped \
-p 127.0.0.1:1200:1200 \
-e NODE_ENV=production \
-e CACHE_EXPIRE=600 \
diygod/rsshub
Acesse http://你的IP:1200 por túnel se configurar remotamente. Mantenha 127.0.0.1 e estabeleça acesso antes de publicar. Instância aberta permite consumir seus recursos e cota da origem.
Prepare diretório e Compose:
services:
rsshub:
image: diygod/rsshub
container_name: rsshub
restart: unless-stopped
ports:
- "127.0.0.1:1200:1200"
environment:
NODE_ENV: production
CACHE_TYPE: redis
REDIS_URL: "redis://redis:6379/"
PUPPETEER_WS_ENDPOINT: "ws://browserless:3000"
CACHE_EXPIRE: 600
CACHE_CONTENT_EXPIRE: 3600
REQUEST_TIMEOUT: 10000
REQUEST_RETRY: 2
ACCESS_KEY: 换成一串长随机字符
depends_on:
- redis
- browserless
redis:
image: redis:alpine
restart: unless-stopped
volumes:
- redis-data:/data
browserless:
image: browserless/chrome
restart: unless-stopped
environment:
- MAX_CONCURRENT_SESSIONS=2
volumes:
redis-data:
Redis/navegador ficam na rede Docker sem portas públicas. Revise e fixe imagens mantidas compatíveis. browserless/chrome e MAX_CONCURRENT_SESSIONS pertencem a uma geração específica; imagens novas mudam opções/endpoints. Não troque apenas tag: siga documentação correspondente e confira cliente/servidor Puppeteer.
MAX_CONCURRENT_SESSIONS=2 limita sessões. 2 em 2 GB e 3–4 em 4 GB são valores de teste, sem capacidade garantida; conte RSSHub, Redis e SO. Falha no navegador pode quebrar rotas mesmo com RSSHub ativo.
Você também pode usar chromium-bundled e remover serviço/endpoint externo conforme documentação. Menos serviços não garante menos RAM. Inicie Compose em segundo plano, confira logs e teste feed real.
| Opção | Padrão/exemplo original | Função |
|---|---|---|
CACHE_TYPE | memory | memory/redis compatíveis; confira como desativar |
CACHE_EXPIRE | 300 segundos | Duração da resposta de rota |
CACHE_CONTENT_EXPIRE | 3600 segundos | Duração do conteúdo buscado |
MEMORY_MAX | 256 | Capacidade em memória |
TTL de 300 segundos não inicia buscas automaticamente a cada cinco minutos. Dependem de requisições do leitor e misses de cache; uma rota pode consultar origem várias vezes. Vinte assinaturas não equivalem a vinte requisições periódicas exatas.
Teste CACHE_EXPIRE em 600–1800 segundos quando atraso for aceitável, ajustando notícias e regras da origem. Redis permite cache compartilhado; persistência precisa de configuração, sem garantia apenas por montar volume.
Defina ACCESS_KEY forte e privado:
environment:
ACCESS_KEY: 你的长随机密钥
https://rss.example.com/bilibili/user/dynamic/123456?key=你的密钥
/ e /robots.txt podem ser exceções públicas dessa versão; confira a lista real. URLs com ?key=... são credenciais bearer: proteja exportações, logs e links.
?code= permite derivar valor da rota e segredo principal:
https://rss.example.com/some/route?code=md5哈希值
Confira tratamento de caminho/query. MD5 produz link bearer, não autenticação moderna de identidade; use segredo forte e não atribua restrições além das implementadas.
Pode acrescentar autenticação no proxy:
rss.example.com {
basicauth {
rss $2a$14$你的密码哈希
}
reverse_proxy 127.0.0.1:1200
}
Use sintaxe do Caddy instalado (atualmente basic_auth), troque hash e valide. Leitor precisa de HTTP auth. Credenciais em URL podem vazar por histórico/logs; prefira campos protegidos quando disponíveis:
https://用户名:密码@rss.example.com/路由?key=xxx
Se não suporta a camada extra, use acesso privado/chave compatível, sem endpoint quebrado ou aberto. Veja Caddy.
Estes exemplos exigem conta elegível e rota atualmente compatível. Hospedar evita alguns limites compartilhados, sem remover restrições da origem.
Bilibili pode retornar {"code":-401,"message":"非法访问"} se exigir autenticação. Para sua conta autorizada:
BILIBILI_COOKIE_你的UID=你的Cookie
Substitua UID pelo número da conta, sem espaços ao redor de igual, e guarde cookie privado. Xiaohongshu demonstra:
XIAOHONGSHU_COOKIE="abRequestId=xxx;web_session=xxx"
Use sua sessão autorizada. Cookies podem durar dias, semanas ou meses conforme políticas: não há validade fixa. Troque expirados e recrie o serviço para aplicar novo ambiente Compose.
Um proxy de rede aprovado pode ser configurado quando adequado:
PROXY_URI=socks5h://用户名:密码@代理地址:端口
Confira suporte da rota e proteja credenciais. Acrescenta atraso/custo, sem devolver autorização nem garantir correção do bloqueio. Prefira feeds nativos/alternativas compatíveis e nunca envie cookies privados a instâncias públicas não confiáveis.
Combine instância própria para rotas funcionais e instância pública/externa confiável para feeds públicos adequados, mantendo restrições e privacidade.
Troque domínio mantendo rota compatível com a versão:
# 公共实例的写法
https://rsshub.app/bilibili/user/dynamic/2267573
# 换成你自己的
https://rss.example.com/bilibili/user/dynamic/2267573?key=你的密钥
Adicione URL privada ao FreshRSS. Encontre rotas em docs.rsshub.app ou https://rss.example.com/api/namespace?key=你的密钥 quando a versão oferecer. Caminhos mudam: trocar instância não garante todas as rotas.
Uptime Kuma pode verificar RSS válido e atualização além do status HTTP. Página de boas-vindas/erro com 200 não comprova feed saudável. Evite monitores que ignorem cache e sobrecarreguem origem.
cd ~/rsshub
docker compose pull
docker compose up -d
Fixe tag/digest revisado disponível; 2026-10-01 é exemplo a conferir, sem formato universal de tags. Revise mudanças incompatíveis e dependências do navegador. Guarde artefatos anteriores e ajustes/cookies privados e teste seus feeds após atualizar. Cache se reconstrói; credenciais precisam de recuperação.
Espera e 503: confira docker stats, logs do navegador, origem e MAX_CONCURRENT_SESSIONS. Reduza concorrência e confira runtime antes de ampliar recursos.
Feed vazio: confira estrutura, autenticação e manutenção. Consulte releases; remova cookies/chaves privadas de relatórios.
Bilibili 401: confira cookie autorizado, validade e suporte da rota; não é a única causa possível.
OOM: use limites medidos, concorrência e política Redis. docker compose restart reinicia temporariamente, sem resolver vazamento ou dimensionamento insuficiente.
Disco cheio de imagens: inspecione antes de docker image prune -a; guarde rollback e não remova volumes/dados.
Fontes regionais lentas: teste origem-servidor e leitor-servidor reais. Exemplos China/exterior não preveem toda latência; escolha instância compatível acessível ou feed nativo.
O benefício é concentrar fontes sob seu controle. Navegador, rotas mutáveis e cookies continuam com custo operacional. Para poucos blogs, RSS nativo e leitor podem bastar; acrescente RSSHub para uma fonte compatível necessária.