Tutoriales de VPS
Shlink en VPS: administración privada, enlaces y backups (2026)
Despliega Shlink con administración privada y redirecciones HTTPS públicas, limita claves API, interpreta visitas cacheadas y restaura enlaces con backups consistentes.

Una URL impresa en un envase, tarjeta o QR debe seguir resolviendo después de la campaña. Alojarla permite controlar dominio, destino y estadísticas, pero registro, servidor y recuperación siguen siendo tu responsabilidad. No garantiza duración eterna ni aceptación en plataformas externas.
Comparamos Shlink, YOURLS y Kutt y desplegamos Shlink con administración privada, redirección pública y base de datos.
| Producto | Base y uso | Verifica en la versión elegida |
|---|---|---|
| Shlink | API PHP, cliente web y base; gestión multidominio con API | Estadísticas, QR, geo, bots, caducidad/límites y requisitos de contraseña |
| YOURLS | PHP y base; enlaces personales con plugins | Multidominio, QR, geo y límites según plugins |
| Kutt | Node.js e interfaz personal/equipo | Dominios, base, límites, QR y estadísticas actuales |
Los años 2019/2009/2020 y Shlink 5.0 de enero de 2026 del original son referencias históricas; consulta changelogs actuales. Muchos plugins YOURLS no garantizan mantenimiento de uno concreto. 3, 2 y 2–3 contenedores son ejemplos arquitectónicos, sin clasificación universal de recursos.
- API, estadísticas y varios dominios: evalúa Shlink.
- Servicio pequeño sencillo: evalúa YOURLS y plugins necesarios.
- Flujo Kutt: comprueba funciones soportadas.
- Con
example.com, usas.example.comogo.example.com; no requiere otro registro, pero continúa renovación del principal. - Extensiones
.link,.cc,.gsy.me: revisa compra, renovación y nombres premium. Presupuesto barato RMB del original no es precio mundial. - Nombre de marca como
品牌名.link: facilita recuerdo.
Revisa historial, registrador y aceptación en canales reales. .tk, .ml y .ga son ejemplos históricos problemáticos de dominios gratuitos; no presupongas gratuidad/disponibilidad actual ni reputación idéntica para toda extensión. Algunos sufijos también encuentran restricciones de detección en aplicaciones.
Conserva dominios antiguos registrados y funcionando al introducir uno nuevo: no puedes editar material impreso retrospectivamente.
1 vCPU/1 GB sirve como presupuesto de prueba, sin garantizar tres contenedores o campañas de QPS alto. Mide PHP, base, cliente, crecimiento y backups. 1 Mbps del original corresponde a tráfico modesto; picos/API pueden variar.
Elige ubicación alcanzable por visitantes y prueba tus canales. Rutas de China continental y restricciones WeChat/QQ mantienen condición regional, sin deducirse del idioma.
mkdir -p ~/shlink/db && cd ~/shlink
Crea docker-compose.yml. Sustituye secretos, alinea contraseña de base/aplicación y usa otra para root. Fija imágenes compatibles revisadas y protege configuración del cliente que contiene claves:
services:
shlink:
image: shlinkio/shlink:stable
container_name: shlink
restart: unless-stopped
environment:
DEFAULT_DOMAIN: s.example.com
IS_HTTPS_ENABLED: "true"
GEOLITE_LICENSE_KEY: 你的MaxMind密钥
DB_DRIVER: maria
DB_HOST: shlink-db
DB_PORT: 3306
DB_NAME: shlink
DB_USER: shlink
DB_PASSWORD: 换成一个强密码
INITIAL_API_KEY: 换成一串长随机字符
TZ: Asia/Shanghai
ports:
- "127.0.0.1:8080:8080"
depends_on:
- shlink-db
shlink-db:
image: mariadb:11
container_name: shlink-db
restart: unless-stopped
environment:
MARIADB_DATABASE: shlink
MARIADB_USER: shlink
MARIADB_PASSWORD: 换成一个强密码
MARIADB_ROOT_PASSWORD: 换成一个不一样的强密码
volumes:
- ./db:/var/lib/mysql
shlink-web:
image: shlinkio/shlink-web-client
container_name: shlink-web
restart: unless-stopped
environment:
SHLINK_SERVER_URL: https://s.example.com
SHLINK_SERVER_API_KEY: 跟上面的 INITIAL_API_KEY 保持一致
SHLINK_SERVER_NAME: 我的短链
ports:
- "127.0.0.1:8081:8080"
DEFAULT_DOMAIN requiere hostname como s.example.com, no https://s.example.com/. DNS y proxy deben coincidir.
INITIAL_API_KEY crea una clave según reglas de inicialización de la versión; cambiar entorno después no rota claves. Gestiona explícitamente y protege salida:
docker exec -it shlink shlink api-key:list
docker exec -it shlink shlink api-key:generate
docker exec -it shlink shlink api-key:disable 旧key
SHLINK_SERVER_URL se alcanza desde el navegador del administrador, no el contenedor web. Usa HTTPS público o URL privada realmente accesible desde ese navegador. La clave puede entregarse al navegador: protege UI/configuración y usa alcance limitado cuando se admita.
GEOLITE_LICENSE_KEY es opcional, sujeto a cuenta/licencia y cuotas MaxMind. Conserva geo datos según documentación; no hay cuota universal garantizada de una descarga al día. Ausencia geo puede afectar estadísticas sin desactivar redirecciones.
docker compose up -d
docker compose logs -f shlink
Comprueba disponibilidad de base y logs; depends_on no garantiza base lista. Adapta zona horaria y nombres, conservando significado del instante de los ejemplos.
Configura DNS y HTTPS confiable:
s.example.com {
encode gzip
reverse_proxy 127.0.0.1:8080
}
admin.example.com {
basicauth {
admin $2a$14$你的密码哈希
}
reverse_proxy 127.0.0.1:8081
}
Usa sintaxis de Caddy instalada, actualmente basic_auth; reemplaza hash y valida. Mantén 8081 privado y protege proxy con basicauth o acceso configurado. No expongas clave admin incrustada en cliente abierto.
Visitantes necesitan redirecciones de 8080 sin login admin; escritura API conserva claves y límites propios. No bloquees todos los enlaces de campaña con una autenticación administrativa. Consulta Caddy o Nginx Proxy Manager.
Opciones soportadas de la interfaz:
- Código
/launch2026fácil de recordar frente a/aB3xK9. - Caducidad con fecha/hora explícita.
- Límite como 1000 visitas: no equivale a cupones canjeados en una tienda externa.
- QR, si se admite, probado antes de imprimir.
docker exec -it shlink shlink short-url:create 'https://example.com/very/long/path?utm_source=xxx' \
--custom-slug launch2026 \
--max-visits 1000 \
--valid-until 2026-12-31T23:59:59+08:00
Caduca en 2026-12-31T23:59:59+08:00: instante de ejemplo, no promoción vigente. Verifica flags. REST API permite lotes y UTM; guarda claves, gestiona fallos y evita duplicados. Revisa permisos de cualquier extensión antes de conceder acceso.
- Tiempo: peticiones que alcanzaron servicio.
- Referer: puede faltar o variar por privacidad; QR no siempre es distinguible.
- País/ciudad: estimación geo, sin ubicación física confirmada.
- Dispositivo/navegador: metadatos disponibles.
- Único/repetido: método y privacidad del producto, sin identificación perfecta de personas.
Para enlaces editables medidos, prefiere redirección temporal como 302 y política de caché apropiada. 302 también puede cachearse; no asegura cada clic futuro. 301 permanente puede ocultar visitas o cambios posteriores. Revisa CDN/proxy y Cache-Control en lugar de confiar solo en estado; no garantiza resultado SEO.
Una clave expuesta permite destinos que dañan reputación del dominio. Mantén creación privada:
- Protege claves como contraseñas; Shlink no requiere registro público.
- Configura límites API/WAF medidos, sin asumir bloqueo total del abuso.
- Revisa creaciones desconocidas y picos.
- Da claves restringidas compatibles a colaboradores, sin administrador ilimitado por defecto.
Acceso a redirección y permiso para crear/editar son capacidades distintas.
Base, estadísticas y configuración permiten recuperar URLs impresas. Para copia física detenida, pausa escritores de aplicación primero, luego detén base y archiva:
cd ~/shlink
docker compose stop shlink-db
tar czf ~/shlink-backup-$(date +%F).tar.gz db docker-compose.yml
docker compose start
Verifica tar y reinicio ante fallos; incluye secretos privados, versiones y demás configuración. Guarda fuera del VPS y prueba un enlace restaurado.
./db contiene MariaDB. Backup lógico con mysqldump o utilidad MariaDB compatible evita parada completa. El original pide contraseña y no es fiable como tarea desatendida:
docker exec shlink-db mariadb-dump -u shlink -p shlink > ~/shlink-$(date +%F).sql
Para automatizar, prepara archivo de opciones restringido y solo lectura dentro del contenedor, con cuenta exclusiva de backup. Ejecuta mediante Docker exec mariadb-dump --defaults-extra-file=/run/secrets/backup.cnf --single-transaction shlink, redirigiendo a archivo privado de nombre único. Verifica estado y contenido no vacío. Single-transaction exige tablas transaccionales y ausencia de cambios de esquema incompatibles. Prueba restauración; nunca publiques contraseña en comandos/logs.
404: revisa DEFAULT_DOMAIN, DNS y host real; configuración no lleva esquema/barra.
Sin visitas: revisa caché de redirección/CDN y opciones de privacidad/bots. Cambiar 301 puede no bastar.
Web no conecta: comprueba SHLINK_SERVER_URL desde navegador, TLS, CORS y claves.
Geo falla: revisa error, licencia y cuota MaxMind reales. SKIP_INITIAL_GEOLITE_DOWNLOAD=true depende de versión, sin opción universal garantizada; omite descarga inicial solo si se admite.
WeChat/QQ bloquea: canal puede restringir reputación/destino. Usa proceso de apelación aplicable; cambiar dominio no garantiza aceptación. Conserva dominios existentes para otros usuarios.
Nuevo dominio: añade junto al anterior, verifica enlaces y mantén registro/DNS antiguos.
Elige dominio duradero, administración privada, monitorización y backups probados. Controlar servicio no elimina dependencia de disponibilidad ni plataformas externas.