charles94jp/ddns

NameSilo DDNS Docker镜像文档

镜像概述

NameSilo DDNS是针对NameSilo域名的动态域名系统（DDNS）服务，专为家庭宽带用户设计。它能够自动检测家庭宽带IP地址的变化，并自动更新NameSilo域名的解析记录，确保域名始终指向当前有效的IP地址。

核心功能与特性

• 自动IP检测：实时监测家庭宽带公网IP地址变化
• 自动解析更新：IP变化时自动同步更新NameSilo域名解析记录
• 日志记录：完整记录服务运行状态及IP更新过程
• 邮件通知：支持通过邮件发送IP变更通知
• IPv6支持：兼容IPv6网络环境，可处理IPv6地址解析

使用场景与适用范围

• 家庭服务器（如NAS、个人网站、游戏服务器）的动态IP绑定
• 需要通过域名远程访问家庭设备的场景
• 家庭宽带无固定公网IP，但需通过域名提供服务的用户
• 对网络稳定性有要求，需要自动维护域名解析的场景

使用方法与配置说明

前提条件

• 拥有NameSilo域名
• 已获取NameSilo API密钥（可在NameSilo账户设置中生成）
• （可选）邮件服务器信息（用于邮件通知功能）

Docker Run命令示例

bash
docker run -d \
  --name namesilo-ddns \
  -e DOMAIN="example.com" \  # 需更新的域名
  -e API_KEY="your_namesilo_api_key" \  # NameSilo API密钥
  -e CHECK_INTERVAL=300 \  # IP检测间隔（秒），默认300秒
  -e EMAIL_ENABLE=true \  # 是否启用邮件通知
  -e SMTP_SERVER="smtp.example.com" \  # SMTP服务器地址
  -e SMTP_PORT=587 \  # SMTP端口
  -e SMTP_USER="your_email@example.com" \  # 发件人邮箱
  -e SMTP_PASSWORD="your_email_password" \  # 邮箱密码/授权码
  -e RECIPIENT_EMAIL="recipient@example.com" \  # 收件人邮箱
  --restart unless-stopped \
  charles94jp/namesilo-ddns

Docker Compose配置示例

yaml
version: '3'
services:
  namesilo-ddns:
    image: charles94jp/namesilo-ddns
    container_name: namesilo-ddns
    environment:
      - DOMAIN=example.com
      - API_KEY=your_namesilo_api_key
      - CHECK_INTERVAL=300
      - EMAIL_ENABLE=true
      - SMTP_SERVER=smtp.example.com
      - SMTP_PORT=587
      - SMTP_USER=your_email@example.com
      - SMTP_PASSWORD=your_email_password
      - RECIPIENT_EMAIL=recipient@example.com
    restart: unless-stopped

配置参数说明

项目地址

GitHub: https://github.com/Charles94jp/NameSilo-DDNS