Instalar Sink: acortador de enlaces autoalojado gratuito (guía 2026)

Sink es un acortador de enlaces autoalojado, gratuito y de código abierto que funciona íntegramente en la red edge de Cloudflare. Creado originalmente por ccbikai, el proyecto se ha trasladado a la organización de GitHub miantiao-me y ya ronda las 7.000 estrellas. Con la v0.3.0, la capa de almacenamiento pasó de KV a Cloudflare D1 como base de datos principal, un cambio que rompe la compatibilidad y deja obsoleta la guía de instalación anterior. Este artículo cubre el despliegue de Sink en Cloudflare Workers con la arquitectura actual basada en D1, actualizado para 2026.

¿Qué es Sink?

Sink es un acortador de enlaces autoalojado que funciona sobre Cloudflare Workers. Usa D1 (la base de datos SQL de Cloudflare) para el almacenamiento permanente de enlaces y KV como caché de lectura de paso directo para redirecciones rápidas. El plan gratuito de Cloudflare es suficiente para uso personal y equipos pequeños. Sin VPS, sin contenedores Docker, sin servidor que mantener.

El proyecto está ahora en la v0.3.0 (última versión estable pre-D1: la v0.2.11 si prefieres la versión anterior). El repositorio está en github.com/miantiao-me/Sink. Tiene licencia AGPL-3.0.

¿Por qué elegir un acortador de enlaces autoalojado gratuito?

Los acortadores alojados como Bitly empiezan en 8 $/mes. Dub.co tiene un plan gratuito pero limita funciones detrás de un muro de pago. Short.io te pone un tope en el plan gratuito. Sink no cuesta nada si te mantienes dentro de los límites del plan gratuito de Cloudflare.

El enfoque autoalojado importa: eres dueño de tus datos, no hay dependencia de un proveedor y obtienes analíticas, generación de slugs con IA y funciones como protección por contraseña y enrutamiento geográfico. Todo incluido, sin ventas adicionales.

Si estás montando un servidor doméstico con contenedores Docker, Sink es una incorporación ligera a tu stack autoalojado, aunque se ejecuta en Cloudflare, no en tu servidor. Para uso empresarial, Sink complementa otras herramientas autoalojadas de tu stack.

Novedades de Sink (2024-2026)

Sink ha añadido muchas cosas desde la versión original. Estos son los puntos destacados:

• D1 sustituye a KV como base de datos principal (v0.3.0): KV ahora es solo una caché de redirecciones
• Etiquetas de enlaces, filtrado y ordenación (v0.3.0)
• Webhooks de clics con firmas HMAC (v0.2.11): payloads al estilo de Dub
• Autenticación con Cloudflare Access (v0.2.11): alternativa a NUXT_SITE_TOKEN
• Detección de URL duplicadas (v0.2.11)
• Panel de comprobación de enlaces (v0.2.10): detección por lotes de enlaces rotos con exportación a CSV
• Redirección por país/geolocalización (v0.2.9): dirige a los visitantes según el país detectado por Cloudflare
• Generación de OpenGraph con IA (v0.2.9): genera metadatos OG a partir del contenido de la página
• Constructor de parámetros UTM (v0.2.8): integrado, con vista previa en vivo
• Protección por contraseña y encubrimiento de enlaces (v0.2.6): contraseña por enlace, enmascaramiento con iframe a pantalla completa
• Redirección por dispositivo (v0.2.3): dirige a iOS/Android/Escritorio de forma distinta
• Personalización de OpenGraph (v0.2.3): título, descripción e imagen OG por enlace
• Analíticas en tiempo real (v0.2.4+): globo 3D WebGL, registro de eventos con sondeo cada 10 segundos
• Generación de códigos QR: integrada para todos los enlaces cortos
• Importación/exportación: JSON para enlaces, CSV para analíticas
• Interfaz multiidioma: más de 10 idiomas

El ecosistema también ha crecido: ahora hay una extensión de Chrome («Sink Quick Shorten»), una extensión de Raycast, una app de iOS y compatibilidad con Atajos de Apple.

Funciones clave

Generación de slugs con IA

Sink usa Workers AI con el modelo @cf/qwen/qwen3-30b-a3b-fp8 por defecto. Al crear un enlace, puedes dejar que la IA sugiera un slug relevante y llamativo basado en la URL de destino. Ahorra tiempo cuando acortas enlaces en masa.

Protección por contraseña y encubrimiento de enlaces

Establece una contraseña por enlace para restringir el acceso, útil para compartir documentos internos o contenido sensible al paso del tiempo. El encubrimiento de enlaces (link cloaking) renderiza el destino dentro de un iframe a pantalla completa, enmascarando la URL real. Nota: el encubrimiento solo funciona en sitios que permiten ser incrustados en iframes.

Redirección por dispositivo y geolocalización

Dirige a los visitantes a URL distintas según su dispositivo (iOS/Android/Escritorio) o su país (detectado por Cloudflare). Es muy útil para enlaces a tiendas de apps: envía a los usuarios de iPhone a la App Store, a los de Android a Google Play y a los de escritorio a una landing page.

Analíticas avanzadas y monitorización del estado de los enlaces

Sink registra los clics con datos geográficos, información del referente y desglose por dispositivo, representados en un globo 3D WebGL. El panel de comprobación de enlaces (v0.2.10) verifica por lotes si las URL de destino responden y exporta los enlaces rotos en CSV. También puedes exportar las analíticas de acceso en CSV.

Sink incluye analíticas integradas, pero si necesitas analíticas para todo el sitio web más allá de los clics en los enlaces, Plausible es un gran compañero autoalojado.

Webhooks, API e integraciones

Los webhooks de clics (v0.2.11) envían payloads al estilo de Dub a una URL configurada, con firmas HMAC opcionales. Cada instancia de Sink expone documentación OpenAPI en /docs/scalar, lo que facilita la integración con herramientas de automatización y proxies MCP. La extensión de Chrome, la de Raycast, la app de iOS y las integraciones con Atajos de Apple hacen que Sink sea práctico para el uso diario.

Tecnologías que impulsan Sink

El stack tecnológico de Sink ha evolucionado desde la versión original:

Desplegar Sink en Cloudflare Workers (recomendado)

Cloudflare Workers es el método de despliegue recomendado. Pages todavía funciona pero está obsoleto. Esta sección recorre la configuración completa.

Requisitos previos

Paso 1: haz fork del repositorio

Ve a github.com/miantiao-me/Sink y haz clic en Fork. Esto crea tu propia copia bajo tu cuenta de GitHub.

Si anteriormente hiciste fork de ccbikai/Sink, las redirecciones de GitHub siguen funcionando, pero actualiza tus marcadores y cualquier referencia de CI a la nueva URL.

Paso 2: crea una base de datos Cloudflare D1

1. Ve a Cloudflare Dashboard > D1 > Create database
2. Nómbrala sink
3. Copia el database ID desde la página de detalles de la base de datos. Lo necesitarás más tarde

Paso 3: crea un namespace KV

1. Ve a Cloudflare Dashboard > Workers & Pages > KV > Create a namespace
2. Nómbralo sink
3. Copia el namespace ID. Lo necesitarás en el siguiente paso

Paso 4: despliega con la integración Git de Workers

1. Ve a Cloudflare Dashboard > Workers & Pages > Create
2. Selecciona Workers (no Pages)
3. Haz clic en Connect to Git y autoriza GitHub
4. Selecciona tu repositorio Sink forkeado y la rama master
5. Define Build command: pnpm build
6. Define Deploy command: pnpm deploy:worker
7. Haz clic en Save and Deploy

Paso 5: configura las variables de build y los bindings

Tras el primer despliegue, configura dos grupos de ajustes.

Variables de build (Settings > Variables and Secrets):

Bindings en tiempo de ejecución (Settings > Bindings):

Variables de entorno (Settings > Variables and Secrets):

Paso 6: completa la configuración del almacenamiento (primera ejecución)

Tras el despliegue, debes inicializar la base de datos. Es un paso que se hace una sola vez.

1. Abre https://your-domain/dashboard
2. Inicia sesión con tu NUXT_SITE_TOKEN
3. Ve a Links

Esto dispara la inicialización del almacenamiento. Hasta que lo hagas, la API devuelve HTTP 423 (Storage not ready). Si omites este paso, la creación de enlaces fallará.

Paso 7: añade tu dominio personalizado

1. Ve a Workers & Pages > tu proyecto > Settings > Domains & Routes
2. Haz clic en Add custom domain
3. Introduce tu dominio (p. ej., go.tudominio.com)
4. Cloudflare gestiona el DNS y el TLS automáticamente

Verifica que el dominio está activo:

curl -I https://your-domain/test-slug

Deberías obtener una redirección 301 o 302 (aunque el slug no exista todavía, el worker está respondiendo).

Desplegar Sink en Cloudflare Pages (obsoleto)

El despliegue en Pages todavía funciona pero requiere configuración adicional:

1. Activa el flag de compatibilidad nodejs_compat en los ajustes de tu proyecto Pages (antes no era necesario)
2. Añade CLOUDFLARE_API_TOKEN con permiso D1 Edit y CLOUDFLARE_ACCOUNT_ID como variables de entorno. El script postbuild ejecuta la migración de D1 automáticamente en los builds de la rama master
3. Todos los demás bindings (DB, KV, ANALYTICS, R2, AI) siguen aplicando

¿Ya alojas un blog de Astro en Cloudflare? Sink encaja junto a tus proyectos de Cloudflare existentes, aunque Workers es ahora el camino más sencillo.

Post-despliegue: verificación y resolución de problemas

Verifica tu despliegue

Problemas comunes y soluciones

Opciones avanzadas de configuración

Sink expone muchas variables de entorno para ajustar el comportamiento. Cambiar cualquiera de ellas requiere un redespliegue en Workers.

Copias de seguridad y notas para producción

Si configuraste el binding R2 (paso 5), Sink ejecuta copias de seguridad automáticas según una programación. Desactívalas con NUXT_DISABLE_AUTO_BACKUP=true. Para estrategias de backup en R2 más amplias, mira cómo configurar copias de seguridad de Dokploy con Cloudflare R2 — el proceso de configuración de R2 es similar.

Límites del plan gratuito de Cloudflare (relevantes para Sink):

Cada instancia de Sink también expone documentación OpenAPI en /docs/scalar, útil para la automatización y la integración con agentes de IA.

Sink frente a las alternativas

La principal ventaja de Sink es que funciona íntegramente en el plan gratuito de Cloudflare sin servidor que gestionar. Si administras un conjunto autoalojado más amplio, puedes comparar los mejores paneles de servidor o echar un vistazo a Coolify como PaaS autoalojado. Si usas Dokploy para autoalojar, Sink es un servicio más que puedes ejecutar en paralelo, aunque en Cloudflare en lugar de tu VPS.

Cómo ampliar Sink: apps e integraciones

Sink tiene varios clientes e integraciones:

• Extensión de Chrome: «Sink Quick Shorten» te permite acortar cualquier URL con el clic derecho (Chrome Web Store)
• Extensión de Raycast: «Sink Short Links Manager» para usuarios avanzados de macOS (Raycast Store)
• App de iOS: app nativa de iPhone en la App Store
• Atajos de Apple: integración de automatización en macOS e iOS
• API: documentación OpenAPI en /docs/scalar, soporte MCP mediante proxy OpenAPI

Esto hace que Sink sea mucho más práctico que una herramienta de solo panel. Puedes acortar enlaces desde tu navegador, teléfono o terminal sin abrir el panel.

Conclusión

Sink empezó como un simple acortador basado en Cloudflare KV y ahora es una plataforma completa de gestión de enlaces. La migración a D1 de la v0.3.0 lo convierte en una aplicación con base de datos de verdad manteniendo el modelo de despliegue sin servidor y sin coste. La protección por contraseña, el enrutamiento geográfico, los webhooks y el ecosistema de extensiones (Chrome, Raycast, iOS, Atajos de Apple) lo convierten en una opción sólida para quien quiera acortar enlaces sin cuotas mensuales ni dependencia de un proveedor.

Si estás construyendo tu stack autoalojado, Sink combina bien con contenedores Docker para tu servidor doméstico — uno se ejecuta en tu infraestructura, el otro funciona gratis en el edge de Cloudflare. Sink es una de las 29 apps autoalojadas en Cloudflare Workers que hemos catalogado, incluyendo clientes de email, gestores de contraseñas y apps de notas.