Tutoriales de VPS
RSSHub en VPS: Docker, navegador, caché y feeds privados (2026)
Despliega RSSHub estándar o con navegador, controla concurrencia y caché, protege feeds, mantiene cookies regionales autorizadas y vigila RSS válido.

RSSHub genera feeds mediante rutas compatibles para suscribirlos en un lector. Ayuda cuando falta un feed nativo, pero no es la única opción ni convierte cualquier web en una fuente fiable.
Bilibili, Xiaohongshu, Weibo y Zhihu del original son ejemplos del mercado chino con requisitos de cuenta, acceso y ruta. Mantén esas condiciones; otros lectores pueden usar rutas distintas sin abrir esas cuentas.
El endpoint público rsshub.app resulta práctico, pero:
- Límites compartidos pueden rechazar solicitudes frecuentes.
- El original señala problemas desde China continental; prueba desde tu red real.
- Las rutas pueden romperse cuando cambian HTML, API o autenticación.
Alojarlo permite controlar ajustes y carga compartida, pero no elimina límites, bloqueos ni mantenimiento de la plataforma origen.
| Producto | Función | Interfaz |
|---|---|---|
| RSSHub | Obtener datos compatibles y producir RSS | URL/API; sin lector completo |
| FreshRSS | Suscribir, organizar y marcar leído | Web/integraciones móviles |
Consulta FreshRSS. Puedes empezar con lector y fuentes nativas y añadir RSSHub. Ambos siguen dependiendo de sitios e infraestructura externos.
Solicitudes Node.js pueden ser ligeras; sesiones Chromium consumen cientos de MB y CPU. Tamaños originales de unos 500 MB para diygod/rsshub y 1.2 GB para diygod/rsshub:chromium-bundled varían por tag/arquitectura. La imagen estándar puede usar navegador externo; la variante Chromium lo integra.
| VPS inicial | Evaluación |
|---|---|
| 1 vCPU/512 MB | Rutas pequeñas sin navegador; vigila |
| 1 vCPU/1 GB | Navegador ajustado, posibles timeouts |
| 1 vCPU/2 GB | Inicio útil con concurrencia limitada |
| 2 vCPU/4 GB | Más margen para varias personas/rutas |
chromium-bundled puede atascarse con poca RAM. Swap/Zram ayuda frente a fallos abruptos, sin reemplazar memoria suficiente. Reserva unos 20 GB o más para imágenes/capas/datos y revisa limpieza Docker antes de borrar imágenes de rollback.
Prueba una ruta compatible sin 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
Accede a http://你的IP:1200 mediante túnel si configuras a distancia. Mantén 127.0.0.1 y establece acceso antes de publicar. Una instancia sin protección permite consumir tus recursos y cuota origen.
Prepara carpeta del proyecto y 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 quedan en red Docker sin puertos públicos. Revisa y fija imágenes mantenidas compatibles. browserless/chrome y MAX_CONCURRENT_SESSIONS corresponden a una generación concreta; versiones nuevas cambian opciones/endpoints. No cambies solo tag: sigue documentación correspondiente y comprueba cliente/servidor Puppeteer.
MAX_CONCURRENT_SESSIONS=2 limita sesiones. 2 en 2 GB y 3–4 en 4 GB son valores de prueba, sin capacidad garantizada; cuenta RSSHub, Redis y SO. Un fallo del navegador puede romper rutas aunque RSSHub continúe.
También puedes usar chromium-bundled y eliminar servicio/endpoint externo conforme a su configuración documentada. Menos servicios no garantiza menos RAM. Inicia el proyecto con Docker Compose en segundo plano, revisa logs y prueba un feed real.
| Opción | Predeterminado/ejemplo original | Función |
|---|---|---|
CACHE_TYPE | memory | memory/redis compatibles; comprueba cómo desactivar |
CACHE_EXPIRE | 300 segundos | Duración de respuesta de ruta |
CACHE_CONTENT_EXPIRE | 3600 segundos | Duración del contenido obtenido |
MEMORY_MAX | 256 | Capacidad en memoria |
TTL de 300 segundos no inicia descargas automáticamente cada cinco minutos. Dependen de peticiones del lector y fallos de caché; una ruta puede consultar origen varias veces. Veinte suscripciones no equivalen a veinte solicitudes periódicas exactas.
Prueba CACHE_EXPIRE de 600–1800 segundos cuando la demora sea aceptable, ajustando noticias y reglas del origen. Redis permite caché compartida; persistencia exige configuración propia, sin garantizarse por montar un volumen.
Define ACCESS_KEY fuerte y privado:
environment:
ACCESS_KEY: 你的长随机密钥
https://rss.example.com/bilibili/user/dynamic/123456?key=你的密钥
/ y /robots.txt pueden ser excepciones públicas de esa versión; verifica lista real. Las URL con ?key=... son credenciales bearer: protege exportaciones, logs y enlaces.
?code= permite derivar un valor con ruta y clave principal:
https://rss.example.com/some/route?code=md5哈希值
Comprueba tratamiento de ruta/query. MD5 produce un enlace bearer, no autenticación moderna de identidad; usa secreto fuerte y no atribuyas más restricciones que las implementadas.
Puedes añadir autenticación al proxy:
rss.example.com {
basicauth {
rss $2a$14$你的密码哈希
}
reverse_proxy 127.0.0.1:1200
}
Usa sintaxis de tu Caddy (actualmente basic_auth), reemplaza hash y valida. El lector necesita HTTP auth. Credenciales en URL pueden filtrarse por historial/logs; prefiere campos protegidos si existen:
https://用户名:密码@rss.example.com/路由?key=xxx
Si no admite la capa extra, utiliza acceso privado/clave compatible, sin dejar endpoint roto o abierto. Consulta Caddy.
Estos ejemplos requieren cuenta elegible y ruta actualmente compatible. Alojarlo evita ciertos límites compartidos, sin eliminar restricciones del origen.
Bilibili puede devolver {"code":-401,"message":"非法访问"} si exige autenticación. Para tu cuenta autorizada:
BILIBILI_COOKIE_你的UID=你的Cookie
Reemplaza UID por tu número de cuenta, sin espacios alrededor de igual, y conserva cookie privada. Xiaohongshu muestra:
XIAOHONGSHU_COOKIE="abRequestId=xxx;web_session=xxx"
Usa tu sesión autorizada. Cookies pueden durar días, semanas o meses según políticas: no hay duración fija garantizada. Sustituye caducadas y recrea servicio para aplicar entorno Compose nuevo.
Un proxy de red aprobado puede configurarse cuando corresponda:
PROXY_URI=socks5h://用户名:密码@代理地址:端口
Verifica compatibilidad de ruta y protege credenciales. Añade demora/coste, sin devolver autorización ni garantizar arreglo del bloqueo. Prefiere fuentes nativas/alternativas compatibles y nunca entrega cookies privadas a instancias públicas no fiables.
Combina instancia propia para rutas funcionales e instancia pública/externa fiable para feeds públicos adecuados, respetando restricciones y privacidad.
Cambia dominio manteniendo ruta compatible con tu versión:
# 公共实例的写法
https://rsshub.app/bilibili/user/dynamic/2267573
# 换成你自己的
https://rss.example.com/bilibili/user/dynamic/2267573?key=你的密钥
Añade la URL privada a FreshRSS. Busca rutas en docs.rsshub.app o https://rss.example.com/api/namespace?key=你的密钥 si la versión lo ofrece. Pueden cambiar entre versiones; otra instancia no garantiza todas las rutas.
Uptime Kuma puede vigilar RSS válido y frescura, además del estado HTTP. Una bienvenida/error 200 no demuestra actualizaciones. Evita monitores que omitan caché y sobrecarguen origen.
cd ~/rsshub
docker compose pull
docker compose up -d
Fija tag/digest revisado disponible; 2026-10-01 es ejemplo para comprobar, sin formato de tags universal. Revisa cambios incompatibles y dependencias del navegador. Guarda artefactos previos y ajustes/cookies privados y prueba tus feeds después. Caché se reconstruye; credenciales requieren recuperación.
Espera y 503: mira docker stats, logs de navegador, origen y MAX_CONCURRENT_SESSIONS. Baja concurrencia y verifica runtime antes de ampliar recursos.
Feed vacío: revisa estructura, autenticación y mantenimiento. Consulta releases; elimina cookies/claves privadas de cualquier informe.
Bilibili 401: comprueba cookie autorizada, caducidad y soporte de ruta; no es la única causa posible.
OOM: usa límites medidos, concurrencia y política Redis. docker compose restart reinicia temporalmente, sin resolver fugas o dimensionamiento insuficiente.
Disco de imágenes lleno: inspecciona antes de docker image prune -a; conserva rollback y no borres volúmenes/datos.
Fuentes regionales lentas: prueba origen-servidor y lector-servidor reales. Ejemplos China/extranjero no predicen toda latencia; elige instancia compatible alcanzable o feed nativo.
La ventaja es concentrar fuentes bajo tu control. Navegador, rutas cambiantes y cookies siguen teniendo coste operativo. Para unos blogs normales puede bastar RSS nativo y lector; añade RSSHub para una fuente compatible que necesites.