Shortcloud — instala el acortador de enlaces de Nextcloud

Instalación

  1. Inicia sesión en tu cuenta de MediaLab Works, abre Licencias y descarga el archivo de la app shortcloud-x.y.z.tar.gz (disponible con una suscripción activa, una licencia de por vida dentro de su período de actualizaciones o durante la prueba gratuita de 30 días).
  2. Extráelo en la carpeta apps/ (o custom_apps/) de Nextcloud de modo que obtengas apps/shortcloud/, con propietario el usuario del servidor web:
    cd /var/www/nextcloud/apps
    sudo tar -xzf ~/shortcloud-x.y.z.tar.gz
    sudo chown -R www-data:www-data shortcloud
    
  3. Actívala: sudo -u www-data php occ app:enable shortcloud, o desde la página Aplicaciones.
  4. Abre Ajustes de administración → Shortcloud → License, pega tu clave de licencia y guarda. La app contacta con el servidor de licencias, vincula la clave a esta instancia de Nextcloud y muestra la licencia como Active.

Licencia

La licencia se comprueba una vez al día. Sin internet, la app sigue funcionando 7 días después de la última comprobación exitosa; después se detiene hasta poder comprobar de nuevo.

Sin una licencia válida, la app se detiene: los trabajos en segundo plano (sincronización de álbumes, comprobación de reglas) no se ejecutan, sus páginas, direcciones cortas y API responden con el motivo, y solo la sección License sigue funcionando (ahí puedes iniciar la prueba, introducir la clave o renovar). No se borra nada: cada enlace corto se conserva y vuelve a funcionar en cuanto la licencia es válida.

Configuración

La regla de reescritura. Nextcloud no permite que una app de terceros responda por sí sola en /go/…, así que una regla de reescritura envía esas peticiones a la app. En Apache con un .htaccess escribible, la app lo escribe en la primera petición tras activarse. Abre Ajustes de administración → Shortcloud: prueba la dirección corta por HTTP y dice si la regla funciona, ofrece Install rewrite rule y muestra el fragmento para nginx o un virtual host. El bloque que escribe:

# BEGIN Shortcloud
<IfModule mod_rewrite.c>
  RewriteEngine on
  RewriteRule ^go/(.*)$ apps/shortcloud/go.php?slug=$1 [END,QSA]
</IfModule>
# END Shortcloud

El bloque sobrevive a occ upgrade y occ maintenance:update:htaccess; si una actualización del núcleo reemplaza .htaccess, la app lo restaura. Desde una terminal: occ shortcloud:setup (--check, --remove).

Ajustes en la misma página:

Ajuste Significado
Pause Sin enlaces cortos nuevos; los existentes siguen funcionando.
Automatic short links Uno para cada nuevo enlace de compartir público.
Path prefix /go/ por defecto; cambiarlo reescribe la regla.
Length of random endings 7 por defecto, sin caracteres que se confunden entre sí.
Who may create Todos, o solo grupos elegidos. Los administradores siempre pueden.
Targets Solo esta instancia de Nextcloud (por defecto), una lista de hosts o cualquier dirección. Los enlaces de compartir siempre están permitidos.
Reserved endings Nombres que nunca se asignan.
Custom short domains Hosts adicionales, con un prefijo opcional.
Pretty URLs Oculta /index.php de cada dirección (las direcciones antiguas siguen funcionando).

Un dominio corto adicional: apunta su DNS al servidor, consigue un certificado, añádelo en Custom short domains y después añade el virtual host que muestra la página. No necesita ser un dominio de confianza de Nextcloud: solo el redireccionador responde allí.

Uso diario

  • Comparte un archivo o carpeta por enlace como siempre y después usa Copy short link en el menú … del enlace compartido. Short link… te permite cambiar el final y muestra el código QR.
  • La página Shortcloud (menú superior) lista tus enlaces con visitas y última visita, y te permite acortar cualquier dirección permitida, o pausar o eliminar un enlace.
  • Recursos compartidos existentes creados antes de la app: sudo -u www-data php occ shortcloud:backfill [--dry-run] [--user uid].
  • Otros comandos: occ shortcloud:add <url> --user uid [--slug name], occ shortcloud:list, occ shortcloud:delete <id|slug>.
  • Desactivar la app conserva cada enlace almacenado; volver a activarla los recupera sin cambios.

Resolución de problemas

  • Los enlaces cortos dan «404 Not Found»: la regla de reescritura no está activa. La página de ajustes y Ajustes de administración → Vista general lo indican. En Apache, comprueba mod_rewrite y AllowOverride All; en nginx, añade el fragmento de la página de ajustes.
  • La regla desapareció tras una actualización de Nextcloud: se restaura en la siguiente actualización de la app, en la primera petición tras el cambio de versión o en la comprobación diaria; occ shortcloud:setup la restaura al instante.
  • Un enlace corto responde «gone»: su recurso compartido se eliminó o caducó.
  • «Short links to this site are not allowed» al acortar una dirección: los destinos externos se rechazan por defecto; permite el host (o cualquier dirección) en Targets.
  • «Short links to this address are blocked» para un host permitido: la dirección está en la lista antirabuso. La app no tiene ninguna lista incorporada; el servidor de licencias puede entregar una lista firmada de hosts y fragmentos de URL conocidos por usarse para phishing o malware, que se aplica sobre tu propia política. Está vacía por defecto — acortadores como bit.ly no están bloqueados, porque muchos equipos los usan legítimamente — y solo se rellena con destinos que fueron abusados de verdad. Si se rechaza una dirección que necesitas, escríbenos.

Para descargar necesitas una licencia o la prueba gratuita de 30 días.