Como instalar o Shlink no Saplo (o teu próprio encurtador de links com estatísticas)

O Bitly, num plano pago, pode custar bem mais de 100 euros por mês, antes sequer de ultrapassares o limite de links encurtados, porque a cobrança depende do número de endereços ativos e dos cliques. O Shlink é um encurtador de links de código aberto, a mesma ideia do Bitly, mas instalado no teu próprio Box, com pagamento único, sem limite de endereços e sem fatura mensal. Abaixo, passo a passo, como instalar o Shlink na Saplo.

Porquê usar o Shlink no teu próprio Box em vez do Bitly

Os planos pagos do Bitly têm duas características que são especialmente problemáticas em campanhas de marketing e no acompanhamento de links a longo prazo:

• limite do número de links encurtados e cliques por mês - o plano gratuito chega para uma campanha isolada, mas não para um ano inteiro de trabalho de uma agência,
• dados sobre os cliques guardados por uma empresa externa - as estatísticas de tráfego das tuas campanhas ficam nos servidores do Bitly, e não na tua infraestrutura.

Shlink é o mesmo mecanismo de encurtamento de links e contagem de cliques que instalas no teu próprio Box. Sem limite do número de endereços, os dados sobre os cliques ficam na tua infraestrutura, e um domínio próprio para encurtar links parece mais profissional do que um bit.ly genérico.

Requisitos

Para instalar o Shlink no Saplo, precisas de:

• Box com o Docker em execução (o motor ativa-o automaticamente durante a instalação a partir do catálogo, sendo necessário o aninhamento num contentor, que o Saplo inclui por predefinição),
• pelo menos 512 MB de RAM livres no Box e 2 GB de espaço em disco,
• um domínio ou subdomínio *.saploapp.pl incluído no preço de cada plano, de preferência curto, porque será visível em cada link curto.

Vale a pena distinguir desde logo o que o Shlink é e o que não é. O Shlink é, por si só, uma API REST e um servidor de redirecionamentos de links curtos. No Saplo, recebes o Shlink junto com o painel oficial acessível no navegador, que fica no endereço da aplicação e está protegido por palavra-passe, por isso não tens de instalar nem configurar nada. Para a própria instalação, não precisas de qualquer base de dados externa, porque, por predefinição, o Shlink guarda os dados num ficheiro SQLite local no volume de dados. Opcionalmente, podes escolher a base de dados MySQL partilhada do Saplo, se contares com um volume elevado de tráfego.

Instalação passo a passo

1. No Painel Saplo, entra no Catálogo de aplicações e escolhe Shlink (categoria "Ferramentas").
2. Indica o Box onde deve ficar instalado, bem como o domínio ou subdomínio sob o qual os links encurtados vão funcionar, e escolhe a base de dados: SQLite (por predefeição, sem qualquer infraestrutura adicional) ou MySQL (base de dados partilhada da Saplo, melhor para tráfego elevado).
3. Confirma a instalação. O motor cria dois contentores Docker com as imagens oficiais shlinkio/shlink e shlinkio/shlink-web-client (painel), gera uma chave API aleatória e uma palavra-passe para o painel, e disponibiliza tudo no domínio indicado através do nginx com SSL gratuito.
4. O motor espera que o Shlink responda de facto a um pedido de estado de saúde, e que o faça duas vezes, antes de considerar a instalação concluída, pois a primeira execução exige uma migração do esquema da base de dados, que pode demorar mais do que alguns segundos.
5. Quando terminar, nos dados de arranque da aplicação (ficheiro SHLINK-SETUP.txt), encontrarás o nome de utilizador e a palavra-passe do painel, bem como a chave API.

Primeira configuração

Shlink, tal como Grafana ou MinIO, gera os dados de acesso automaticamente durante a instalação, em vez de os pedir num assistente.

1. Abre os dados de inicialização da aplicação no painel Saplo (ficheiro SHLINK-SETUP.txt), onde encontrarás o nome de utilizador, a palavra-passe e a chave de API.
2. Clica Abrir junto à aplicação, inicia sessão e seleciona o servidor Meus links. O servidor já está associado à chave de API, não tens de preencher nada.
3. Cria o primeiro link curto no separador de criação de links, opcionalmente com o teu próprio código curto em vez de uma sequência aleatória de caracteres.
4. Consulta as estatísticas de cliques e o código QR do link criado. Ambas as funcionalidades estão integradas e disponíveis logo após a instalação.

Os links curtos funcionam no mesmo domínio sem palavra-passe, que protege apenas o painel. O teu próprio código curto não pode chamar-se server, settings, assets nem icons, porque esses endereços são reservados pelo painel.

Se preferires automatizar em vez de clicar na interface, podes fazer o mesmo diretamente através da REST API, por exemplo, criar um link curto com um único comando:

curl -s -X POST 'https://seu-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 no Saplo vs. Bitly

Perguntas frequentes

O Shlink tem um Painel web para iniciar sessão como o WordPress ou o Ghost? Sim. Na Saplo, no endereço da aplicação, está instalado o Painel oficial do Shlink, protegido por palavra-passe. O nome de utilizador e a palavra-passe estão no ficheiro SHLINK-SETUP.txt. Também podes adicionar o mesmo servidor no cliente app.shlink.io ou geri-lo através da REST API com a chave desse ficheiro.

Existe um limite para o número de links encurtados? Não. O Shlink não impõe qualquer limite ao número de endereços ou cliques. A única limitação são os recursos do Box contratado.

Posso ver de que país vieram os cliques no link? Por defeito, não. A geolocalização das visitas exige uma chave própria e gratuita da MaxMind, que não pode ser criada automaticamente durante a instalação. Sem ela, o Shlink conta os cliques normalmente, mas sem informação sobre o país de quem visita.

Qual é a diferença entre SQLite e MySQL durante a instalação? SQLite é um ficheiro de base de dados no volume de dados, sem necessidade de infraestrutura adicional, e chega para a maioria dos casos. MySQL é uma base de dados partilhada da Saplo, uma escolha a fazer apenas quando o volume de cliques for realmente elevado.

Os dados do Shlink têm cópias de segurança automáticas? Depende do plano escolhido para o Box. O backup funciona ao nível de todo o Box, tal como nas outras aplicações do Catálogo de aplicações, e não é uma funcionalidade separada do Shlink.

Se tiveres dúvidas ao instalar o Shlink no teu próprio Box ou ao fazer a primeira configuração do Painel, escreve-nos. Ajudamos-te com a configuração inicial.