Repolode
Enviar
luolongfei

luolongfei/freenom

Renueva automáticamente cada año dominios gratuitos de Freenom y envía notificaciones por email, Telegram, WeCom y otros canales.

Ver en GitHub
Estrellas
3,329
Forks
1,542
Issues abiertos
81
Último commit
hace 16 días

¿Qué es?

Freenom ofrece dominios de nivel superior gratuitos, pero hay que renovar cada uno manualmente, año a año. Este proyecto automatiza la renovación de una o varias cuentas de Freenom, para que no tengas que llevar un seguimiento manual de los dominios registrados en distintas fechas.

Después de cada ejecución, el script envía una notificación tanto si la renovación se completa como si falla o se interrumpe inesperadamente. También indica cuántos días quedan para que venza un dominio que no se haya renovado. Los canales compatibles son email (Gmail, QQ Mail, 163 Mail, Outlook), Telegram Bot, WeCom, ServerChan, Bark y Pushplus. La configuración se realiza mediante un archivo .env.

Se recomienda implementar el proyecto con Docker, que cuenta con imágenes para varias arquitecturas de CPU. También puede implementarse con Docker Compose, en Koyeb o desde el código fuente con PHP 8.1 o posterior. Las implementaciones en Heroku, Mogenius y funciones en la nube se consideran inviables o ya no reciben soporte activo.

Funciones clave

  • 01Renovación anual automática para varias cuentas de Freenom
  • 02Notificaciones de éxito, error e interrupciones inesperadas, con los días que faltan para el vencimiento
  • 03Canales de email, Telegram Bot, WeCom, ServerChan, Bark y Pushplus
  • 04Imagen de Docker para amd64, arm64 y otras arquitecturas
  • 05Configuración mediante un archivo .env y una hora de ejecución configurable

Casos de uso

  • Mantener renovado un conjunto de dominios gratuitos de Freenom sin hacerlo manualmente
  • Ejecutar una tarea de renovación pequeña y permanente en un VPS, NAS o Raspberry Pi con Docker
  • Recibir alertas sobre el estado de las renovaciones en el teléfono mediante Telegram o Bark

Inicio rápido

  1. 1

    Instala Docker en tu servidor (Debian/Ubuntu)

  2. 2

    Ejecuta el contenedor con el comando básico

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

    Configura los canales de notificación y los ajustes de la cuenta en .env (consulta .env.example)

Antes de usarlo

  • Los dominios de Freenom son gratuitos solo durante un año cada vez y deben renovarse anualmente.
  • Además del correo electrónico, se admiten Telegram, WeCom, ServerChan, Bark y Pushplus, por lo que debes configurar al menos un canal.
  • Algunas opciones de despliegue (Mogenius, Cloud Function) ya no son viables ni reciben soporte.

Temas

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

Preguntas frecuentes

¿Qué es freenom?
Renueva automáticamente cada año dominios gratuitos de Freenom y envía notificaciones por email, Telegram, WeCom y otros canales. Freenom ofrece dominios de nivel superior gratuitos, pero hay que renovar cada uno manualmente, año a año. Este proyecto automatiza la renovación de una o varias cuentas de Freenom, para que no tengas que llevar un seguimiento manual de los dominios registrados en distintas fechas.
¿freenom es gratuito? ¿Qué licencia tiene?
freenom es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿freenom sigue mantenido?
Mantenimiento activo. El último commit de freenom fue el 22 oct 2026.
¿Para qué puedo usar freenom?
Mantener renovado un conjunto de dominios gratuitos de Freenom sin hacerlo manualmente Ejecutar una tarea de renovación pequeña y permanente en un VPS, NAS o Raspberry Pi con Docker Recibir alertas sobre el estado de las renovaciones en el teléfono mediante Telegram o Bark
¿Cómo se instala freenom?
Instala Docker en tu servidor (Debian/Ubuntu) Ejecuta el contenedor con el comando básico: docker run -d --name freenom --restart always -v $(pwd):/conf -v $(pwd)/logs:/app/logs luolongfei/freenom Configura los canales de notificación y los ajustes de la cuenta en .env (consulta .env.example)
¿Dónde consigo freenom?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/luolongfei/freenom

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados