yangzhaofengsteven/aliyun-ddns Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

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定时调用）

1. 复制配置样本：cp client-mode/config-sample.json client-mode/config.json
2. 编辑配置文件 client-mode/config.json（参数说明见下文）
3. 创建执行脚本（参考 client-mode/client.sh）
4. 赋予脚本执行权限：chmod 775 client-mode/client.sh
5. 编辑crontab：crontab -e
6. 添加定时任务（每5分钟执行一次）：*/5 * * * * /path/to/client-mode/client.sh
7. 重启cron服务：systemctl restart cron（或根据系统调整命令）

client-mode/config.json 参数说明

Server Mode

使用场景

适用于需在公有云（如阿里云、AWS）部署服务端，本地设备（如路由器、树莓派）通过定时访问服务端更新IP的场景，尤其适合客户端无Node.js环境的情况。

服务端部署

手动部署

1. 复制配置样本：cp server-mode/config-sample.json server-mode/config.json
2. 编辑配置文件 server-mode/config.json（参数说明见下文）
3. 使用进程管理工具启动（如pm2）：pm2 start server-mode/app.js

Docker部署

若运行环境支持Docker，可直接使用docker-compose启动：

yaml
# docker-compose.yml 示例
version: '3'
services:
  aliyun-ddns-server:
    image: [镜像名称]  # 替换为实际镜像名称
    volumes:
      - ./server-mode/config.json:/app/server-mode/config.json
    ports:
      - "3000:3000"  # 根据配置文件中的port参数调整
    restart: always

执行启动命令：docker-compose up -d

4. 网络配置：配置Nginx反向代理、防火墙等，确保服务可公网访问

server-mode/config.json 参数说明

客户端调用方式

基于配置文件中的path属性（默认/hack），支持两种调用方式：

1. 自动获取客户端IP：http://[服务端域名或IP]:[port]/hack?hostname=foo.bar.com
   效果：将foo.bar.com解析更新为客户端公网IP

2. 指定IP更新：http://[服务端域名或IP]:[port]/hack?hostname=foo.bar.com&ip=xxx.xxx.xxx.xxx
   效果：将foo.bar.com解析更新为指定IP xxx.xxx.xxx.xxx

客户端定时调用（crontab）

1. 创建执行脚本（参考 server-mode/client.sh），内容示例：

   bash
   #!/bin/bash
   curl "http://[服务端域名或IP]:[port]/hack?hostname=foo.bar.com"
   

2. 赋予脚本执行权限：chmod 775 server-mode/client.sh
3. 编辑crontab：crontab -e
4. 添加定时任务（每5分钟执行一次）：*/5 * * * * /path/to/server-mode/client.sh
5. 重启cron服务：systemctl restart cron

安全事项

server-mode下服务端API未实现身份验证，直接暴露阿里云解析修改权限，需确保访问路径（path）足够复杂且隐藏，避免被未授权访问。