YOURLS na VPS: encurtador de links com seu domínio
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

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.