Integración domótica Seafile, gratuita y de código abierto
Supervise su servidor Seafile: almacenamiento, cuota, bibliotecas y disponibilidad.
Publicado por prohand
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.3.0
- ★ 0
Esta integración conecta Gladys con su servidor Seafile (edición Community o Professional): cuánto almacenamiento usa su cuenta, su cuota, sus bibliotecas, las estadísticas de todo el servidor cuando la cuenta es administrador del sistema, y si el servidor responde.
Solo lee: nunca se escribe, mueve ni borra nada en su servidor.
Antes de empezar
Se necesita Gladys 5.3 o posterior.
Gladys debe poder alcanzar su servidor Seafile por la red, en la dirección con la que lo abre en
un navegador (por ejemplo https://seafile.example.com o http://192.168.1.20:8000).
La integración inicia sesión con una cuenta de Seafile. Una cuenta normal basta; una cuenta de administrador del sistema aporta además las estadísticas de todo el servidor (usuarios, archivos, almacenamiento).
La forma recomendada: un token de API
- Abra Seafile en un navegador e inicie sesión con la cuenta que Gladys debe usar.
- Haga clic en su avatar (arriba a la derecha) y luego en Ajustes.
- En Web API Auth Token, haga clic en Generar y copie el token.
- Péguelo en el campo Token de API de la integración.
Un token de API también funciona cuando la cuenta usa la verificación en dos pasos. Para cortar el acceso de Gladys, borre el token en el mismo lugar.
La otra forma: un usuario y una contraseña
Deje vacío el token de API y rellene Usuario (el correo o ID de inicio de sesión de la cuenta) y Contraseña. La integración los intercambia por un token, que aparece en Seafile en Ajustes → Dispositivos vinculados como Gladys Assistant: bórrelo allí para cortar el acceso de Gladys. El token solo se guarda en memoria, y un nuevo inicio de sesión reutiliza el mismo dispositivo vinculado.
No funciona con la verificación en dos pasos: use un token de API para una cuenta así.
Configuración
| Campo | Qué poner |
|---|---|
| Dirección del servidor | La dirección con la que abre Seafile. Sin http:// ni https://, se supone https. |
| Token de API | Recomendado, ver arriba. Tiene prioridad sobre el usuario y la contraseña. |
| Usuario / Contraseña | Solo sin token de API. |
| Aceptar un certificado autofirmado | Solo si su servidor usa https con un certificado firmado por él mismo. |
| Intervalo de actualización (s) | Frecuencia de lectura del servidor, de 60 a 3600 segundos (300 por defecto). |
| Umbral de alerta de cuota (%) | El nivel que activa el disparador de escena Umbral de cuota superado (90 por defecto). |
| Bibliotecas como dispositivos | Publica también un dispositivo por cada biblioteca de la cuenta. |
| Nombres de las bibliotecas | Solo estas bibliotecas se convierten en dispositivos, separadas por comas (sin distinguir mayúsculas). Vacío: todas. |
Luego haga clic en Probar la conexión: la respuesta indica la versión de Seafile, la cuenta, el almacenamiento usado y el número de bibliotecas. Listar las bibliotecas muestra los nombres que puede copiar en Nombres de las bibliotecas.
Dispositivos
Abra Integraciones → Seafile → Dispositivos y cree los dispositivos que quiera conservar.
Servidor Seafile
| Función | Valor |
|---|---|
| Online | 1 si el servidor respondió a la última lectura, 0 si no |
| Seafile version | p. ej. 13.0.5 |
| Storage used | usado por la cuenta, en GB |
| Quota | cuota de la cuenta, en GB — solo si la cuenta tiene cuota |
| Quota used | en %, solo si la cuenta tiene cuota |
| Libraries | bibliotecas que ve la cuenta (propias, compartidas, de sus grupos) |
| Users | solo administrador del sistema: cuentas del servidor |
| Active users | solo administrador del sistema |
| Files on the server | solo administrador del sistema |
| Storage of the server | solo administrador del sistema, en GB |
| Connected clients | solo administrador del sistema: clientes de escritorio y móviles conectados |
Las funciones de cuota y de administración aparecen la primera vez que el servidor las da: el dispositivo se publica de nuevo con ellas, y puede actualizarlo en Gladys.
Bibliotecas Seafile
Con Bibliotecas como dispositivos activado, cada biblioteca propia de la cuenta se convierte en un dispositivo (no las compartidas con ella), o solo las indicadas en Nombres de las bibliotecas:
| Función | Valor |
|---|---|
| Size | tamaño, en GB |
| Files | número de archivos |
Cambiar el nombre de una biblioteca en Seafile conserva su dispositivo: los dispositivos siguen el identificador de la biblioteca, no su nombre.
Acciones
- Probar la conexión — lee el servidor ahora y dice lo que encontró.
- Listar las bibliotecas — las bibliotecas que ve la cuenta, las más grandes primero, con su tamaño; las compartidas están marcadas.
Escenas y panel (Gladys 5.1+)
Disparadores de escena
| Disparador | Cuándo | Variables |
|---|---|---|
| El servidor Seafile está inaccesible | deja de responder o rechaza las credenciales — una vez por corte | nombre del servidor, dirección del servidor, motivo (código) |
| El servidor Seafile vuelve a estar accesible | vuelve a responder tras un corte | nombre del servidor, dirección del servidor, minutos sin conexión |
| Umbral de cuota superado | la cuenta supera el umbral de alerta de su cuota | nombre del servidor, cuota usada (%), umbral, usado (GB), cuota (GB) |
| Una biblioteca ha cambiado | se añadió, modificó o eliminó un archivo en una biblioteca visible | nombre de la biblioteca, modificada por, tamaño (GB), modificada el |
| La versión de Seafile ha cambiado | el servidor se ha actualizado (o se ha bajado de versión) | nombre del servidor, versión anterior, nueva versión |
Cada disparador se puede limitar a un dispositivo: el servidor, o — para Una biblioteca ha cambiado — un dispositivo de biblioteca.
Conviene saber:
- La primera lectura tras el arranque de Gladys o de la integración solo sirve de referencia: no activa nada, así que un reinicio nunca vuelve a anunciar una cuota llena ni todas las bibliotecas.
- Un servidor ya caído al arrancar la integración no activa inaccesible (nunca se vio en marcha).
- Una lectura fallida se reintenta una vez cinco segundos después antes de contar como corte.
- La alerta de cuota se activa una vez al subir, y de nuevo solo cuando el uso ha bajado al menos dos puntos por debajo del umbral.
- El código de motivo de inaccesible es uno de
UNREACHABLE,TIMEOUT,TLS,AUTH,OTP_REQUIRED,PERMISSION,NOT_FOUND,HTTP,BAD_RESPONSE. - Una biblioteca ha cambiado se detecta entre dos lecturas: con un intervalo de 5 minutos, varios cambios en los mismos cinco minutos dan un único evento.
Acciones de escena
- Leer el servidor Seafile ahora — actualiza todos los dispositivos ahora. Salidas: servidor en línea (sí/no), versión, usado (GB), cuota usada (%, −1 sin cuota), bibliotecas.
- Leer una biblioteca Seafile — elija un dispositivo de biblioteca; salidas: biblioteca encontrada (sí/no), nombre, tamaño (GB), archivos, último cambio.
Un servidor que no responde es una salida (online = no), no una acción fallida: compruébelo en
una condición después de la acción.
El widget «Seafile»
Añada el widget Seafile a un panel. Muestra el indicador de cuota (si la cuenta tiene cuota), el almacenamiento usado, el número de bibliotecas, los usuarios (administrador del sistema), las bibliotecas más grandes, el estado del servidor, su versión y la cuenta, y un botón Leer ahora. Su ajuste Bibliotecas mostradas (0 a 8, 5 por defecto) fija la longitud de la lista.
Conviene saber
- Los tamaños están en gigabytes decimales (1 GB = 1.000.000.000 bytes), como los muestra Seafile.
- El servidor se identifica por su host (y su puerto, y su ruta): pasar de
http://ahttps://conserva los dispositivos, un nuevo nombre de host crea otros nuevos. - No se guarda nada en disco: el token obtenido a partir de una contraseña vive en memoria.
Solución de problemas
| Mensaje | Qué hacer |
|---|---|
| No se puede contactar con … | Compruebe la dirección, el puerto y que Gladys alcanza el servidor (misma red, cortafuegos). |
| … no respondió a tiempo | El servidor está sobrecargado o apagado; compruébelo en un navegador. |
| Se rechazó el certificado de … | Un certificado autofirmado: active Aceptar un certificado autofirmado. |
| El servidor rechazó las credenciales | Genere un nuevo token de API, o compruebe el usuario y la contraseña. |
| Esta cuenta usa la verificación en dos pasos | Use un token de API en lugar de la contraseña. |
| … respondió, pero no como un servidor Seafile | La dirección apunta a otro sitio (página de un proxy inverso, portal de acceso): corrija la dirección. |
| Sin estadísticas del servidor con una cuenta admin | La cuenta debe ser administrador del sistema, con permiso para ver la información del sistema (roles Pro). |
Parámetros de configuración
Estos son los parámetros que Seafile te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Primeros pasos | section | No | La integración lee su servidor Seafile a través de su red: el almacenamiento y la cuota de una cuenta, sus bibliotecas y las estadísticas del servidor si la cuenta es administrador del sistema. Indique la dirección del servidor y un token de API (Seafile: Ajustes → Web API Auth Token), o un usuario y una contraseña. No se escribe nada en el servidor. |
| Dirección del servidor | string | Sí | La dirección con la que abre Seafile en un navegador, p. ej. https://seafile.example.com o http://192.168.1.20:8000. Sin http(s)://, se supone https. |
| Token de API | secret | No | Recomendado. En Seafile: su avatar → Ajustes → Web API Auth Token → Generar. Tiene prioridad sobre el usuario y la contraseña, y funciona con la verificación en dos pasos. |
| Usuario | string | No | Solo sin token de API: el correo (o ID de inicio de sesión) de la cuenta. |
| Contraseña | secret | No | Solo sin token de API. Se intercambia por un token que aparece en Seafile como el dispositivo vinculado «Gladys Assistant», donde puede revocarlo. |
| Aceptar un certificado autofirmado | boolean | No | Actívelo solo si su servidor usa https con un certificado firmado por él mismo. |
| Intervalo de actualización (s) | number | No | Frecuencia de lectura del servidor, en segundos. |
| Umbral de alerta de cuota (%) | number | No | El disparador de escena «Umbral de cuota superado» se activa cuando la cuenta supera esta parte de su cuota. |
| Bibliotecas como dispositivos | boolean | No | Publica también un dispositivo por cada biblioteca de la cuenta, con su tamaño y número de archivos. |
| Nombres de las bibliotecas | string | No | Solo estas bibliotecas se convierten en dispositivos, separadas por comas. Vacío: todas. «Listar las bibliotecas» muestra sus nombres. |
Cómo instalar Seafile en Gladys
- En Gladys, abre Integraciones: Seafile aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/prohand/gladys-seafile:1.0.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/prohand/gladys-seafile.
Seafile requiere Gladys >=5.3.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Seafile es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene prohand, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación