Los enlaces largos para compartir en Nextcloud cuestan de vender. Una URL como https://cloud.example.com/index.php/s/aBcDeFg12345678 parece algo que enviaría un phisher, es incómoda de dictar por teléfono y se parte mal en un folleto impreso. Si gestionas tu propio servidor, puedes solucionarlo sin entregar tus enlaces a un acortador de terceros: Shortcloud es un plugin de Nextcloud que da a cada recurso compartido público una dirección corta en tu propio dominio y la redirige al recurso real. Este tutorial repasa la instalación, la configuración de la regla de reescritura y las funciones del día a día: enlaces cortos automáticos para recursos nuevos y antiguos, terminaciones personalizadas, dominios cortos adicionales, códigos QR, recursos caducados que responden 410 Gone y cómo ocultar /index.php de tus direcciones.
Todo lo que sigue procede de la documentación del producto. Si quieres la referencia completa, consulta la guía de usuario y la página del producto.
Qué problema resuelve
Un enlace corto como cloud.example.com/go/abc1234 es fácil de escribir, fácil de imprimir y parece propio de tu organización. Shortcloud crea uno automáticamente para cada nuevo recurso compartido por enlace público, tanto si el recurso se creó desde la interfaz web como desde el cliente de escritorio o un cliente móvil. Tu dominio sigue siendo tuyo y el redireccionador es tu propio servidor, no un servicio de acortamiento público.
Requisitos previos
- Nextcloud 32 a 34 con PHP 8.1 o superior.
- Una regla de reescritura en tu servidor web. En Apache con
mod_rewriteyAllowOverride All, la app la escribe ella misma en el.htaccessde Nextcloud y la mantiene ahí entre actualizaciones. En nginx o en un host virtual, la página de ajustes muestra el fragmento que debes añadir. - Para un dominio corto adicional: DNS apuntando al servidor, un certificado TLS y un host virtual (la página de ajustes lo muestra).
- Una clave de licencia de tu cuenta de MediaLab Works; puedes empezar la prueba gratuita de 30 días desde la app.
Paso 1 — Instalar y activar la app
Descarga el archivo shortcloud-x.y.z.tar.gz desde Licenses en tu cuenta y extráelo en tu carpeta de apps para que quede apps/shortcloud/, con el usuario del servidor web como propietario:
cd /var/www/nextcloud/apps
sudo tar -xzf ~/shortcloud-x.y.z.tar.gz
sudo chown -R www-data:www-data shortcloud
Actívala:
sudo -u www-data php occ app:enable shortcloud
También puedes activarla desde la página Apps.
Paso 2 — Activar la licencia
Abre Administration settings → 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.
Conviene saberlo: 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 correcta; pasado ese plazo se detiene hasta que pueda comprobar de nuevo. Sin una licencia válida no se borra nada: todos los enlaces cortos se conservan y vuelven a funcionar en cuanto la licencia sea válida, y mientras tanto solo la sección License sigue siendo utilizable.
Paso 3 — Comprobar que la regla de reescritura funciona
Nextcloud no permite que una app de terceros responda por sí misma en /go/…, así que una regla de reescritura envía esas peticiones a la app. En Apache con un .htaccess escribible, la app la escribe en la primera petición tras la activación. Abre Administration settings → Shortcloud: la página prueba la dirección corta por HTTP e indica si la regla funciona, ofrece Install rewrite rule y muestra el fragmento para nginx o un host virtual.
El bloque que escribe tiene este aspecto:
# 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 a occ maintenance:update:htaccess; si una actualización del núcleo reemplaza el .htaccess, la app lo vuelve a poner. Desde un terminal también puedes usar occ shortcloud:setup (con --check y --remove).
Paso 4 — Ajustar la configuración
La misma página de ajustes controla cómo se comporta el acortador:
| Ajuste | Significado |
|---|---|
| Pause | No se crean enlaces cortos nuevos; los existentes siguen funcionando. |
| Automatic short links | Uno para cada nuevo recurso compartido por enlace público. |
| Path prefix | /go/ por defecto; cambiarlo reescribe la regla. |
| Length of random endings | 7 por defecto, sin caracteres que se confundan entre sí. |
| Who may create | Todos, o solo grupos concretos. Los administradores siempre pueden. |
| Targets | Solo este Nextcloud (por defecto), una lista de hosts o cualquier dirección. Los enlaces de recursos compartidos 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 todas las direcciones (las antiguas siguen funcionando). |
Un punto de partida sensato para la mayoría de quienes autoalojan: deja Targets en Only this Nextcloud (así tu dominio nunca se convierte en un redireccionador abierto), mantén el prefijo por defecto y activa Pretty URLs.
Paso 5 — Compartir archivos y copiar el enlace corto
Comparte un archivo o una carpeta por enlace como de costumbre y, después, abre el menú … del recurso compartido por enlace en la barra lateral de compartir y elige Copy short link. Short link… te permite cambiar la terminación y muestra el código QR, muy útil para folletos impresos, diapositivas o un cartel en un evento de la comunidad.
Los álbumes también cuentan: los enlaces públicos de álbumes de las apps Photos y Memories también obtienen enlaces cortos.
Paso 6 — Dar enlaces cortos a los recursos antiguos
Los recursos creados antes de instalar la app aún no tienen enlace corto. Rellénalos:
sudo -u www-data php occ shortcloud:backfill --dry-run
sudo -u www-data php occ shortcloud:backfill
Puedes limitar la ejecución a un usuario con --user uid, y conviene probar siempre primero con --dry-run.
Paso 7 — Terminaciones personalizadas, dominios adicionales y enlaces manuales
- Terminaciones personalizadas: el dominio es fijo, el resto es tuyo; por ejemplo
/go/annual-report. - Dominios cortos adicionales: por ejemplo
https://cc.link/abc1234, servido por el mismo servidor. Apunta su DNS al servidor, obtén un certificado, añádelo en Custom short domains y luego añade el host virtual que muestra la página. No hace falta que sea un dominio de confianza de Nextcloud: allí solo responde el redireccionador. - Cualquier dirección se puede acortar desde la página Shortcloud (menú superior), dentro de la política que hayas definido. La página lista tus enlaces con las visitas y la última visita, y te permite pausar o eliminar un enlace.
- Desde el terminal:
occ shortcloud:add <url> --user uid [--slug name],occ shortcloud:list,occ shortcloud:delete <id|slug>. También hay una API OCS para scripts.
Consejos y resolución de problemas
- Los enlaces cortos dan "404 Not Found". La regla de reescritura no está activa. La página de ajustes y Administration settings → Overview lo indican. En Apache comprueba
mod_rewriteyAllowOverride 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 con la comprobación diaria;
occ shortcloud:setupla restaura al momento. - Un enlace corto responde "gone". Su recurso compartido se eliminó o ha caducado: la app responde 410 Gone en lugar de redirigir a algo que ya no existe. Es el comportamiento previsto, no un error.
- "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 antiabuso. La app no tiene lista propia; el servidor de licencias puede entregar una lista firmada de hosts y fragmentos de URL conocidos por usarse en phishing o malware, que se aplica por encima de tu propia política. Está vacía por defecto (los acortadores como bit.ly no se bloquean, porque muchos equipos los comparten de forma legítima) y solo se llena para destinos que realmente se han usado de forma abusiva. Si se rechaza una dirección que necesitas, escríbenos a través de la página de contacto.
- Privacidad: por cada enlace, la app guarda el propietario, el dominio, la terminación, el destino, el recurso compartido al que pertenece, una etiqueta (el nombre del archivo), el estado, el contador de visitas y la hora de la última visita. No se guardan datos de los visitantes, así que el contador de visitas se puede dejar activado sin problema.
- Pausa: pausar un enlace concreto, o pausar la creación para todos, nunca rompe los enlaces existentes. Desactivar la app conserva todos los enlaces guardados; volver a activarla los recupera sin cambios.
- Límites por grupo: si solo algunos equipos deben crear enlaces, limita la creación a grupos concretos; los administradores siempre pueden.
Conclusión
Un enlace corto en tu propio dominio es un cambio pequeño con un beneficio real: URL para compartir en las que la gente confía lo suficiente como para hacer clic, imprimir y escribir. Shortcloud mantiene el redireccionador en tu servidor, crea enlaces cortos automáticamente para los recursos nuevos, rellena los antiguos y se comporta con honestidad cuando un recurso ya no existe. Instálalo, confirma la regla de reescritura en la página de ajustes y el próximo enlace que compartas será mucho más fácil de pasar. Hay más contexto en la base de conocimiento y las FAQ; el changelog muestra qué cambió en cada versión.