Lightweight Windows tray app for Cloudflare DDNS updates with IPv4/IPv6 support and DNS-only records.
English | 繁體中文
Cloudflare DDNS Tray is a lightweight Windows system tray tool for automatically detecting your current public IP address and updating Cloudflare DNS records.
It is designed for dynamic IP environments such as mobile networks, home networks, small servers, temporary machines, and systems that need a domain name to always resolve to the current public IP.
This tool uses Cloudflare DNS only mode and does not enable Cloudflare Proxy, so the domain resolves to the real public IP address.
Initial public release.
- Added Cloudflare A record update support for IPv4.
- Added Cloudflare AAAA record update support for IPv6.
- Added automatic public IP detection.
- Added separate IPv4 and IPv6 tracking.
- Added update skipping when the current public IP has not changed.
- Added manual Update Now function.
- Added configurable check interval.
- Added Windows system tray resident mode.
- Added minimize-to-tray behavior.
- Added startup with Windows support.
- Added Cloudflare API Token storage protected by Windows DPAPI.
- Added optional Zone ID field.
- Added Traditional Chinese and English interface.
- Fixed Cloudflare DNS records to DNS only mode to avoid Proxy affecting real-IP DDNS usage.
Cloudflare DDNS Tray is a native Windows DDNS helper for Cloudflare-managed domains.
When your public IP changes, the tool automatically updates the selected Cloudflare DNS record so your domain continues to point to the latest public IP address.
For example:
home.example.com -> current public IPv4 / IPv6
This is useful when your ISP provides a dynamic IP address, or when a device is used in a mobile network environment where the public IP may change over time.
- Lightweight Windows tray application.
- Native C++ Win32 implementation.
- No .NET dependency.
- Supports Windows 7 / Windows 10 / Windows 11.
- Supports Cloudflare A record update for IPv4.
- Supports Cloudflare AAAA record update for IPv6.
- Automatically detects the current public IP.
- IPv4 and IPv6 are tracked separately.
- Skips Cloudflare API update when the public IP has not changed.
- Manual Update Now button.
- Configurable automatic check interval.
- Runs quietly in the system tray.
- Supports startup with Windows.
- Supports minimize to tray when clicking the close button.
- Stores Cloudflare API Token locally with Windows DPAPI protection.
- Uses DNS only mode and does not enable Cloudflare Proxy.
- Built-in Traditional Chinese and English interface.
The Home page shows the configured domain, current update IP, automatic update countdown, network status, and execution log.
The Settings page allows you to configure the Cloudflare API Token, root domain, host / record name, record type, TTL, Zone ID, check interval, language, startup behavior, and tray behavior.
-
Download
CloudflareDDNSTray.exefrom the Releases page. -
Put the executable in a fixed folder.
-
Run the program.
-
Create a Cloudflare API Token.
-
Enter your Cloudflare API Token, root domain, and host / record name.
-
Select the record type:
A (IPv4)for IPv4 DDNSAAAA (IPv6)for IPv6 DDNS
-
Save settings.
-
Click Update Now or enable automatic update.
-
Optionally enable startup with Windows and system tray mode.
Recommended Cloudflare API Token permissions:
Zone / Zone / Read
Zone / DNS / Edit
Recommended Zone Resources setting:
Include / Specific zone / your-domain.com
The API Token should be limited to the specific domain zone that needs DDNS updates.
Do not use the Global API Key.
Cloudflare DDNS Tray always uses DNS only mode.
It does not enable Cloudflare Proxy.
This is intentional because DDNS normally requires the domain to resolve to the real public IP address.
If Cloudflare Proxy is enabled, the domain may resolve to Cloudflare edge IP addresses instead of your real public IP, which may break IP-based verification, direct connection, VPN, remote access, or other real-IP DDNS use cases.
- Home networks with dynamic IP addresses.
- Mobile network computers.
- Vehicle PCs or mobile workstations.
- Small servers without a fixed IP.
- Temporary servers or test machines.
- Systems that need a domain name to point to the current public IP.
- IP / domain-based authentication environments.
- Users who need a simple Cloudflare DDNS updater without installing a Windows service.
src/ Native C++ Win32 source code
assets/ Icons and screenshot assets
assets/screenshots/ README cover images and screenshots
app.rc Windows resource file
CMakeLists.txt CMake build configuration
Local/private build scripts are intentionally not included because they are specific to the author's local build environment.
Recommended build command:
cmake -S . -B build-win32 -G "Visual Studio 17 2022" -A Win32
cmake --build build-win32 --config ReleaseThe executable will usually be generated under:
build-win32\Release\CloudflareDDNSTray.exe
Download the latest release from:
Release files may include:
CloudflareDDNSTray.exe
CloudflareDDNSTray-SHA256-latest.txt
On Windows, you can verify the downloaded file with:
certutil -hashfile CloudflareDDNSTray.exe SHA256Compare the result with the SHA256 checksum file provided in the release assets.
This tool stores the Cloudflare API Token locally using Windows DPAPI protection.
The token is still a sensitive credential. Please create a Cloudflare API Token with minimum required permissions and restrict it to the specific zone you want to update.
Do not upload your real API Token, configuration file, log file, or private build files to GitHub.
- Designed for Windows 7 / Windows 10 / Windows 11.
- Cloudflare API access requires HTTPS support on the local Windows system.
- Very old or unpatched Windows 7 environments may require TLS-related system updates.
- Zone ID can be left empty in normal use; the tool can query it automatically.
- The DNS record must exist in Cloudflare before updating.
- This tool is intended for legitimate DDNS and network maintenance usage.
Cloudflare DDNS, Cloudflare dynamic DNS, Windows DDNS tray, Cloudflare DNS only, IPv4 DDNS, IPv6 DDNS, A record updater, AAAA record updater, public IP updater, Windows tray app, native C++ Win32, dynamic IP, Cloudflare API Token, DPAPI, DNS automation.
Cloudflare DDNS Tray 是一個輕量化的 Windows 系統列工具，可自動偵測目前公開 IP，並同步更新指定的 Cloudflare DNS 記錄。
它適合用在動態 IP、行動網路、家中網路、小型伺服器、臨時主機，或需要讓網域名稱永遠解析到目前公開 IP 的環境。
本工具固定使用 Cloudflare DNS only，不啟用 Cloudflare Proxy，確保網域會解析到真實公開 IP。
首次公開版本。
- 新增 Cloudflare A 記錄 IPv4 更新功能。
- 新增 Cloudflare AAAA 記錄 IPv6 更新功能。
- 新增目前公開 IP 自動偵測功能。
- 新增 IPv4 與 IPv6 分開記錄與判斷。
- 新增 IP 未變更時自動略過更新，避免重複提交 Cloudflare API。
- 新增手動立即更新功能。
- 新增自訂檢查間隔。
- 新增 Windows 系統列常駐模式。
- 新增按右上角 X 時縮小到系統列。
- 新增 Windows 開機自動啟動。
- 新增 Cloudflare API Token 使用 Windows DPAPI 保護儲存。
- 新增 Zone ID 可選填欄位。
- 新增繁體中文與 English 介面。
- 固定使用 Cloudflare DNS only，避免 Proxy 影響真實 IP DDNS 用途。
Cloudflare DDNS Tray 是一個原生 Windows Cloudflare DDNS 輔助工具。
當公開 IP 變動時，工具會自動更新指定的 Cloudflare DNS 記錄，讓你的網域持續指向最新的公開 IP。
例如：
home.example.com -> 目前公開 IPv4 / IPv6
這適合用在 ISP 提供動態 IP 的環境，或車機、行動網路、臨時主機等公開 IP 可能變動的情境。
- 輕量化 Windows 系統列工具。
- 原生 C++ Win32 實作。
- 不需要 .NET。
- 支援 Windows 7 / Windows 10 / Windows 11。
- 支援 Cloudflare A 記錄更新 IPv4。
- 支援 Cloudflare AAAA 記錄更新 IPv6。
- 自動偵測目前公開 IP。
- IPv4 與 IPv6 分開記錄與判斷。
- IP 未變更時自動略過 Cloudflare API 更新。
- 支援手動立即更新。
- 支援自訂自動檢查間隔。
- 可安靜常駐系統列。
- 支援 Windows 開機自動啟動。
- 支援按關閉按鈕時縮小到系統列。
- API Token 使用 Windows DPAPI 保護並儲存在本機。
- 固定使用 DNS only，不啟用 Cloudflare Proxy。
- 內建繁體中文與 English 介面。
主頁會顯示目前設定域名、目前更新 IP、下次自動更新倒數、網路狀態與執行紀錄。
設定頁可設定 Cloudflare API Token、根網域、主機 / 記錄名稱、記錄類型、TTL、Zone ID、檢查間隔、語言、開機啟動與系統列行為。
-
從 Releases 頁面下載
CloudflareDDNSTray.exe。 -
將執行檔放到固定資料夾。
-
執行程式。
-
建立 Cloudflare API Token。
-
輸入 Cloudflare API Token、根網域與主機 / 記錄名稱。
-
選擇記錄類型：
A (IPv4)用於 IPv4 DDNSAAAA (IPv6)用於 IPv6 DDNS
-
儲存設定。
-
按下立即更新，或啟用自動更新。
-
可選擇啟用 Windows 開機自動啟動與系統列常駐。
建議 Cloudflare API Token 權限：
Zone / Zone / Read
Zone / DNS / Edit
建議 Zone Resources 設定：
Include / Specific zone / your-domain.com
API Token 建議只限制在需要 DDNS 更新的指定網域。
不要使用 Global API Key。
Cloudflare DDNS Tray 固定使用 DNS only 模式。
本工具不會啟用 Cloudflare Proxy。
這是刻意設計，因為 DDNS 通常需要網域解析到真實公開 IP。
如果啟用 Cloudflare Proxy，網域可能會解析到 Cloudflare 節點 IP，而不是真實公開 IP，可能會影響 IP 驗證、直接連線、VPN、遠端連線或其他需要真實 IP 的 DDNS 用途。
- 家中網路使用動態 IP。
- 行動網路電腦。
- 車用電腦或行動工作站。
- 沒有固定 IP 的小型伺服器。
- 臨時伺服器或測試主機。
- 需要讓指定網域指向目前公開 IP。
- 需要通過 IP / 網域綁定認證的環境。
- 想要使用簡單 Cloudflare DDNS 更新工具，但不想安裝 Windows Service。
src/ 原生 C++ Win32 原始碼
assets/ 圖示與截圖資源
assets/screenshots/ README 封面圖與截圖
app.rc Windows 資源檔
CMakeLists.txt CMake 編譯設定
本專案未包含本機私人編譯批次檔，因為該檔案與作者本機編譯環境相關。
建議使用以下方式編譯：
cmake -S . -B build-win32 -G "Visual Studio 17 2022" -A Win32
cmake --build build-win32 --config Release執行檔通常會產生於：
build-win32\Release\CloudflareDDNSTray.exe
請從 Releases 頁面下載最新版本：
發佈檔案可能包含：
CloudflareDDNSTray.exe
CloudflareDDNSTray-SHA256-latest.txt
在 Windows 可使用以下指令驗證下載檔案：
certutil -hashfile CloudflareDDNSTray.exe SHA256請將結果與 Releases 附件中的 SHA256 驗證檔內容比對。
本工具會使用 Windows DPAPI 保護 Cloudflare API Token，並儲存在本機。
API Token 仍然屬於敏感憑證。請建立最小必要權限的 Cloudflare API Token，並限制只能操作指定 Zone。
請不要將真實 API Token、設定檔、log 檔案或私人編譯檔案上傳到 GitHub。
- 主要針對 Windows 7 / Windows 10 / Windows 11 設計。
- Cloudflare API 存取需要本機 Windows 系統支援 HTTPS。
- 過舊或未更新的 Windows 7 環境，可能需要 TLS 相關系統更新。
- 一般使用時 Zone ID 可留空，程式可自動查詢。
- 要更新的 DNS 記錄需要先在 Cloudflare 中建立。
- 本工具用途為合法 DDNS 與網路維護使用。
Cloudflare DDNS、Cloudflare dynamic DNS、Windows DDNS tray、Cloudflare DNS only、IPv4 DDNS、IPv6 DDNS、A 記錄更新、AAAA 記錄更新、公開 IP 更新、Windows 系統列工具、原生 C++ Win32、動態 IP、Cloudflare API Token、DPAPI、DNS 自動化。
This repository is released under the MIT License. See LICENSE.