BookinglyTech News
Infraestructura

Bookbridge permite sincronizar Audiobookshelf con Koreader a través de Tailscale

El motor de sincronización Bookbridge, alojado de forma local, facilita la transferencia de audiolibros entre Audiobookshelf y el lector Koreader, aunque algunos usuarios reportan errores de servidor en configuraciones con Tailscale.

2 min de lecturar/selfhosted0 vistas

Problema de conexión al usar Bookbridge con Koreader

El usuario /u/boochwinder reporta que, al intentar sincronizar su Kindle 8ª generación con un servidor que aloja Audiobookshelf (ABS) y Bookbridge, se produce un error de "unknown server". El servidor no está en la red doméstica, por lo que se recurre a Tailscale para crear una VPN y acceder a la IP pública del host.

Configuración típica

  1. ABS y Bookbridge: ambos se ejecutan en un contenedor Docker o en un host Linux. Bookbridge expone un endpoint REST que expone la lista de audiolibros y los metadatos.
  2. Koreader: en el Kindle, se abre la sección Progress sync y se ingresa la IP del servidor y las credenciales generadas por Bookbridge.
  3. Tailscale: se instala en el Kindle y se conecta al mesh de la red. Se intenta usar el modo proxy de Tailscale para que las peticiones viajen por el túnel.

Posibles causas del error

  • Firewall o reglas de iptables que bloquean el puerto 5000/8000 que expone Bookbridge.
  • CORS no configurado correctamente, pues el Kindle no reconoce la IP pública como origen permitido.
  • Versión de Bookbridge: el repo https://github.com/cporcellijr/bookbridge tiene versiones beta que no gestionan bien los encabezados de autenticación.
  • Tailscale proxy mode: requiere que el cliente soporte el protocolo SOCKS5; el Kindle no lo implementa nativamente.

Soluciones probadas

  • Cambiar el puerto de exposición a 8080 y añadir la regla -p 8080:8080 en Docker.
  • Añadir la IP del Kindle al allowlist en el archivo config.yaml de Bookbridge.
  • Desactivar el proxy de Tailscale y usar el cliente tailscale up --authkey <clave> directamente.
  • Actualizar a la última versión v0.3.2 del repositorio, que corrige la serialización de la respuesta JSON.

Qué sigue

Los administradores que usan ABS y Bookbridge con dispositivos Kindle deben revisar las reglas de red y la configuración de CORS. Si el error persiste, abrir un issue en el repositorio oficial. El proyecto sigue activo y la comunidad aporta mejoras continuas.

Historias Relacionadas