Shlink на VPS: self-hosted URL shortener с аналитикой

Краткий ответ: Shlink — PHP URL shortener с REST API, QR, geo analytics. На VPS 1 GB+: Docker Compose + SSL.

Bitly — лимиты, TinyURL — нет контроля. Shlink на вашем VPS — свой домен, unlimited links, API.

---

Shlink vs Bitly vs YOURLS vs Kutt

Критерий	Shlink	SaaS Leader	Alternative OSS	Enterprise
Self-hosted	Да	Нет	Да	Нет
Цена	Free (VPS)	$10+/user	Free	$$$
RAM на VPS	1–4 GB	N/A	1 GB	N/A
API	REST	Pro	REST	Pro
Приватность	Полная	Cloud	Полная	Vendor

Shlink — оптимальный self-hosted выбор для коротких ссылок на VPS.

---

Архитектура production stack

Users / Agents
        ↓ HTTPS
   Nginx + Let's Encrypt
        ↓
   Shlink container (port 8080)
        ↓
   Database + volumes
        ↓
   Optional: [Authentik](/blog/authentik-sso-vps/) / [CrowdSec](/blog/crowdsec-zashchita-vps/)

Опционально: Authentik SSO, CrowdSec WAF, Tailscale private access.

---

Требования к VPS

Сценарий	RAM	CPU	Диск
Личное использование	1 GB	1 vCPU	10 GB SSD
Команда / small org	2 GB	2 vCPU	20 GB SSD
Production + HA	4 GB	2 vCPU	40 GB SSD

Shlink на Docker Compose — предсказуемое потребление ресурсов. Bottleneck чаще диск при media-heavy workloads.

---

Подготовка VPS

sudo apt update && sudo apt upgrade -y
sudo apt install -y docker.io docker-compose-plugin nginx certbot
sudo usermod -aG docker $USER

DNS: A запись s.example.com → IP VPS. Firewall: nftables — 80, 443. Email alerts — Postfix.

---

Docker Compose (production)

services:
  shlink:
    image: shlinkio/shlink:stable
    restart: unless-stopped
    depends_on:
      - db
    environment:
      DEFAULT_DOMAIN: s.example.com
      IS_HTTPS_ENABLED: "true"
      GEOLITE_LICENSE_KEY: YOUR_MAXMIND_KEY
      DB_DRIVER: postgres
      DB_HOST: db
      DB_USER: shlink
      DB_PASSWORD: CHANGE_ME
      DB_NAME: shlink
    ports:
      - "127.0.0.1:8080:8080"
  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_DB: shlink
      POSTGRES_USER: shlink
      POSTGRES_PASSWORD: CHANGE_ME
    volumes:
      - pgdata:/var/lib/postgresql/data
volumes:
  pgdata:

Первый запуск: docker compose up -d, затем https://s.example.com.

---

Nginx reverse proxy

server {
    listen 443 ssl http2;
    server_name s.example.com;
    ssl_certificate /etc/letsencrypt/live/s.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/s.example.com/privkey.pem;
    client_max_body_size 100M;
    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

SSL: Let’s Encrypt certbot. Альтернатива — Caddy с auto-HTTPS.

---

Первоначальная настройка Shlink

1. docker compose up -d
2. Откройте https://s.example.com
3. Создайте admin account
4. Configure core settings
5. Import/migrate existing data
6. Test core workflow

---

Ключевые возможности Shlink

Функция	Описание
Core feature 1	Primary Shlink capability
Core feature 2	Secondary workflow
Core feature 3	Integration ready

Полный контроль над коротких ссылок на VPS.

---

Расширенная конфигурация

Параметр	Рекомендация
Memory	2+ GB для production
Storage	SSD, monitor growth
Networking	Tailscale for admin

Документируйте конфиг в Gitea.

---

Интеграции и workflows

Интеграция	Применение
n8n	Automation
Gitea	GitOps deploy
Authentik	SSO login

Единый VPS stack с Docker Compose.

---

API и автоматизация

curl -s https://s.example.com/api/health

Связки:

• n8n — webhook automation
• Gitea — CI/CD deploy hooks
• Uptime Kuma — health checks

---

SSO и аутентификация

Шаг	Действие
1	Authentik → OAuth2/OIDC provider
2	Configure OIDC client ID/secret в env
3	Redirect URI: https://s.example.com/oauth/callback
4	Disable public registration

Альтернатива — Tailscale mesh-only access без публичного exposure.

---

Backup и disaster recovery

Что бэкапить	Как	Частота
shlink data volume	tar/rsync	Daily
Database dump	pg_dump / mysqldump	Daily
docker-compose.yml + .env	git secret repo	On change

#!/bin/bash
docker compose exec -T db pg_dump -U shlink shlink > /backup/shlink-$(date +%F).sql
tar czf /backup/shlink-data-$(date +%F).tar.gz ./data

Стратегия 3-2-1: local + Restic offsite. Тест restore на staging VPS раз в квартал.

---

Security hardening

Пункт	Реализация
HTTPS only	Nginx redirect 80→443
Strong auth	OIDC / local admin
Rate limiting	Nginx limit_req
CrowdSec	Bouncer на Nginx
Updates	docker compose pull monthly
Tailscale	Private admin access

Не публикуйте Shlink без аутентификации в production.

---

Мониторинг

• Uptime — Uptime Kuma ping https://s.example.com
• Logs — docker compose logs -f shlink
• Disk — alert при 80% usage
• DB — connection pool, slow queries
• ntfy — push alerts on downtime

---

Performance tuning

• Upgrade RAM при OOM или slow response
• PostgreSQL tuning: shared_buffers, work_mem
• Nginx gzip + cache static assets
• Redis cache layer если поддерживается
• Horizontal scale — второй VPS + load balancer (advanced)

---

Миграция с SaaS-альтернатив

Источник	Метод
Cloud SaaS	Export data → import в Shlink
Self-hosted legacy	Docker volume migration
Manual	API bulk import scripts

Планируйте downtime window и verify data integrity после миграции.

---

Интеграция с экосистемой

Сервис	Связка
Docker Compose	Unified VPS stack
Authentik	SSO для всех сервисов
Immich	Media complement
Gitea	Git + CI integration
CrowdSec	Shared security layer

Единый VPS — Shlink + Nginx + SSL + backup.

---

Troubleshooting

Проблема	Решение
502 Bad Gateway	Container down, docker compose ps
413 Entity Too Large	Nginx client_max_body_size
DB connection error	Check credentials, healthcheck
Login loop	X-Forwarded-Proto header
SSO redirect fail	OIDC redirect URI exact match
Slow performance	Upgrade RAM, check DB indexes
SSL certificate error	Certbot renew
OOM killed	Increase RAM or reduce workers
Import fails	Check file encoding UTF-8
API 401/403	Token scope, CORS settings

---

Связка с экосистемой Storm

• Reverse proxy — Nginx vs Caddy
• SSO — Authentik
• Защита — CrowdSec
• VPN — Tailscale
• Docker — Docker Compose patterns
• Backup — 3-2-1 rule

---

Итог

Shlink на VPS — production-ready self-hosted решение для коротких ссылок. Setup за день, полный контроль данных.

VPS от 2 GB — StormNet Cloud. SSL — Let’s Encrypt. Backup — 3-2-1. Security — CrowdSec.