Cómo instalar Shlink en Saplo (tu propio acortador de enlaces con estadísticas)

Bitly en un plan de pago puede costar más de 100 euros al mes, antes incluso de superar el límite de enlaces acortados, porque la facturación depende del número de direcciones activas y los clics. Shlink es un acortador de enlaces de código abierto, la misma idea que Bitly, pero instalado en tu propio Box, por una sola vez, sin límite de direcciones y sin factura mensual. A continuación, te explicamos paso a paso cómo instalar Shlink en Saplo.

Por qué Shlink en tu propio Box en lugar de Bitly

Los planes de pago de Bitly tienen dos características que especialmente molestan en campañas de marketing y seguimiento de enlaces a largo plazo:

• límite del número de enlaces acortados y clics al mes - el plan gratuito basta para una campaña individual, no para todo el año de trabajo de una agencia,
• datos sobre los clics guardados por una empresa externa - las estadísticas de tráfico de tus campañas permanecen en los servidores de Bitly, no en los tuyos.

Shlink es el mismo mecanismo para acortar enlaces y contar clics que instalas en tu propio Box. Sin límite de URLs, los datos sobre los clics permanecen en tu infraestructura, y tener un dominio propio para acortar enlaces parece profesional frente a un bit.ly genérico.

Requisitos

Para instalar Shlink en Saplo, necesitas:

• Un Box con Docker habilitado (el motor lo activa automáticamente al instalarlo desde el catálogo; se requiere anidamiento dentro de un contenedor, algo que Saplo incluye por defecto),
• al menos 512 MB de RAM libre en el Box y 2 GB de espacio en disco,
• un dominio o subdominio *.saploapp.pl incluidos en el precio de cada plan, preferiblemente corto, porque aparecerá en cada enlace corto.

Conviene distinguir desde el principio qué es Shlink y qué no es. Shlink es, en esencia, una API REST y un servidor de redirecciones de enlaces cortos. En Saplo lo obtienes junto con el panel oficial en el navegador, que está alojado en la dirección de la aplicación y protegido con contraseña, por lo que no tendrás que instalar ni configurar nada. Para la instalación en sí no necesitas ninguna base de datos externa, ya que, de forma predeterminada, Shlink guarda los datos en un archivo SQLite local dentro del volumen de datos. Si prevés mucho tráfico, puedes elegir opcionalmente la base de datos MySQL compartida de Saplo.

Instalación paso a paso

1. En el panel de Saplo, entra en Catálogo de aplicaciones y elige Shlink (categoría "Herramientas").
2. Selecciona el Box en el que quieres instalarlo, además del dominio o subdominio en el que funcionarán los enlaces acortados, y elige la base de datos: SQLite (predeterminada, sin infraestructura adicional) o MySQL (base de datos compartida de Saplo, mejor para un tráfico elevado).
3. Confirma la instalación. El motor despliega dos contenedores Docker con las imágenes oficiales shlinkio/shlink y shlinkio/shlink-web-client (panel), genera una clave API y una contraseña aleatorias para el panel, y lo publica todo bajo el dominio indicado mediante nginx con SSL gratuito.
4. El motor espera a que Shlink responda realmente a la solicitud de estado y lo comprueba dos veces antes de dar por concluida la instalación, porque el primer arranque requiere una migración del esquema de la base de datos, que puede tardar más de unos segundos.
5. Al terminar, en los datos iniciales de la aplicación (archivo SHLINK-SETUP.txt) encontrarás el usuario y la contraseña del panel, además de la clave API.

Primera configuración

Shlink, igual que Grafana o MinIO, genera automáticamente los datos de acceso durante la instalación en lugar de solicitarlos en el asistente.

1. Abre los datos iniciales de la aplicación en el panel de Saplo (archivo SHLINK-SETUP.txt), donde encontrarás el nombre de usuario, la contraseña y la clave API.
2. Haz clic en Abrir junto a la aplicación, inicia sesión y selecciona el servidor Mis enlaces. El servidor ya está conectado con la clave API, no tienes que escribir nada.
3. Crea el primer enlace corto en la pestaña de creación de enlaces, opcionalmente con un código corto propio en lugar de una secuencia aleatoria de caracteres.
4. Consulta las estadísticas de clics y el código QR del enlace creado. Ambas funciones están integradas y disponibles desde el momento de la instalación.

Los enlaces cortos funcionan en el mismo dominio sin contraseña, la contraseña solo protege el panel. Un código corto propio no puede llamarse server, settings, assets ni icons, porque esas direcciones las utiliza el panel.

Si prefieres la automatización en lugar de hacer clic en la interfaz, también puedes hacerlo directamente mediante la REST API, por ejemplo, creando un enlace corto con un solo comando:

curl -s -X POST 'https://tu-dominio.saploapp.pl/rest/v3/short-urls' \
  -H "X-Api-Key: YOUR_API_KEY" -H 'Content-Type: application/json' \
  -d '{"longUrl":"https://saplo.pl"}'

Shlink en Saplo frente a Bitly

Preguntas frecuentes

¿Shlink tiene un panel web para iniciar sesión como WordPress o Ghost? Sí. En Saplo, en la dirección de la aplicación, está el panel oficial de Shlink protegido con contraseña. El usuario y la contraseña están en el archivo SHLINK-SETUP.txt. También puedes añadir el mismo servidor en el cliente app.shlink.io o gestionarlo mediante la REST API con la clave de ese archivo.

¿Existe un límite en el número de enlaces acortados? No, Shlink no impone ningún límite al número de direcciones ni de clics. La única restricción son los recursos del Box contratado.

¿Puedo ver desde qué país se hizo clic en el enlace? De forma predeterminada, no. La geolocalización de las visitas requiere tu propia clave gratuita de MaxMind, que no se puede crear automáticamente durante la instalación. Sin ella, Shlink cuenta los clics normalmente, pero sin información sobre el país del visitante.

¿Cuál es la diferencia entre SQLite y MySQL al instalarlo? SQLite es un archivo de base de datos en el volumen de datos, no necesita infraestructura adicional y basta para la mayoría de los casos. MySQL es una base de datos compartida de Saplo, una opción que solo conviene cuando hay un volumen de clics realmente alto.

¿Los datos de Shlink se respaldan automáticamente? Depende del plan de Box que hayas contratado. El backup funciona a nivel de todo el Box, igual que con otras aplicaciones del catálogo, y no es una función exclusiva de Shlink.

Si tienes alguna pregunta al instalar Shlink en tu propio Box o al configurar el panel por primera vez, escríbenos y te ayudaremos con la configuración inicial.