Repolode
Enviar
luolongfei

luolongfei/freenom

Renova automaticamente todos os anos domínios gratuitos da Freenom e envia notificações por e-mail, Telegram, WeCom e outros canais.

Ver no GitHub
Estrelas
3,329
Forks
1,542
Issues abertas
81
Último commit
há 16 dias

O que é?

A Freenom oferece domínios de nível superior gratuitos, mas cada um precisa ser renovado manualmente, um ano por vez. Este projeto automatiza a renovação de uma ou mais contas da Freenom, dispensando o controle manual de domínios registrados em momentos diferentes.

Após cada execução, o script envia uma notificação informando se a renovação foi concluída, falhou ou sofreu uma interrupção, além de indicar quantos dias faltam para expirar um domínio ainda não renovado. Os canais compatíveis são e-mail (Gmail, QQ Mail, 163 Mail, Outlook), Telegram Bot, WeCom, ServerChan, Bark e Pushplus. A configuração é feita por meio de um arquivo .env.

A implantação recomendada é com Docker, com imagens para várias arquiteturas de CPU. Também é possível implantar com Docker Compose, no Koyeb ou a partir do código-fonte com PHP 8.1 ou mais recente. As implantações no Heroku, Mogenius e em funções na nuvem são indicadas como inviáveis ou sem suporte ativo.

Recursos principais

  • 01Renovação anual automática para várias contas da Freenom
  • 02Notificações de sucesso, falha e interrupções, incluindo os dias restantes até a expiração
  • 03Canais de e-mail, Telegram Bot, WeCom, ServerChan, Bark e Pushplus
  • 04Imagem Docker para amd64, arm64 e outras arquiteturas
  • 05Configuração por meio de um arquivo .env, com horário de execução configurável

Casos de uso

  • Manter vários domínios gratuitos da Freenom renovados sem esforço manual
  • Executar uma tarefa de renovação pequena e sempre ativa em um VPS, NAS ou Raspberry Pi com Docker
  • Receber alertas sobre o status das renovações no celular pelo Telegram ou Bark

Início rápido

  1. 1

    Instale o Docker no seu servidor (Debian/Ubuntu)

  2. 2

    Execute o contêiner com o comando básico

    docker run -d --name freenom --restart always -v $(pwd):/conf -v $(pwd)/logs:/app/logs luolongfei/freenom
  3. 3

    Configure os canais de notificação e as definições da conta em .env (consulte .env.example)

Antes de usar

  • Os domínios Freenom são gratuitos por apenas um ano de cada vez e precisam ser renovados anualmente.
  • Além de e-mail, há suporte para Telegram, WeCom, ServerChan, Bark e Pushplus; portanto, é necessário configurar pelo menos um canal.
  • Algumas opções de implantação (Mogenius, Cloud Function) não são mais viáveis nem têm suporte.

Tópicos

#domain-renewal#automation#docker#php#telegram-bot#notifications#freenom#auto-renewal#bot#domain

Perguntas frequentes

O que é freenom?
Renova automaticamente todos os anos domínios gratuitos da Freenom e envia notificações por e-mail, Telegram, WeCom e outros canais. A Freenom oferece domínios de nível superior gratuitos, mas cada um precisa ser renovado manualmente, um ano por vez. Este projeto automatiza a renovação de uma ou mais contas da Freenom, dispensando o controle manual de domínios registrados em momentos diferentes.
freenom é gratuito? Qual é a licença?
freenom é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
freenom ainda é mantido?
Manutenção ativa. O último commit de freenom foi em 22 de out. de 2026.
Para que posso usar freenom?
Manter vários domínios gratuitos da Freenom renovados sem esforço manual Executar uma tarefa de renovação pequena e sempre ativa em um VPS, NAS ou Raspberry Pi com Docker Receber alertas sobre o status das renovações no celular pelo Telegram ou Bark
Como instalar freenom?
Instale o Docker no seu servidor (Debian/Ubuntu) Execute o contêiner com o comando básico: docker run -d --name freenom --restart always -v $(pwd):/conf -v $(pwd)/logs:/app/logs luolongfei/freenom Configure os canais de notificação e as definições da conta em .env (consulte .env.example)
Onde consigo freenom?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/luolongfei/freenom

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

Projetos relacionados