W7-DDNS 用户使用指南



系统介绍

W7-DDNS 是一个免费、简单、快速的动态 DNS (DDNS) 解决方案，帮助您将动态 IP 地址映射到固定的域名，让您可以通过域名访问您的设备或服务。

主要特性

  • ✅ 简单易用：无需复杂配置，几分钟内完成设置
  • ✅ 多平台支持：支持 Windows、Linux、macOS 等多种操作系统
  • ✅ 快速响应：低至1秒TTL，快速响应IP变化
  • ✅ IPv4/IPv6 双栈支持：同时支持 IPv4 和 IPv6 地址解析
  • ✅ 自动更新：客户端自动检测IP变化并更新DNS记录
  • ✅ 安全可靠：使用 JWT 认证，保障账户安全

快速开始

1. 访问系统

在浏览器中打开系统首页（默认地址：https://w7ddns.dynatop.top/）

2. 注册账户

点击页面右上角的"用户注册"按钮，填写以下信息：

  • 用户名：3-20个字符，只能包含字母、数字和下划线
  • 密码：至少6个字符
  • 验证码：输入图片中显示的验证码

点击"注册"按钮完成注册。

💡 提示：注册成功后，系统会自动为您分配一个免费子域名。


3. 登录系统

使用注册的用户名和密码登录系统。

用户注册与登录

注册新账户

  1. 访问系统首页
  2. 点击"用户注册"按钮
  3. 填写注册信息：
  • 用户名（3-20个字符）
  • 密码（至少6个字符）
  • 验证码
  1. 点击"注册"按钮
  2. 注册成功后自动登录

登录账户

  1. 访问系统首页
  2. 点击"用户登录"按钮
  3. 输入用户名和密码
  4. 输入验证码
  5. 点击"登录"按钮

退出登录

在用户中心页面，点击右上角的用户名，选择"退出登录"。

域名管理

查看域名信息

登录后，进入"我的域名"页面，您可以查看：

  • 域名：您的完整域名（如：abc123.ddns.dynatop.top）
  • 备注：域名的备注信息
  • IPv4 解析：当前 IPv4 地址和最后更新时间
  • IPv6 解析：当前 IPv6 地址和最后更新时间
  • 有效期：域名到期时间（永久域名显示"永久"）
  • 创建时间：域名创建时间

创建域名

如果您还没有域名，可以点击"创建域名"按钮创建新域名。

  1. 点击"创建域名"按钮
  2. 填写域名信息：
  • 域名：自动分配
  • 备注：可选，用于记录域名的用途
  • 启用 IPv4：是否启用 IPv4 解析（默认启用）
  • 启用 IPv6：是否启用 IPv6 解析（默认不启用）
  1. 点击"创建"按钮


编辑域名

  1. 在域名列表中，找到要编辑的域名
  2. 点击"编辑"按钮
  3. 修改域名信息：
  • 备注：可以修改备注信息
  • 启用 IPv4：可以启用或禁用 IPv4 解析
  • 启用 IPv6：可以启用或禁用 IPv6 解析
  1. 点击"保存"按钮
⚠️ 注意：域名本身不能修改，只能修改备注和IP解析设置。


删除域名

  1. 在域名列表中，找到要删除的域名
  2. 点击"删除"按钮
  3. 确认删除操作
⚠️ 警告：删除域名后，所有DNS记录将被清除，且无法恢复。请谨慎操作！


编译客户端

编译客户端程序

客户端程序用于自动检测您的IP地址变化并更新DNS记录。

编译步骤

  1. 进入"编译管理"页面
  2. 选择要使用的域名（如果只有一个域名，会自动选择）
  3. 选择目标平台：
  • Windows：适用于 Windows 系统
  • Linux：适用于 Linux 系统（需要选择架构：amd64、arm64等）
  • macOS：适用于 macOS 系统（需要选择架构：amd64、arm64等）
  1. 点击"开始编译"按钮
  2. 等待编译完成（通常需要几秒到几十秒）
  3. 编译完成后，点击"下载"按钮下载客户端程序

编译限制

  • 每个用户每天有编译次数限制
  • 编译次数在每天 00:00 重置
  • 编译次数用完后，需要等到第二天才能继续编译
💡 提示：编译次数限制是为了防止滥用系统资源。如果您的编译次数已用完，请联系系统管理员。


查看编译历史

在"编译管理"页面，您可以查看所有历史编译记录：

  • 编译时间：编译请求的时间
  • 域名：使用的域名
  • 平台：目标平台和架构
  • 状态：编译状态（处理中、成功、失败）
  • 操作：下载或删除编译结果

客户端使用

Windows 系统

  1. 下载 Windows 版本的客户端程序（如：w7-ddns-client-windows-amd64.exe）
  2. 将程序放到任意目录（建议放在固定位置，如：C:\Program Files\w7-ddns\）
  3. 双击运行程序
  4. 程序会自动：
  • 检测您的公网 IP 地址
  • 每5分钟检查一次IP是否变化
  • 如果IP变化，自动更新DNS记录
💡 提示：建议将客户端程序添加到系统启动项，实现开机自启动。


添加开机自启动（Windows）

  1. 按 Win + R 打开运行对话框
  2. 输入 shell:startup 并回车
  3. 将客户端程序的快捷方式复制到打开的文件夹中

Linux 系统

  1. 下载 Linux 版本的客户端程序（如：w7-ddns-client-linux-amd64）
  2. 将程序上传到服务器或本地Linux系统
  3. 赋予执行权限：
chmod +x w7-ddns-client-linux-amd64
  1. 运行程序：
./w7-ddns-client-linux-amd64

使用 systemd 管理（Linux）

创建服务文件 /etc/systemd/system/w7-ddns-client.service：

[Unit]
Description=W7-DDNS Client
After=network.target

[Service]
Type=simple
User=your-user
WorkingDirectory=/path/to/client
ExecStart=/path/to/client/w7-ddns-client-linux-amd64
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

启用并启动服务：

sudo systemctl daemon-reload
sudo systemctl enable w7-ddns-client
sudo systemctl start w7-ddns-client

查看服务状态：

sudo systemctl status w7-ddns-client

macOS 系统

  1. 下载 macOS 版本的客户端程序（如：w7-ddns-client-darwin-amd64 或 w7-ddns-client-darwin-arm64）
  2. 打开终端，进入程序所在目录
  3. 赋予执行权限：
chmod +x w7-ddns-client-darwin-amd64
  1. 运行程序：
./w7-ddns-client-darwin-amd64

使用 launchd 管理（macOS）

创建 plist 文件 ~/Library/LaunchAgents/com.w7ddns.client.plist：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.w7ddns.client</string>
    <key>ProgramArguments</key>
    <array>
        <string>/path/to/client/w7-ddns-client-darwin-amd64</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
</dict>
</plist>

加载服务：

launchctl load ~/Library/LaunchAgents/com.w7ddns.client.plist

客户端工作原理

客户端程序会：

  1. 启动时：立即检测当前IP地址并更新DNS记录
  2. 运行中：每5分钟检测一次IP地址
  3. IP变化时：自动向服务器发送更新请求
  4. 更新成功：DNS记录在1秒内生效（TTL=1）

验证DNS解析

编译并运行客户端后，您可以通过以下方式验证DNS解析是否正常：

使用 ping 命令

# Windows
ping your-domain.ddns.dynatop.top

# Linux/macOS
ping your-domain.ddns.dynatop.top

使用 nslookup 命令

# Windows
nslookup your-domain.ddns.dynatop.top

# Linux/macOS
nslookup your-domain.ddns.dynatop.top

使用 dig 命令（Linux/macOS）

dig your-domain.ddns.dynatop.top

如果返回的IP地址与您当前的公网IP地址一致，说明DNS解析正常。

域名续费

续费说明

域名到期后，DNS解析将停止工作。

续费步骤

  1. 进入"我的域名"页面
  2. 找到需要续费的域名
  3. 点击"续费"按钮
  4. 输入激活码
  5. 点击"确认续费"按钮

购买激活码

  1. 在"我的域名"页面，点击"购买激活码"按钮
  2. 跳转到激活码购买页面
  3. 购买激活码后，使用激活码进行续费

续费规则

  • 使用激活码续费时，域名有效期会延长激活码对应的天数
  • 如果域名已过期，续费后立即恢复DNS解析
  • 永久域名不需要续费，也不会显示"续费"按钮

常见问题

Q1: 注册时提示"用户名已存在"怎么办？

A: 该用户名已被其他用户使用，请尝试使用其他用户名。

Q2: 为什么我无法创建域名？

A: 可能的原因：

  • 子域名格式不正确（必须是12个小写字母）
  • 子域名已被其他用户使用

Q3: 客户端运行后，DNS解析不生效？

A: 请检查：

  1. 客户端是否正常运行（查看程序输出或日志）
  2. 客户端是否能访问服务器（检查网络连接）
  3. 域名是否已启用对应的IP类型（IPv4/IPv6）
  4. 等待1-2分钟，DNS记录可能需要时间传播

Q4: 如何查看我的域名当前解析的IP地址？

A: 在"我的域名"页面，可以查看：

  • IPv4 解析：显示当前IPv4地址和最后更新时间
  • IPv6 解析：显示当前IPv6地址和最后更新时间

Q5: 编译次数用完了怎么办？

A: 编译次数每天重置。如果您的编译次数已用完，可以：

  • 等待到第二天（00:00后）再编译
  • 联系系统管理员增加编译次数限制

Q6: 域名到期了怎么办？

A: 域名到期后：

  1. DNS解析将停止工作
  2. 您需要购买激活码进行续费
  3. 续费后，DNS解析会立即恢复

Q7: 如何修改域名的IP解析设置？

A: 在"我的域名"页面，点击"编辑"按钮，可以：

  • 启用或禁用 IPv4 解析
  • 启用或禁用 IPv6 解析

Q8: 客户端程序需要一直运行吗？

A: 是的，客户端程序需要持续运行才能自动检测IP变化并更新DNS记录。建议：

  • Windows：添加到开机自启动
  • Linux：使用 systemd 管理
  • macOS：使用 launchd 管理

Q9: 如何查看客户端是否正常工作？

A: 检查方法：

  1. 查看客户端程序的输出日志
  2. 在"我的域名"页面查看IP地址和最后更新时间
  3. 使用 ping 或 nslookup 命令验证DNS解析

Q10: 支持哪些操作系统？

A: 客户端支持：

  • Windows（amd64）
  • Linux（amd64、arm64等）
  • macOS（amd64、arm64）

具体支持的架构取决于编译时选择的目标平台。

技术支持

如果您在使用过程中遇到问题，可以：

  1. 查看"使用帮助"页面，查看系统管理员提供的帮助文档
  2. 联系系统管理员获取技术支持
  3. 查看系统日志（需要访问权限）