Home Explore Help
Register Sign In
Apq
/
DDNS
mirror of https://github.com/NewFuture/DDNS.git
1
0
Fork 0
Files Issues 0 Wiki
Tree: 96b4ca2e0c
Branches Tags
DDNS
/
doc
/
providers
/
debug.en.md

debug.en.md 3.5 KB
History Raw

Debug Provider Configuration Guide

Overview

Debug Provider is a virtual DNS provider specifically designed for debugging and testing purposes. It simulates the DNS record update process but does not perform any actual operations, only outputs relevant information to the console to help developers debug DDNS configuration and functionality.

Official Links:

Important Notice

  • Debug Provider is only for debugging and testing, it does not perform any actual DNS update operations
  • Only prints detected IP addresses and domain information to the console
  • Suitable for verifying configuration file format and IP address detection functionality

Authentication Information

Debug Provider does not require any authentication information, no need to configure id and token parameters.

{
    "dns": "debug"  // Only need to specify provider as debug
}

Complete Configuration Example

{
    "$schema": "https://ddns.newfuture.cc/schema/v4.0.json", // Format validation
    "dns": "debug",                     // Current provider
    "index4": ["url:http://api.ipify.cn", "public"], // IPv4 address source
    "index6": "public",                     // IPv6 address source
    "ipv4": ["ddns.newfuture.cc"],           // IPv4 domains
    "ipv6": ["ipv6.ddns.newfuture.cc"], // IPv6 domains
    "cache": false,                    // Recommend disabling cache for debugging
    "log": {
        "level": "debug"               // Log level
    }
}

Parameter Description

Parameter Description Type Range/Options Default Parameter Type
dns Provider identifier String debug None Provider Parameter
index4 IPv4 source Array Reference default Common Config
index6 IPv6 source Array Reference default Common Config
proxy Proxy settings Array Reference None Common Network
ssl SSL verification Boolean/String "auto", true, false auto Common Network
cache Cache settings Boolean/String true, false, filepath false Common Config
log Log configuration Object Reference None Common Config

Parameter Type Description:

  • Common Config: Standard DNS configuration parameters applicable to all supported DNS providers
  • Common Network: Network setting parameters applicable to all supported DNS providers

Command Line Usage

ddns --debug

Specify Parameters

ddns --dns debug --index4=0 --ipv4=ddns.newfuture.cc --debug

Output Log

INFO  DebugProvider: ddns.newfuture.cc(A) => 192.168.1.100

Error Simulation

Debug Provider also simulates some common error scenarios to help test error handling logic.

Troubleshooting

Common Issues

  • No output information: Check log level settings, ensure DEBUG level is enabled
  • IP detection failed: Check network connection and IP source configuration
  • Configuration format error: Use JSON validation tools to check configuration file format

Support and Resources