Tutoriais de VPS
Shlink no VPS: administração privada, links e backups (2026)
Instale Shlink com administração privada e redirecionamento HTTPS público, limite chaves API, interprete visitas com cache e restaure links com backups consistentes.

Uma URL impressa numa embalagem, cartão ou QR precisa continuar resolvendo após a campanha. Hospedar permite controlar domínio, destino e estatísticas, mas registro, servidor e recuperação continuam sob sua responsabilidade. Não garante duração eterna nem aceitação por plataformas externas.
Comparamos Shlink, YOURLS e Kutt e instalamos Shlink com administração privada, redirecionamento público e banco.
| Produto | Base e uso | Confira na versão escolhida |
|---|---|---|
| Shlink | API PHP, cliente web e banco; gestão multidomínio com API | Estatísticas, QR, geo, bots, validade/limites e requisitos de senha |
| YOURLS | PHP e banco; links pessoais com plugins | Multidomínio, QR, geo e limites conforme plugins |
| Kutt | Node.js e interface pessoal/equipe | Domínios, banco, limites, QR e estatísticas atuais |
Anos 2019/2009/2020 e Shlink 5.0 em janeiro de 2026 do original são referências históricas; consulte changelogs atuais. Muitos plugins YOURLS não garantem manutenção de um específico. 3, 2 e 2–3 contêineres são exemplos arquitetônicos, sem classificação universal de recursos.
- API, estatísticas e vários domínios: avalie Shlink.
- Serviço pequeno simples: avalie YOURLS e plugins necessários.
- Fluxo Kutt: confira funções suportadas.
- Com
example.com, uses.example.comougo.example.com; dispensa novo registro, mas mantém renovação do principal. - Extensões
.link,.cc,.gse.me: confira compra, renovação e nomes premium. Orçamento barato RMB do original não é preço global. - Nome de marca como
品牌名.link: ajuda a lembrar.
Confira histórico, registrador e aceitação nos canais reais. .tk, .ml e .ga são exemplos históricos problemáticos de domínios gratuitos; não presuma gratuidade/disponibilidade atual nem reputação igual para todo sufixo. Algumas extensões também sofrem restrições de reconhecimento em aplicativos.
Mantenha domínios antigos registrados e funcionando ao criar outro: material impresso não muda retroativamente.
1 vCPU/1 GB serve como orçamento de teste, sem garantir três contêineres ou campanhas de QPS alto. Meça PHP, banco, cliente, crescimento e backups. 1 Mbps do original refere-se a tráfego modesto; picos/API variam.
Escolha localização acessível aos visitantes e teste canais. Rotas da China continental e restrições WeChat/QQ mantêm condição regional, sem decorrer do idioma.
mkdir -p ~/shlink/db && cd ~/shlink
Crie docker-compose.yml. Troque segredos, alinhe senha do banco/aplicação e use outra para root. Fixe imagens compatíveis revisadas e proteja configuração do cliente com chaves:
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 exige hostname como s.example.com, não https://s.example.com/. DNS e proxy precisam corresponder.
INITIAL_API_KEY cria chave conforme inicialização da versão; mudar ambiente depois não rotaciona chaves. Gerencie explicitamente e proteja saída:
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 é acessado pelo navegador do administrador, não pelo contêiner web. Use HTTPS público ou URL privada realmente acessível desse navegador. A chave pode ser entregue ao navegador: proteja UI/configuração e use alcance limitado quando suportado.
GEOLITE_LICENSE_KEY é opcional, sujeito à conta/licença e cotas MaxMind. Preserve geo dados conforme documentação; não existe cota universal garantida de uma descarga por dia. Falta de geo pode afetar estatísticas sem desativar redirecionamento.
docker compose up -d
docker compose logs -f shlink
Confira banco pronto e logs; depends_on não garante prontidão. Adapte fuso e nomes, preservando significado dos instantes dos exemplos.
Configure DNS e HTTPS confiável:
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
}
Use sintaxe do Caddy instalado, atualmente basic_auth; troque hash e valide. Mantenha 8081 privado e proteja proxy com basicauth ou acesso configurado. Não exponha chave admin embutida num cliente aberto.
Visitantes precisam das rotas de 8080 sem login admin; escrita API mantém chaves e limites próprios. Não bloqueie todos os links de campanha com autenticação administrativa. Veja Caddy ou Nginx Proxy Manager.
Opções suportadas na interface:
- Código
/launch2026memorável em vez de/aB3xK9. - Validade com data/hora explícita.
- Limite de 1000 visitas: não equivale a cupons resgatados numa loja externa.
- QR, quando suportado, testado 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
Expira em 2026-12-31T23:59:59+08:00: instante de exemplo, não promoção vigente. Confira flags. REST API permite lotes/UTM; guarde chaves, trate falhas e evite duplicatas. Confira permissões de extensões antes de dar acesso.
- Horário: requisições que chegaram ao serviço.
- Referer: pode faltar ou mudar por privacidade; QR nem sempre se distingue.
- País/cidade: estimativa geo, sem localização física confirmada.
- Dispositivo/navegador: metadados disponíveis.
- Único/repetido: método e privacidade do produto, sem identificação perfeita de pessoas.
Para links editáveis medidos, prefira redirecionamento temporário como 302 e política de cache adequada. 302 também pode ser cacheado; não garante cada clique futuro. 301 permanente pode esconder visitas e mudanças posteriores. Confira CDN/proxy e Cache-Control, sem confiar apenas no status ou prometer resultado SEO.
Chave exposta permite destinos que prejudicam reputação do domínio. Mantenha criação privada:
- Proteja chaves como senhas; Shlink não exige cadastro público.
- Configure limites API/WAF medidos, sem presumir proteção total.
- Confira criações desconhecidas e picos.
- Dê chaves restritas suportadas aos colaboradores, sem administrador ilimitado por padrão.
Acesso ao redirecionamento e permissão para criar/editar são capacidades diferentes.
Banco, estatísticas e configuração restauram URLs impressas. Para cópia física parada, pause escritores da aplicação primeiro, pare banco e arquive:
cd ~/shlink
docker compose stop shlink-db
tar czf ~/shlink-backup-$(date +%F).tar.gz db docker-compose.yml
docker compose start
Confira tar e reinício mesmo com falhas; inclua segredos privados, versões e demais configurações. Guarde fora do VPS e teste link restaurado.
./db contém MariaDB. Backup lógico com mysqldump ou utilitário MariaDB compatível evita parada completa. O original pede senha e não é confiável como tarefa sem interação:
docker exec shlink-db mariadb-dump -u shlink -p shlink > ~/shlink-$(date +%F).sql
Para automatizar, prepare arquivo de opções restrito e somente leitura no contêiner, com conta exclusiva de backup. Execute por Docker exec mariadb-dump --defaults-extra-file=/run/secrets/backup.cnf --single-transaction shlink, redirecionando para arquivo privado com nome único. Confira status e conteúdo não vazio. Single-transaction exige tabelas transacionais e ausência de mudança de schema incompatível. Teste restauração; nunca publique senha em comandos/logs.
404: confira DEFAULT_DOMAIN, DNS e host real; configuração não inclui esquema/barra.
Sem visitas: confira cache de redirecionamento/CDN e opções de privacidade/bots. Trocar 301 pode não bastar.
Web não conecta: confira SHLINK_SERVER_URL pelo navegador, TLS, CORS e chaves.
Geo falha: confira erro, licença e cota MaxMind reais. SKIP_INITIAL_GEOLITE_DOWNLOAD=true depende da versão, sem opção universal garantida; adie download inicial só se suportado.
WeChat/QQ bloqueia: canal pode restringir reputação/destino. Use processo de recurso aplicável; trocar domínio não garante aceitação. Preserve domínios existentes para outros visitantes.
Novo domínio: adicione junto do antigo, confira links e mantenha registro/DNS anteriores.
Escolha domínio durável, administração privada, monitoramento e backups testados. Controlar serviço não elimina dependência de disponibilidade ou plataformas externas.