Ingresas tu servidor autohospedado en ONLYOFFICE Documents, tocas Siguiente y la aplicación se queda cargando hasta que informa un tiempo de espera agotado. La misma cuenta puede seguir funcionando en un navegador de escritorio, lo que hace que el problema parezca un error de la aplicación. En la práctica, el tiempo de espera agotado generalmente significa que el teléfono no puede acceder a la URL del servicio que ingresaste, que la URL apunta al componente de ONLYOFFICE incorrecto o que la capa de red bloquea la solicitud.
Para empezar, identifica qué ofrece tu servidor. La aplicación móvil Documentos se conecta a un portal de ONLYOFFICE, como DocSpace o Workspace, o a una nube de terceros compatible, como Nextcloud, ownCloud u otro servicio WebDAV. ONLYOFFICE Docs, también conocido como Servidor de Documentos, es el servicio de edición que funciona con una plataforma de almacenamiento; no es automáticamente lo mismo que un portal de usuario o una cuenta de archivos WebDAV. Las descripciones generales de ONLYOFFICE para Android y iOS detallan los tipos de cuenta compatibles.
1. Confirme qué dirección debe usar la aplicación móvil.
No pegue la URL del servidor de documentos en todos los campos de conexión. Si sus archivos están almacenados en un portal DocSpace o Workspace autohospedado, utilice la dirección pública de dicho portal e inicie sesión con su cuenta. Si sus archivos están en Nextcloud u ownCloud, seleccione ese servicio en la aplicación e introduzca la dirección WebDAV del servidor de almacenamiento junto con sus credenciales. Para un servicio WebDAV genérico, seleccione la opción «Otro WebDAV» de la aplicación, si está disponible.
Para Nextcloud y ownCloud, la URL puede incluir una ruta más allá del dominio. Copie la dirección WebDAV que aparece en la configuración de la cuenta en la nube en lugar de intentar adivinar la ruta a partir de un tutorial antiguo. La guía de conexión móvil de ONLYOFFICE ofrece un ejemplo de Nextcloud e indica a los usuarios que peguen la URL completa, incluido el protocolo. Las instrucciones de la aplicación para Android también indican que se debe proporcionar la URL de conexión, el nombre de usuario y la contraseña para el almacenamiento WebDAV. Consulte la guía de integración oficial de Nextcloud o la de ownCloud para conocer el flujo de conexión actual.
- Utilice la URL del portal para acceder a una cuenta de portal, no la dirección del servicio de edición.
- Utilice la URL WebDAV completa para Nextcloud, ownCloud u otra cuenta WebDAV.
- Incluir
https://o http://exactamente como esté configurado en el servidor. - No agregue un sufijo no verificado como
/webdavo /remote.php/dav; copie la URL WebDAV que muestra el servidor.
2. Prueba la misma dirección fuera de la aplicación.
En el teléfono, abre la dirección en un navegador móvil. Para una URL de portal, el resultado esperado es una página de inicio de sesión o una redirección al portal. Para un punto final WebDAV, el navegador puede mostrar una solicitud de inicio de sesión, una respuesta de autorización o un simple error en lugar de un sitio web normal; lo importante es que responda con prontitud y que el navegador no indique que no se puede encontrar o acceder al host.
Repita la prueba una vez con Wi-Fi y otra con datos móviles. Si solo funciona en una red, probablemente la aplicación no sea el primer lugar donde buscar la solución. Revise el router, la VPN, el filtrado DNS, las restricciones del operador móvil o la política del firewall en la red que presenta el problema. Si falla en ambas, confirme que el nombre de host se resuelve públicamente y que el proxy inverso o el firewall reenvían el tráfico HTTPS del servicio al servidor backend correspondiente.
Un servidor accesible únicamente mediante una dirección privada, como por ejemplo, 192.168.x.xnormalmente no estará disponible cuando el teléfono se encuentre fuera de esa red local, a menos que el dispositivo esté conectado a través de una VPN u otro sistema seguro de acceso remoto. No exponga un servicio interno a internet pública simplemente para probar la aplicación; utilice el método de acceso remoto aprobado por la organización.
3. Verifica la URL, las redirecciones y el proxy inverso.
Compara la dirección en la aplicación con la dirección que funciona en el navegador, carácter por carácter. Busca subdirectorios faltantes, nombres de host antiguos, puertos incorrectos, rutas copiadas de otros servicios o redirecciones a nombres de host internos que el teléfono no puede resolver. Si tu servidor está detrás de un proxy inverso, la URL pública debe dirigir a la aplicación correcta, y la información del esquema de reenvío y del host debe coincidir con la dirección HTTPS a la que acceden los usuarios.
Cuando se publica un portal o servicio WebDAV bajo una subruta, verifique que el proxy conserve la ruta requerida y reenvíe las solicitudes a dicha aplicación. Una URL raíz que muestra una página de bienvenida del proxy inverso solo demuestra que el servidor web respondió; no demuestra que el portal o el punto final WebDAV de la aplicación se enrute correctamente. Si es posible, pruebe la URL exacta copiada en la aplicación móvil en lugar de solo la página de inicio del dominio.
Si la aplicación informa de un tiempo de espera agotado, pero el navegador accede rápidamente a la página de inicio de sesión, revise los registros de acceso al proxy y de errores al intentar una nueva conexión. Una respuesta 502 o 504 indica un tiempo de espera agotado del servidor o del proxy; una 404 suele sugerir una discrepancia en la ruta o el enrutamiento; una 401 o 403 indica que el servidor respondió, pero se denegó la autenticación o el acceso. Estos códigos de estado ayudan a acotar la investigación, pero su significado puede depender del proxy y del software en la nube que se encuentra delante de ONLYOFFICE.
4. Validar HTTPS y la cadena de certificados.
Los sistemas operativos móviles validan los certificados del servidor. Un certificado caducado, emitido para un nombre de host diferente, sin certificado intermedio o firmado por una autoridad en la que el dispositivo no confía puede impedir una conexión segura. Abra la dirección HTTPS exacta en el teléfono y revise cualquier advertencia de certificado del navegador. Compruebe también que la fecha y la hora del dispositivo sean correctas, ya que un reloj incorrecto puede hacer que un certificado válido aparezca como caducado o aún no válido.
Utilice un certificado emitido para el nombre de host público e instale la cadena de certificados completa en el servidor o proxy público. La documentación de ONLYOFFICE describe la configuración de HTTPS para el servidor de documentos; el certificado debe coincidir con la URL que utilizan los clientes. Evite deshabilitar la verificación de certificados como solución permanente. ONLYOFFICE describe esta opción como insegura en su documentación de integración, y una conexión que solo funciona tras omitir las comprobaciones de certificados aún requiere una configuración de certificado correcta.
5. Separe un problema de inicio de sesión en la aplicación de un problema de conexión con el editor.
Un usuario puede iniciar sesión correctamente en un portal y aun así tener problemas para abrir un documento. Se trata de conexiones independientes. La aplicación primero necesita acceder al almacenamiento o al portal. Al abrir un archivo, la integración también puede involucrar al servidor de documentos. Por lo tanto, un inicio de sesión móvil que funcione no demuestra que el servicio de edición pueda acceder al servidor de almacenamiento, ni que el servidor de almacenamiento pueda acceder al editor.
Si el tiempo de espera aparece solo después de abrir un archivo, pídale al administrador que pruebe la integración desde el servidor. Las guías de Nextcloud y ownCloud de ONLYOFFICE explican que las instalaciones ubicadas en redes restringidas pueden requerir la configuración de direcciones internas para las solicitudes del servidor de almacenamiento a ONLYOFFICE Docs y viceversa. Las direcciones públicas pueden funcionar en un navegador móvil, aunque el tráfico entre servidores siga fallando.
Como administrador, compruebe que ambos servicios resuelven los nombres de host configurados entre sí, que las reglas del firewall permiten el tráfico necesario y que el conector utiliza la misma clave secreta JWT configurada para el servidor de documentos cuando JWT está habilitado. No cambie la clave secreta ni deshabilite JWT al azar; primero compare los valores configurados utilizando la guía de integración oficial de su plataforma en la nube.
6. Vuelva a comprobar las credenciales y el estado de la aplicación.
Tras confirmar la accesibilidad y los certificados, verifique el nombre de usuario y la contraseña en la interfaz web del mismo portal o cuenta de almacenamiento. Un punto final WebDAV puede requerir las credenciales reales de la cuenta o una contraseña de aplicación, según la política de autenticación del servidor. Si la autenticación multifactor está habilitada, siga las instrucciones de ese servidor; no dé por sentado que la contraseña de inicio de sesión web habitual es aceptada por todas las implementaciones de WebDAV.
Actualiza ONLYOFFICE Documents desde la tienda de aplicaciones oficial, ciérrala y vuelve a abrirla, y luego intenta agregar la cuenta nuevamente. Si la cuenta se guardó previamente con una dirección incorrecta, elimina esa conexión guardada y crea una nueva con la URL verificada. Esto no elimina los archivos del servidor: al desconectar una cuenta en la nube desde la aplicación móvil, se elimina la entrada de conexión local, no el contenido del almacenamiento remoto. Antes de reinstalar la aplicación o borrar sus datos, asegúrate de guardar o respaldar todos los documentos locales no sincronizados.
7. Compruebe el servidor solo después de haber descartado las causas más sencillas.
Si la URL pública exacta agota el tiempo de espera en varios dispositivos y redes, es probable que el problema se encuentre en el servidor o en su ruta de red. Confirme que el portal, el servicio de almacenamiento, el proxy inverso y el servidor de documentos estén en funcionamiento. Para instalaciones de Docker, un administrador puede inspeccionar el estado del contenedor y los registros recientes con comandos como:
docker compose ps
docker compose logs --tail=100 <service-name>
Utilice los nombres de servicio reales del archivo Compose de la implementación; los nombres varían entre instalaciones. Compruebe si hay reinicios repetidos, fallos de DNS, errores de conexión con el servidor, agotamiento de recursos o problemas con la renovación de certificados. Evite reiniciar todos los componentes antes de capturar los registros, ya que un reinicio puede eliminar información útil sobre el fallo.
En el caso específico de un servidor de documentos, el centro de ayuda oficial documenta una /info/página que los administradores pueden usar para comprobar si el servicio está habilitado y accesible. Se trata de una herramienta de diagnóstico para el servidor de documentos, no un sustituto de la comprobación del portal o la dirección WebDAV introducida en la aplicación móvil. Consulte las instrucciones de ONLYOFFICE para la página de información del servidor de documentos .
Verifica la solución desde el teléfono.
Realice las comprobaciones en este orden: abra el portal o la URL WebDAV exacta en el navegador del teléfono; repita el proceso con Wi-Fi y datos móviles; añada la cuenta en ONLYOFFICE Docs con el tipo de servicio correspondiente; inicie sesión; explore una carpeta; y abra un documento de prueba pequeño. Si la navegación funciona pero la edición no, investigue la integración de ONLYOFFICE Docs en el servidor. Si tanto el navegador como la aplicación agotan el tiempo de espera, continúe con las comprobaciones de DNS, firewall, proxy y servidor en lugar de cambiar la contraseña repetidamente.
Un resultado satisfactorio consiste en un inicio de sesión estable y una lista de carpetas visible en la red donde se va a trabajar. Pruebe a abrir y guardar un archivo no crítico antes de confiar en la configuración para documentos importantes. Si el problema persiste, proporcione al administrador el tipo exacto de URL (portal, WebDAV o servidor de documentos), el sistema operativo del teléfono, la red utilizada, la fecha y hora, y cualquier registro de estado HTTP o de proxy. No envíe contraseñas, tokens de acceso ni el contenido de los documentos en una solicitud de soporte.