Base de Conhecimento

YOURLS na VPS: encurtador de links com seu domínio

  • yourls, encurtador de links, domínio curto, nginx, vps
  • Usuários acharam útil: 0

YOURLS 1.10.6 sob licença MIT: requisitos, instalação com Nginx, PHP e MariaDB, domínio curto com HTTPS, modo privado, backup antes de atualizar e a atualização.

Por Redação Eleven Host · @robson.direitodigital · 13 de novembro de 2026 · 10 min de leitura

Arte da Eleven Host: janela de terminal com o título: YOURLS na VPS: encurtador de links com seu domínio

Capa da Redação Eleven Host para o guia: YOURLS na VPS: encurtador de links com seu domínio Arte: Eleven Host

YOURLS na VPS é um encurtador de links de código aberto, em PHP, que roda no seu servidor e cria links curtos com o seu próprio domínio, com estatísticas de cliques. Veja os requisitos, a instalação, o HTTPS, a segurança, o backup e a atualização.

Atualizado em 13/11/2026. Os comandos abaixo são exemplos: confira cada um no seu servidor antes de aplicar. O artigo O que é registro de domínio e como funciona explica o registro passo a passo.

O que é o YOURLS

O repositório oficial o descreve como scripts PHP para ter o seu próprio encurtador de URLs. Cada link longo vira um link curto no seu domínio, e a instalação registra os cliques.

O YOURLS usa a licença MIT. Em 13/11/2026, a versão estável é a 1.10.6, publicada em 30/08/2026, e é a tag usada nos exemplos.

A 1.10.6 só corrigiu a identificação de versão da 1.10.5, que ainda se apresentava como 1.10.5-dev. As correções de segurança relevantes chegaram na 1.10.5, e por isso recomendamos a 1.10.6 em instalação nova. Há também uma imagem oficial no Docker Hub, com a tag 1.10.6, mas o passo a passo abaixo é a instalação manual.

Requisitos oficiais

A documentação pede PHP 8.1 ou mais novo e MySQL 5.5 ou mais novo, ou MariaDB 10.0 ou mais novo. O servidor web é o Apache 2.4 ou mais novo com o módulo mod_rewrite. A página de configuração do servidor traz também um bloco de Nginx, que é o usado aqui. HTTPS é recomendado, não exigido.

O arquivo composer.json da tag 1.10.6 exige as extensões PHP dom, filter, hash, pcre, pdo e pdo_mysql.

Os comandos supõem um servidor Ubuntu, com acesso de administrador pelo sudo. Se ainda não tem um, o artigo O que é servidor VPS: guia simples para iniciantes ajuda a entender o que contratar.

Domínio curto apontado antes do certificado

O YOURLS pede uma YOURLS_SITE sem barra no fim e em minúsculas, e não se deve misturar a versão com www e a sem www no navegador. Na raiz do domínio, o YOURLS não pode dividir o espaço com outro aplicativo que reescreva endereços, como o WordPress.

Crie o registro DNS do tipo A do domínio curto apontando para o IP da VPS antes de pedir o certificado: o Certbot precisa que o nome já chegue ao servidor e que a porta 80 esteja acessível. Para um domínio novo, veja Domínio para loja virtual: como escolher e registrar.

Um domínio curto, com centenas de extensões, pode ser pesquisado e registrado na Eleven Host. Buscar domínio

Pacotes e banco de dados

A documentação fala em criar um banco novo (ou usar um existente) para o YOURLS. Um exemplo de instalação dos pacotes; confira os nomes no seu Ubuntu:

sudo apt update && sudo apt upgrade -y

sudo apt install -y nginx mariadb-server php-fpm php-mysql php-xml php-mbstring php-curl php-bcmath php-gmp php-intl unzip curl

php -v

sudo mysql_secure_installation

O php -v deve mostrar a versão 8.1 ou mais nova. Depois, um exemplo de banco e usuário próprios, trocando SENHA-FORTE por uma senha sua:

sudo mysql -e "CREATE DATABASE yourls CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'yourls'@'localhost' IDENTIFIED BY 'SENHA-FORTE'; GRANT ALL PRIVILEGES ON yourls.* TO 'yourls'@'localhost'; FLUSH PRIVILEGES;"

Download e config.php

O arquivo oficial de cada versão está na página de releases do GitHub. Um exemplo de comandos, com a tag fixa 1.10.6; confira o nome da pasta extraída antes de mover:

cd /tmp && curl -LO https://github.com/YOURLS/YOURLS/archive/refs/tags/1.10.6.tar.gz

tar xzf 1.10.6.tar.gz && sudo mv YOURLS-1.10.6 /var/www/yourls

sudo cp /var/www/yourls/user/config-sample.php /var/www/yourls/user/config.php

openssl rand -hex 32

O último comando gera um texto aleatório para a YOURLS_COOKIEKEY. A documentação também indica o gerador em yourls.org/cookie. Edite o user/config.php, por exemplo com sudo nano, e ajuste estas linhas:

define( 'YOURLS_DB_USER', 'yourls' );

define( 'YOURLS_DB_PASS', 'SENHA-FORTE' );

define( 'YOURLS_DB_NAME', 'yourls' );

define( 'YOURLS_DB_HOST', 'localhost' );

define( 'YOURLS_SITE', 'https://curto.exemplo.com' );

define( 'YOURLS_PRIVATE', true );

define( 'YOURLS_COOKIEKEY', 'cole-aqui-o-texto-gerado' );

$yourls_user_passwords = [ 'admin' => 'senha-longa-aqui' ];

Troque a chave do cookie antes de abrir a área de administração pela primeira vez. A YOURLS_SITE leva https://, o mesmo host que você vai usar no navegador e nenhuma barra no fim. Depois, dê a pasta ao usuário do servidor web, para o PHP poder gravar nela:

sudo chown -R www-data:www-data /var/www/yourls

Nginx com o socket do PHP instalado

O bloco da documentação aponta para php7.2-fpm.sock, que está desatualizado, e a própria doc manda editar esse trecho. Veja o socket do PHP instalado com ls /run/php/. Como o Nginx não sobe com certificado que ainda não existe, comece só com a porta 80; o Certbot acrescenta o HTTPS depois. Um exemplo, adaptado do bloco oficial, em /etc/nginx/sites-available/yourls; troque 8.3 pela sua versão:

server {

listen 80;

listen [::]:80;

server_name curto.exemplo.com;

root /var/www/yourls;

index index.php;

location / {

try_files $uri $uri/ /yourls-loader.php$is_args$args;

}

location ~ \.php$ {

include fastcgi.conf;

fastcgi_index index.php;

fastcgi_pass unix:/run/php/php8.3-fpm.sock;

}

}

A linha index index.php; é um acréscimo ao bloco oficial, que tenta evitar o erro 403 em /admin/; confira no seu servidor. Com o bloco da documentação, a raiz dá 403 por desenho, e o acesso à administração exige /admin/index.php. Para ativar e conferir:

sudo ln -s /etc/nginx/sites-available/yourls /etc/nginx/sites-enabled/

sudo nginx -t && sudo systemctl reload nginx

HTTPS com Certbot

A instalação do Certbot para Nginx, em snap, segue a página do Certbot; se o pacote do apt estiver instalado, remova-o antes com sudo apt-get remove certbot.

sudo snap install --classic certbot

sudo ln -s /snap/bin/certbot /usr/local/bin/certbot

sudo certbot --nginx

Primeiro acesso e senhas

Abra https://curto.exemplo.com/admin/index.php e siga o procedimento de instalação do YOURLS. A senha do config.php está em texto puro. Na próxima execução do YOURLS, a documentação diz que o arquivo é reescrito com hashes, desde que o PHP consiga gravar nele. Se ele estiver bloqueado, aparece o erro Could not auto-encrypt passwords.

Depois do primeiro acesso, confira se a senha virou hash e restrinja a permissão, como a doc cita (ela dá o chmod 600 como exemplo):

grep phpass /var/www/yourls/user/config.php

sudo chmod 600 /var/www/yourls/user/config.php

A linha deve mostrar o usuário com o valor começando por phpass:. Se o grep não mostrar nada, a senha continua em texto puro: confira o dono do arquivo. Por fim, teste a renovação do certificado:

sudo certbot renew --dry-run

Segurança: modo privado e versões

Mantenha o YOURLS privado

O YOURLS_PRIVATE em true protege a área de administração com usuário e senha. No modo público, a área fica livre para quem tiver o endereço, o que a doc reserva a testes ou a uma intranet privada. Encurtador aberto atrai spam, e a documentação avisa que o provedor de hospedagem pode acabar fechando a conta. Para um serviço aberto, ela sugere manter a instalação privada, pôr uma interface pública na raiz, instalar plugins antispam da lista Awesome YOURLS e considerar um captcha.

Os avisos oficiais mostram por que a versão importa. Até a 1.10.4, sem YOURLS_COOKIEKEY definida, quem soubesse o caminho do arquivo e um usuário forjava o cookie de administrador sem senha. A imagem Docker oficial até essa versão assinava os cookies com uma chave pública. Também até a 1.10.4 havia uma falha de inclusão de arquivo sem login, e até a 1.10.3 uma falha de XSS nas estatísticas de referrers. As correções saíram até a 1.10.5.

Se você já tem uma instalação antiga, atualize e defina uma chave nova. Trocar a YOURLS_COOKIEKEY desconecta as sessões abertas. A página de avisos do repositório pede a quem rodou com a chave fixa que revise ações de administrador que não fez.

API e plugins

A API fica em https://curto.exemplo.com/yourls-api.php, por GET ou POST. As ações são shorturl, expand, url-stats, stats, db-stats e version, e as respostas saem em jsonp, json, xml ou simple; este último só vale para shorturl, expand e version. A autenticação usa username e password ou o token de assinatura, que fica na página Tools. O token só serve para a API, não para entrar no painel, e para invalidá-lo troca-se a YOURLS_COOKIEKEY.

Os plugins ficam em uma subpasta de user/plugins, e a documentação indica a lista Awesome YOURLS.

Backup do banco e da pasta user

A documentação de atualização só manda fazer o backup do banco, e a nota da versão 1.10.5 repete o aviso. Recomendamos guardar também a pasta user, que tem o config.php com a senha do banco, a YOURLS_COOKIEKEY e os hashes, além de plugins e páginas. Sem a mesma chave de cookie, sessões e token da API mudam. Um exemplo de cópia:

sudo mysqldump --single-transaction yourls > yourls-$(date +%F).sql

sudo tar czf yourls-user-$(date +%F).tar.gz -C /var/www/yourls user

Leve as duas cópias para fora do servidor, porque os arquivos têm segredos: proteja o acesso a elas.

Como atualizar

O procedimento oficial tem cinco passos: backup do banco, baixar o arquivo da última versão, descompactá-lo, enviá-lo por cima da instalação, sem afetar os arquivos de usuário como a configuração e os plugins, e abrir /admin/. Um exemplo, com NOVA no lugar da tag; faça antes o backup acima:

cd /tmp && curl -LO https://github.com/YOURLS/YOURLS/archive/refs/tags/NOVA.tar.gz

tar xzf NOVA.tar.gz

sudo cp -r YOURLS-NOVA/. /var/www/yourls/

sudo chown -R www-data:www-data /var/www/yourls

Onde cada peça se encaixa

O encurtador usa um servidor web, o PHP, o banco e o domínio curto. Para comparar onde um sistema em PHP pode ficar, veja Onde hospedar sistema PHP: como escolher.

Servidor virtual da Eleven Host: VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS

Perguntas frequentes

O YOURLS é gratuito?

O código é aberto, sob a licença MIT. Servidor e domínio são contratados à parte.

Qual versão do PHP o YOURLS pede?

PHP 8.1 ou mais novo, segundo a documentação, com MySQL 5.5 ou mais novo ou MariaDB 10.0 ou mais novo.

Posso usar Nginx em vez de Apache?

Sim. A página de configuração do servidor traz um bloco de Nginx, que precisa de ajustes, como o socket do PHP.

Qual versão instalar?

Em 13/11/2026, a 1.10.6, de 30/08/2026. Versões até a 1.10.4 têm falhas de segurança corrigidas até a 1.10.5.

Esta resposta lhe foi útil?

Artigos Relacionados