Solución de Problemas

Problemas Comunes y Soluciones#

Un Recurso no se Monta#

Si la aplicación intenta montar un recurso compartido pero falla:

  1. Conectividad de Red: Asegúrate de estar conectado a la red correcta (o VPN) y de que el servidor esté accesible.
  2. Perfil de Autenticación: Verifica que el Perfil de Autenticación asignado contenga la contraseña correcta y actualizada.
  3. Tickets de Kerberos: Si usas un perfil de Kerberos, abre la Terminal de macOS y escribe klist para asegurarte de que tienes un Ticket-Granting Ticket (TGT) válido y no caducado.
  4. NetAuthSysAgent: NetAuthSysAgent es un proceso de macOS responsable de montar recursos de red y manejar la autorización de red. Puede mostrar cuadros de diálogo utilizando NetAuthAgent cuando sea necesario. Desafortunadamente, en muchas versiones de macOS ha habido un problema en el que NetAuthSysAgent a veces se queda atascado. Esto es evidente cuando no se ejecuta una solicitud de montaje. En este caso, la única solución es ejecutar killall NetAuthSysAgent.

Un recurso Kerberos en un espacio de nombres DFS muestra “invalid credentials”#

Si un recurso compartido Kerberos usa el nombre de dominio en lugar de un nombre de servidor (un espacio de nombres DFS basado en dominio como smb://example.com/shares), el montaje puede fallar con “invalid credentials” aunque el ticket Kerberos sea válido. En ese caso, macOS solicita un ticket para el propio nombre de dominio (cifs/example.com), que Active Directory normalmente no conoce. Puedes comprobarlo en Terminal: kgetcred cifs/example.com@EXAMPLE.COM indica que el servidor es desconocido.
Solución (macOS 26.5 o posterior, Macs no vinculados a Active Directory): Deja que macOS resuelva el espacio de nombres DFS a través de los controladores de dominio. Crea el archivo ~/Library/Preferences/nsmb.conf con el siguiente contenido y reinicia el Mac:

[default]
srv_lookup_enabled=yes

Los administradores pueden distribuir este ajuste para todos los usuarios como /etc/nsmb.conf (consulta Guía del administrador de TI (MDM)).

Error de Nombre Duplicado#

Si recibes un error de nombre duplicado al añadir un recurso, es que otro recurso compartido ya está usando ese nombre de carpeta en ~/Networkshares/. Solución: Usa la función de nombre personalizado de la Versión 4 para asignarle un nombre local único al nuevo recurso compartido.

Estado “Se Requiere Asignación de Perfil”#

Si un recurso muestra este estado en la interfaz, significa que le faltan credenciales. Solución:

  1. Abre Preferences (Preferencias) → Network Shares (Recursos de Red).
  2. Selecciona el recurso afectado y haz clic en editar.
  3. Asigna manualmente un Perfil de Autenticación desde el menú desplegable.
  4. Haz clic en Save Changes (Guardar Cambios).

Depuración Avanzada#

Para una solución de problemas informáticos profunda, Network Share Mounter registra su actividad de forma nativa en el sistema de registro unificado de macOS. Abre la app Console.app y filtra por el proceso NetworkShareMounter para ver los registros de conexión en tiempo real y los estados de error:
log stream --predicate "subsystem == 'de.fau.rrze.NetworkShareMounter'" --level debug

Ahora puedes enviar registros directamente desde la aplicación a los desarrolladores para solucionar problemas:

  1. Abre Settings (Ajustes) y selecciona General a la izquierda.
  2. Haz clic en Diagnostics (Diagnósticos) 5 veces seguidas.
  3. Aparecerá un nuevo botón que te permitirá enviar archivos de diagnóstico o registros a los desarrolladores del Network Share Mounter.

Los registros de componentes de macOS, como el cliente SMB, solo se pueden incluir con derechos de administrador. Sin ellos, solo se envían los registros del propio Network Share Mounter.