Freenom Workers Save

⚠ ANNOUNCEMENT

On Feb 7th 2024, freenom has revoked all it's free ccTLD's management perms and started deleting NS & DNS records on all domains, This really is the end. 😢 Project is archived.

2024 年 2 月 7 日， Freenom 回收了所有免费域名的管理权限并开始批量删除所有域名的NS和DNS记录，Freenom免费域名不再可用。本项目封存。

Renew your Freenom domain (.cf .ga .gq .ml .tk) automaticly with Cloudflare Workers.

Set-up

Open your Cloudflare Dashboard

Select "Workers" in the left sidebar on the homepage.

On the Workers tab，choose "Create a Service"，choose your service name，and select a starter (HTTP Handler)。

On the Workers you just created, select "Quick edit".

In the Quick edit interface, copy and paste the code in worker.js and click Save.

Go back to the Workers page you just created and select "Settings" and then "Variables".

On the variables page, add the following variable name and value.

• SECRET_USERNAME" with your Freenom username.
• SECRET_PASSWORD" with your Freenom password.

(Optional) Select the Encryption option for both variables to reduce the probability of leakage for your Freenom username and password.

Return to the created Workers page and select Triggers.

On the Trigger screen, click "Add Cron Trigger". On the Add Cron Trigger page, set up the trigger and save the Settings. The recommended execution time is once a day.

On the same interface, Disable the default route (e.g. servicename.subdomain.worker.dev) in Routes.

Test

(Access through Quick edit) Access your deployed Workers service in the Quice edit interface. You should see the remaining dates of all domain names in your account. Please note that access through preview does not trigger renewal. it should only be used for testing purposes.

(Trigger scheduled event) Enter "Quick Edit", select "Set Time", and then select "Trigger scheduled event". You should see the console outputing the remaining date of the domain. (If a renewable domain is detected, the console will output renewal results.)

Showcase

（Successfully renewed on 2022/12/15）

Known Issues

Please check out this Wiki page.

Planned enhancement

Please check out this Wiki page.

Simliar Projects

https://github.com/luolongfei/freenom (PHP)

https://github.com/Oreomeow/freenom-py (Python)

LICENSE

Currently no LICENSE.