rouroux/freenom-automatic-renewal

freenom-automatic-renewal（免费域名自动续期）

镜像概述和主要用途

freenom-automatic-renewal是一款基于Docker的工具，用于实现Freenom免费域名的自动续期。它能够定时检测并续期即将到期的域名，支持多账户管理，并可通过邮件或***推送续期状态通知，帮助用户避免因忘记续期导致域名丢失。

核心功能和特性

• 自动续期：定时执行域名续期任务，无需人工干预
• 多账户支持：可配置多个Freenom账户，统一管理续期
• 通知机制：支持邮件（Gmail/QQ/163/Outlook等）和*** Bot推送续期结果
• 灵活调度：可自定义执行时间，默认随机时间避免服务器压力
• 跨平台支持：兼容多种架构（linux/amd64、arm64、armv7等），适用于VPS、群晖、威联通、树莓派等设备
• 配置自动迁移：升级镜像时自动更新配置文件并保留原有设置

使用场景和适用范围

• 拥有Freenom免费域名且希望自动续期的个人用户
• 需要管理多个Freenom账户的用户
• 希望通过邮件或***接收续期状态通知的用户
• 拥有服务器、NAS或树莓派等设备并熟悉Docker基本操作的用户

详细使用方法和配置说明

快速部署（适用于熟悉Docker的用户）

基础部署命令

shell
docker run -d --name freenom --restart always -v $(pwd):/conf -v $(pwd)/logs:/app/logs rouroux/freenom-automatic-renewal

自定义执行时间部署

shell
docker run -d --name freenom --restart always -v $(pwd):/conf -v $(pwd)/logs:/app/logs -e RUN_AT="11:24" rouroux/freenom-automatic-renewal

注意：不推荐自定义时间，默认会在北京时间06~23点随机执行，避免集中请求Freenom服务器。RUN_AT参数支持CRON格式（如"9 11 * * *"表示每天11:09执行）。

完整部署教程（适用于新手用户）

1. 安装Docker

1.1 准备环境

根据系统类型执行以下命令更新源并安装基础工具：

Debian/Ubuntu：

shell
apt-get update && apt-get install -y wget vim

CentOS：

shell
yum update && yum install -y wget vim

1.2 安装Docker

执行一键安装脚本：

shell
wget -qO- get.docker.com | bash

说明：仅支持KVM架构VPS，OpenVZ架构不支持。CentOS 8不适用此脚本，建议参考Docker官方安装指南。

1.3 配置Docker服务

shell
# 启动Docker
systemctl start docker

# 查看运行状态
systemctl status docker

# 设置开机自启
systemctl enable docker

2. 部署续期服务

2.1 创建并启动容器

执行基础部署命令：

shell
docker run -d --name freenom --restart always -v $(pwd):/conf -v $(pwd)/logs:/app/logs rouroux/freenom-automatic-renewal

2.2 配置.env文件

容器启动后，当前目录会生成.env配置文件和logs日志目录。编辑.env文件设置账户信息和通知方式：

shell
vim .env

关键配置项说明：

更多配置项：参考https://github.com/luolongfei/freenom/blob/main/.env.example%E6%96%87%E4%BB%B6%E6%B3%A8%E9%87%8A%E3%80%82

2.3 验证配置

修改配置后重启容器并查看日志：

shell
# 重启容器
docker restart freenom

# 查看日志
docker logs freenom

日志中出现“执行成功”字样表示配置正确。

升级与管理

升级镜像

在.env文件所在目录执行以下命令：

shell
docker rm -f freenom && docker rmi -f rouroux/freenom-automatic-renewal && docker run -d --name freenom --restart always -v $(pwd):/conf -v $(pwd)/logs:/app/logs rouroux/freenom-automatic-renewal

程序会自动更新.env文件并迁移原有配置。

常用Docker命令

shell
# 查看容器状态和大小
docker ps -as

# 查看实时日志
docker logs -f freenom

# 重启容器
docker restart freenom

# 停止容器
docker stop freenom

# 删除容器
docker rm -f freenom

# 查看容器资源占用
docker stats --no-stream

支持环境

• 架构：linux/amd64、linux/arm/v6、linux/arm/v7、linux/arm64、linux/386、linux/ppc64le、linux/s390x
• 设备：VPS、群晖、威联通、树莓派等支持Docker的设备

最近更新

• 2022年11月15日：基于https://github.com/luolongfei/freenom/ v0.5.1制作镜像

鸣谢

• 原始项目：https://github.com/luolongfei/freenom%EF%BC%88PHP%E8%87%AA%E5%8A%A8%E7%BB%AD%E6%9C%9F%E8%84%9A%E6%9C%AC%EF%BC%89
• 开发支持：JetBrains Open Source license

https://github.com/luolongfei/freenom#-%E9%80%9A%E8%BF%87-docker-%E9%83%A8%E7%BD%B2