yangzhaofengsteven/aliyun-ddns
yangzhaofengsteven
阿里云动态域名解析工具，利用阿里云解析API实现域名解析动态更新（类似花生壳），支持client-mode（推荐，部署简单无需服务器）和server-mode（适合无Node.js环境客户端），定时将域名解析更新为当前公网IP，无npm依赖，仅使用Node.js原生模块。
下载次数: 0状态：社区镜像维护者：yangzhaofengsteven仓库类型：镜像最近更新：6 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
aliyun-ddns
镜像概述
aliyun-ddns是一款基于阿里云解析API实现动态域名解析功能的工具，类似花生壳服务，可定时将域名解析记录更新为当前网络环境的公网IP地址。该工具无npm依赖，仅使用Node.js原生模块（http、***、url），提供两种运行模式以适应不同场景需求。
核心功能与特性
- 动态域名解析：定时更新阿里云域名解析记录至当前公网IP
- 双模式支持：
- client-mode：客户端直接运行，通过公共API获取公网IP，部署简单，无需服务器资源
- server-mode：服务端部署，客户端通过访问服务端更新IP，适合无Node.js环境的客户端（如路由器）
- 轻量无依赖：仅使用Node.js原生模块，无需额外安装npm包
- 定时任务支持：可通过crontab设置定时执行，实现IP自动更新
使用前提
- 域名需由阿里云/万网托管
- 若需将IP设置为客户端公网IP，客户端需分配非大内网IP（大内网IP可联系ISP更换）
Client Mode
使用场景
适用于本地设备（如家庭NAS、树莓派等），通过定时执行客户端程序，自动获取当前网络公网IP并更新阿里云DNS记录。
部署步骤（crontab定时调用）
- 复制配置样本：
cp client-mode/config-sample.json client-mode/config.json - 编辑配置文件
client-mode/config.json（参数说明见下文） - 创建执行脚本（参考
client-mode/client.sh） - 赋予脚本执行权限：
chmod 775 client-mode/client.sh - 编辑crontab：
crontab -e - 添加定时任务（每5分钟执行一次）：
*/5 * * * * /path/to/client-mode/client.sh - 重启cron服务：
systemctl restart cron（或根据系统调整命令）
client-mode/config.json 参数说明
| 参数 | 说明 |
|---|---|
| AccessKeyId | 阿里云控制台获取的AccessKey ID，需妥善保管 |
| AccessKeySecret | 阿里云控制台获取的AccessKey Secret，需妥善保管 |
| hostnames | 需更新的DNS（子）域名列表，支持多个域名 |
Server Mode
使用场景
适用于需在公有云（如阿里云、AWS）部署服务端，本地设备（如路由器、树莓派）通过定时访问服务端更新IP的场景，尤其适合客户端无Node.js环境的情况。
服务端部署
手动部署
- 复制配置样本：
cp server-mode/config-sample.json server-mode/config.json - 编辑配置文件
server-mode/config.json（参数说明见下文） - 使用进程管理工具启动（如pm2）：
pm2 start server-mode/app.js
Docker部署
若运行环境支持Docker，可直接使用docker-compose启动：
yaml# docker-compose.yml 示例 version: '3' services: aliyun-ddns-server: image: docker.xuanyuan.run/[镜像名称] # 替换为实际镜像名称 volumes: - ./server-mode/config.json:/app/server-mode/config.json ports: - "3000:3000" # 根据配置文件中的port参数调整 restart: always
执行启动命令：docker-compose up -d
- 网络配置：配置Nginx反向代理、防火墙等，确保服务可公网访问
server-mode/config.json 参数说明
| 参数 | 说明 |
|---|---|
| AccessKeyId | 阿里云控制台获取的AccessKey ID，需妥善保管 |
| AccessKeySecret | 阿里云控制台获取的AccessKey Secret，需妥善保管 |
| clientIpHeader | 反向代理环境下获取客户端IP的请求头（如Nginx的X-Real-IP），无反向代理可不填 |
| path | 自定义访问路径，默认为 /hack |
| port | 服务端监听端口 |
客户端调用方式
基于配置文件中的path属性（默认/hack），支持两种调用方式：
-
自动获取客户端IP：
http://[服务端域名或IP]:[port]/hack?hostname=foo.bar.com
效果：将foo.bar.com解析更新为客户端公网IP -
指定IP更新：
http://[服务端域名或IP]:[port]/hack?hostname=foo.bar.com&ip=xxx.xxx.xxx.xxx
效果：将foo.bar.com解析更新为指定IPxxx.xxx.xxx.xxx
客户端定时调用（crontab）
- 创建执行脚本（参考
server-mode/client.sh），内容示例：bash#!/bin/bash curl "http://[服务端域名或IP]:[port]/hack?hostname=foo.bar.com" - 赋予脚本执行权限：
chmod 775 server-mode/client.sh - 编辑crontab：
crontab -e - 添加定时任务（每5分钟执行一次）：
*/5 * * * * /path/to/server-mode/client.sh - 重启cron服务：
systemctl restart cron
安全事项
server-mode下服务端API未实现身份验证，直接暴露阿里云解析修改权限，需确保访问路径（path）足够复杂且隐藏，避免被未授权访问。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 aliyun-ddns 镜像标签
docker pull docker.xuanyuan.run/yangzhaofengsteven/aliyun-ddns:<标签>
DockerHub 原生拉取命令
docker pull yangzhaofengsteven/aliyun-ddns:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"