Repolode
Enviar
thedevs-network

thedevs-network/kutt

Kutt é um encurtador de URLs que você pode hospedar por conta própria, com domínios personalizados, estatísticas de links, painel de administração e API RESTful.

Alternativa open source a:Bitly

Ver no GitHubSite
Estrelas
11,161
Forks
1,514
Issues abertas
88
Último commit
há 3 dias

O que é?

Kutt é um encurtador de URLs que você pode executar no seu próprio servidor ou usar pelo serviço hospedado kutt.to. Ele permite criar e editar links curtos, definir URLs personalizadas, senhas, descrições e prazos de expiração, além de consultar estatísticas privadas de cada link. Administradores podem gerenciar usuários e links em uma página de administração dedicada.

Para hospedar por conta própria, Kutt precisa apenas do Node.js 20 ou posterior e usa SQLite por padrão, com suporte opcional a Postgres, MySQL ou MariaDB e Redis para cache. Há arquivos Docker Compose para várias configurações de banco de dados, e o app é configurado por meio de variáveis de ambiente. É possível desativar o cadastro, os links anônimos e o login com e-mail e senha; o login via OpenID Connect também é compatível.

Kutt também oferece uma API RESTful, suporte a temas personalizados por meio de uma pasta `/custom` para CSS, imagens e templates Handlebars, além de extensões de navegador para Chrome e Firefox. Há clientes da comunidade para linguagens como Python, Go, Rust e C#.

Recursos principais

  • 01Suporte a domínios personalizados para links curtos
  • 02Criar, editar e excluir links com URLs personalizadas, senhas e prazo de expiração
  • 03Estatísticas privadas para cada URL encurtada
  • 04Página de administração para gerenciar usuários e links
  • 05API RESTful para gerenciar links programaticamente
  • 06Compatibilidade com SQLite, Postgres e MySQL/MariaDB, com cache Redis opcional

Casos de uso

  • Hospedar um encurtador de URLs privado para uma equipe ou organização no próprio domínio
  • Encurtar links com estatísticas e manter os dados na própria infraestrutura
  • Adicionar a criação de links curtos a scripts ou apps por meio da API
  • Restringir uma instância a usuários convidados desativando o cadastro e os links anônimos

Início rápido

  1. 1

    Clone este repositório ou baixe o arquivo zip mais recente

  2. 2

    Instale as dependências

    npm install
  3. 3

    Inicialize o banco de dados

    npm run migrate
  4. 4

    Inicie o app para desenvolvimento (ou use npm start em produção)

    npm run dev

Antes de usar

  • É necessário ter o Node.js 20 ou superior.
  • Em produção, JWT_SECRET deve ser definido como uma string longa e aleatória.
  • O cadastro fica desativado por padrão. Para que novos usuários possam se cadastrar, é necessário habilitar o e-mail.

Tópicos

#url-shortener#link-shortener#nodejs#self-hosted#docker#rest-api#shorten-urls#shortener#urlshortener

Perguntas frequentes

O que é kutt?
Kutt é um encurtador de URLs que você pode hospedar por conta própria, com domínios personalizados, estatísticas de links, painel de administração e API RESTful. Kutt é um encurtador de URLs que você pode executar no seu próprio servidor ou usar pelo serviço hospedado kutt.to. Ele permite criar e editar links curtos, definir URLs personalizadas, senhas, descrições e prazos de expiração, além de consultar estatísticas privadas de cada link. Administradores podem gerenciar usuários e links em uma página de administração dedicada.
kutt é gratuito? Qual é a licença?
kutt é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
kutt ainda é mantido?
Manutenção ativa. O último commit de kutt foi em 19 de out. de 2026.
Para que posso usar kutt?
Hospedar um encurtador de URLs privado para uma equipe ou organização no próprio domínio Encurtar links com estatísticas e manter os dados na própria infraestrutura Adicionar a criação de links curtos a scripts ou apps por meio da API Restringir uma instância a usuários convidados desativando o cadastro e os links anônimos
Como instalar kutt?
Clone este repositório ou baixe o arquivo zip mais recente Instale as dependências: npm install Inicialize o banco de dados: npm run migrate Inicie o app para desenvolvimento (ou use npm start em produção): npm run dev
Onde consigo kutt?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/thedevs-network/kutt

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados