BitBoxBridge permite que las billeteras web compatibles se comuniquen con tu BitBox desde un ordenador de sobremesa o portátil. No se ejecuta en móviles ni tabletas, y no la necesitas para usar la BitBoxApp normalmente.
Si falla una conexión que utiliza Bridge, comprueba primero si puedes abrir su página de estado local en el ordenador. Después, sigue el apartado que corresponda al resultado. Algunas billeteras web pueden conectarse sin Bridge, así que consulta la guía de tu billetera antes de instalarla o reinstalarla.
Antes de empezar
Abre en el ordenador la web o extensión de navegador oficial de la billetera.
- Cierra la BitBoxApp y las demás aplicaciones de billetera que puedan estar utilizando tu BitBox.
- Conecta tu BitBox por USB. Si utilizas un cable, asegúrate de que permita transferir datos. Siempre que sea posible, utiliza un puerto USB del ordenador en lugar de un concentrador o una base de conexión.
- Mantén activados el cortafuegos, el antivirus y las demás protecciones durante las comprobaciones iniciales. Más adelante se explica una prueba opcional y separada del antivirus.
No necesitas datos secretos de la billetera para resolver un problema de conexión
Nunca introduzcas palabras de recuperación, claves privadas, la contraseña del dispositivo ni una passphrase opcional en una web, ni subas una copia de seguridad de la billetera. Introduce los datos de desbloqueo únicamente en tu BitBox. No restablezcas el dispositivo ni restaures una copia de seguridad para resolver un problema de conexión. Detén el proceso si una web te pide que lo hagas.
Comprueba si puedes acceder a BitBoxBridge
- Abre una nueva pestaña del navegador en el ordenador donde esté instalada Bridge.
- Introduce http://127.0.0.1:8178/ en la barra de direcciones y abre la página. Esta dirección corresponde a tu propio ordenador.
- Busca una página sencilla que empiece por BitBoxBridge v seguido de un número de versión. También contiene entradas como
GET /api/info. La versión puede ser distinta de la del siguiente ejemplo.

Si aparece la página: puedes acceder a Bridge, pero esto todavía no confirma el acceso al dispositivo ni el permiso de la web. Omite el apartado siguiente y continúa en Si puedes acceder a Bridge, pero la billetera no se conecta.
Si la página no carga o aparece una página inesperada, continúa con el apartado siguiente. Anota el error exacto del navegador en lugar de dar por hecho qué programa lo ha causado.
Si la página de estado local no carga
- Comprueba que hayas introducido la dirección completa, incluidos
http://y:8178. Prueba también http://localhost:8178/. Anota si una de las dos direcciones funciona y la otra no. - Si Bridge no está instalada, sigue la guía oficial de instalación de BitBoxBridge. Descárgala únicamente desde la página oficial de descargas de BitBox o desde las versiones publicadas por BitBoxSwiss en GitHub. Si la instalación falla, consulta el apartado sobre errores de instalación más abajo.
- Si Bridge ya está instalada, guarda tu trabajo y reinicia el ordenador. Bridge suele iniciarse como servicio en segundo plano. Después del reinicio, deja cerradas las aplicaciones de billetera y vuelve a abrir la dirección de estado local.
Si ahora aparece la página, continúa con las comprobaciones de conexión de la billetera web. Si sigue sin aparecer, busca una notificación concreta del software de seguridad o un error del navegador, como se explica más abajo. Reinstalar Bridge repetidamente no permite identificar la causa de una conexión bloqueada.
Si la instalación se interrumpió o Bridge se eliminó, puede ser adecuado reinstalarla. Sigue la guía de instalación. Si antes necesitas eliminar una instalación existente, pide al equipo de soporte los pasos para tu sistema operativo. Si no sabes si el servicio está instalado o bloqueado, comunica al equipo de soporte el resultado de la comprobación de la página de estado antes de eliminar software.
Si puedes acceder a Bridge, pero la billetera no se conecta
- Vuelve a la web o extensión oficial de la billetera y utiliza su opción de conexión con una billetera de hardware. Mantén cerradas la BitBoxApp y las demás aplicaciones de billetera.
- Desconecta y vuelve a conectar tu BitBox, e inicia de nuevo la conexión desde la billetera. Desbloquea la BitBox en el propio dispositivo cuando te lo pida.
- Si aparece un código de emparejamiento, compara el código completo de la BitBox con el de la aplicación de billetera. Confirma únicamente si coinciden; si son distintos, rechaza el emparejamiento y detén el proceso.
- Comprueba si hay una solicitud de permiso de Bridge, como se explica en el próximo apartado. No aparece en todas las conexiones.
Si la billetera sigue sin encontrar el dispositivo, comprueba si el sistema operativo lo detecta por USB. Utiliza el apartado de detección del dispositivo de la guía para macOS, Windows o Linux. Mantén activadas las protecciones de seguridad durante estas comprobaciones.
- El sistema operativo no detecta la BitBox: prueba otro cable que permita transferir datos u otro puerto USB, según corresponda. Si sigue sin detectarla, comunica este resultado al equipo de soporte. Que la página de estado de Bridge funcione no resuelve por sí solo un problema de detección USB.
- El sistema operativo detecta la BitBox, pero la billetera no: anota cualquier error de la billetera y continúa con las comprobaciones de permisos y bloqueos. La detección del dispositivo no demuestra por sí sola que la billetera pueda acceder a él.
Comprueba una solicitud de permiso de Bridge
Bridge puede preguntarte si permites que una web se conecte a tu BitBox. Este permiso es distinto de comparar un código de emparejamiento en el dispositivo o de aprobar una transacción.
La solicitud muestra el nombre de host de la web, por ejemplo, Allow [website host] to connect to your BitBox?. Aprueba únicamente una conexión que acabes de iniciar y solo si el nombre de host mostrado coincide con la web oficial del servicio que querías utilizar. Rechaza cualquier solicitud desconocida o inesperada y detén la conexión.
- Windows con Bridge 1.6.1: la solicitud aparece en un cuadro de diálogo de Windows titulado BitBoxBridge, con opciones de sí o no. El tiempo para responder es limitado. Si no respondiste a tiempo, vuelve a iniciar la conexión desde la billetera para solicitar el permiso otra vez.
- macOS y Linux con Bridge 1.6.0: la solicitud se abre en una página local del navegador, con los botones Accept y Reject. Comprueba el nombre de host que solicita la conexión antes de seleccionar Accept.
Algunos hosts ya están permitidos, por lo que la ausencia de una solicitud no indica por sí sola un fallo. Si rechazas una solicitud, la billetera no recibe ese permiso. Si una solicitud que esperabas no aparece y la conexión sigue bloqueada, comunica al equipo de soporte tu versión de Bridge y tu sistema operativo en lugar de desactivar protecciones para forzar la conexión.
Comprueba si el software de seguridad o el navegador bloquean la conexión
Revisa primero los permisos del sitio en el navegador y las notificaciones o el historial de bloqueos del software de seguridad. Busca una entrada que identifique expresamente Bridge, la web de la billetera o 127.0.0.1:8178 y anota el mensaje exacto. Que una conexión falle no demuestra por sí solo que la causa sea una VPN, el cortafuegos o el antivirus.
Si un programa identifica un bloqueo, consulta al equipo de soporte o al proveedor del software para determinar si conviene conceder un permiso limitado a esa conexión. No crees una exclusión general ni permitas una web desconocida. Si tu empresa u organización gestiona el ordenador, pide a quien administre el sistema que investigue la causa en lugar de cambiar las protecciones por tu cuenta.
Opcional: comprueba si el antivirus afecta a la página de estado local
Si la página local sigue sin abrirse después de comprobar las direcciones y reiniciar el ordenador, y las notificaciones no explican el motivo, una prueba breve del antivirus puede aportar otra pista. Hazla únicamente en un ordenador propio y de confianza, con Bridge ya instalada desde una fuente oficial. No hagas esta prueba si el antivirus informa de una amenaza o ha puesto el instalador en cuarentena. Si la página local ya se abre, esta prueba no sirve para diagnosticar problemas de USB ni de permisos de la billetera web.
Antes de empezar, consulta las instrucciones del proveedor del antivirus y asegúrate de saber cómo pausar y volver a activar la protección que vas a comprobar. Si tienes dudas, pide ayuda al equipo de soporte o al proveedor en lugar de continuar.
- Desconecta tu BitBox. Cierra las aplicaciones de billetera, las demás aplicaciones que no necesites y las otras pestañas del navegador. Deja abierta solo la pestaña de la página de estado local.
- Pausa brevemente solo la protección del antivirus que estés investigando. No cambies el cortafuegos, la VPN ni las demás capas de protección. No desinstales el antivirus ni eludas su protección contra modificaciones.
- Recarga
http://127.0.0.1:8178/una vez y anota si aparece la página de estado de Bridge. Durante la prueba, no visites otras webs, no descargues ni instales archivos, no abras una billetera, no introduzcas datos secretos ni firmes nada. - Vuelve a activar la protección del antivirus inmediatamente, tanto si la página ha cargado como si no, y comprueba que esté activada. Recarga la misma dirección una vez más con la protección activada y anota el resultado.
- La página solo se abre mientras la protección está pausada: esto apunta a una interferencia de esa protección, pero no demuestra que una detección sea un falso positivo. Mantén la protección activada y comunica los resultados al equipo de soporte o al proveedor del antivirus para que investiguen una solución concreta.
- El resultado no cambia: la prueba no ha identificado esa protección como la causa del fallo de acceso a la página local. Déjala activada e informa al equipo de soporte de que el resultado no ha cambiado. Esto no descarta un bloqueo en otra parte de la conexión.
Que la conexión funcione con la protección desactivada es un resultado de diagnóstico, no una solución permanente. Vuelve a activar cualquier protección que hubieras desactivado antes de continuar.
Si la instalación falla, incluido el error «The pipe is being closed»
Este error no demuestra por sí solo que el antivirus sea la causa. Cierra el instalador que ha fallado y anota el error exacto y en qué momento apareció. Comprueba que obtuviste el instalador de la página oficial de descargas de BitBox y elegiste el paquete para tu sistema operativo.
Mantén activados el antivirus y las demás protecciones. Si detectan una amenaza o ponen el instalador en cuarentena, no ignores el aviso ni añadas una exclusión para completar la instalación. Contacta con el equipo de soporte e indica el nombre del archivo de instalación, el sistema operativo, el error y cualquier notificación del programa de seguridad. Si no aparece ninguna notificación, pero la instalación sigue fallando, envía los mismos datos sin dar por hecho cuál es la causa.
Cómo saber si la conexión funciona y cuándo pedir ayuda
La conexión se ha establecido cuando finaliza el proceso de conexión con la billetera de hardware y la billetera muestra la cuenta que querías abrir. La página de estado de Bridge no basta para confirmarlo. No necesitas enviar fondos ni firmar una transacción para probar la conexión. Antes de utilizar una dirección para un pago, sigue el procedimiento de tu billetera para verificar la dirección de recepción en tu BitBox.
Si la conexión sigue fallando o los códigos de emparejamiento no coinciden, contacta con el soporte de BitBox. Incluye los datos que conozcas; no necesitas completar todas las comprobaciones antes de pedir ayuda:
- Tu sistema operativo y su versión, el navegador y su versión, y la web o extensión de billetera que utilizas.
- El modelo de BitBox y la versión del firmware, si los conoces.
- La versión de Bridge que muestra la página local, o que no carga ninguna de las dos direcciones locales.
- El paso que falla, el error exacto, si el sistema operativo detecta la BitBox y si apareció una solicitud de permiso.
- Cualquier notificación concreta del programa de seguridad y las comprobaciones que ya hayas realizado.
Nunca envíes palabras de recuperación, copias de seguridad de la billetera, claves privadas, contraseñas ni passphrases. Antes de compartir una captura, elimina la información de cuentas que no sea necesaria y cualquier otro dato privado.