willswire/unifi-ddns：Cloudflare DDNS (Dynamic DNS)

项目介绍

willswire/unifi-ddns 是一个托管在 GitHub 上的开源项目，主要使用 TypeScript 编写，采用 MIT License 许可证，目前获得 1.3k 个 Star、3.1k 次 Fork。

仓库全名: willswire/unifi-ddns

README 摘要

🌩️ Cloudflare DDNS for UniFi OS A Cloudflare Worker script that enables UniFi devices (e.g., UDM-Pro, USG) to dynamically update DNS A/AAAA records on Cloudflare. Why Use This? Note: UniFi Network Application 9.1.92+ includes native Cloudflare DDNS support. If your gateway runs this firmware or newer, you may not need this worker. However, the native implementation does not support multi-hostname updates,…

完整内容见 GitHub 原始 README 或本页。

常见问题

unifi-ddns 用什么语言开发？

主要使用 TypeScript 编写，采用 MIT License 许可证，目前有 1.3k 个 Star。

unifi-ddns 可以免费商用吗？

如何获取 unifi-ddns 的源码？

可以直接克隆仓库：git clone https://github.com/willswire/unifi-ddns.git，默认分支为 main；安装与运行步骤见仓库 README。

unifi-ddns 最近还在维护吗？

仓库最近一次更新为 3 小时前，当前有 2 个未关闭 Issue；Star 数为 1.3k，可作为社区活跃度的参考。

关于

cloudflare cloudflare-workers ddns ddns-updater dns ubiquiti unifi unifi-controller

MIT License
1.3k Stars
3.1k Forks
19 Watching

简要分析

热度分

7502

价值分

1705

活跃状态

活跃

GitHub

语言占比

TypeScript

Release

v3.3.13月4日
v3.3.03月4日
v3.2.03月4日
v3.1.12025年4月1日
v3.1.02025年2月18日

贡献者

🌩️ Cloudflare DDNS for UniFi OS

A Cloudflare Worker script that enables UniFi devices (e.g., UDM-Pro, USG) to dynamically update DNS A/AAAA records on Cloudflare.

Why Use This?

Note: UniFi Network Application 9.1.92+ includes native Cloudflare DDNS support. If your gateway runs this firmware or newer, you may not need this worker. However, the native implementation does not support multi-hostname updates, dual-stack (IPv4 + IPv6), or preserving proxy status — this worker remains useful for those use cases and for older firmware.

UniFi devices running older firmware do not natively support Cloudflare as a DDNS provider. This script bridges that gap, allowing your UniFi device to keep your DNS records updated with your public IP address.

🚀 Setup Overview

1. Deploy the Cloudflare Worker

Option 1: Click to Deploy

Click the button above.
Complete the deployment.
Note the *.workers.dev route.

Option 2: Deploy with Wrangler CLI

Clone this repository.
Install Wrangler CLI.
Run:
```
npm i
wrangler login
wrangler deploy
```
Note the *.workers.dev route.

2. Generate a Cloudflare API Token

Go to the Cloudflare Dashboard.
Navigate to Profile > API Tokens
Create a token using the Edit zone DNS template.
Scope the token to one specific zone.
Save the token securely.

3. Configure UniFi OS

Log in to your UniFi OS Controller.
Go to Settings > Internet > WAN > Dynamic DNS.
Create New Dynamic DNS with the following information:
- Service: custom
- Hostname: subdomain.example.com or example.com
- Username: Cloudflare Account Email Address (e.g., [email protected])
- Password: Cloudflare User API Token (not an Account API Token)
- Server: <worker-name>.<worker-subdomain>.workers.dev/update?ip=%i&hostname=%h (Omit https://)

🛠️ Testing & Troubleshooting

Using this script with various Ubiquiti devices and different UniFi software versions can introduce unique challenges. If you encounter issues, start by checking the FAQ in /docs/faq.md. If you don’t find a solution, you can ask a question on the discussions page. If the problem persists, please raise an issue here.

暂无评论

unifi-ddns