# DDNS Documentation - AI/LLM Context

> This file provides structured documentation for AI language models and assistants.

## Project Overview

**Name:** DDNS - Dynamic DNS Client
**Repository:** https://github.com/NewFuture/DDNS
**Documentation:** https://ddns.newfuture.cc
**License:** MIT

## Description

DDNS is a Python-based dynamic DNS client that automatically updates DNS records to match your current IP address. It supports multiple DNS providers including DNSPod, Cloudflare, AliDNS, and many others. The project supports both IPv4 and IPv6, and can be run via command line, Docker, or as a system service.

## Key Features

- Automatic IP detection (IPv4/IPv6)
- Multiple DNS provider support (20+ providers)
- Multiple configuration methods (CLI, Environment Variables, JSON)
- Docker support with multi-architecture images
- Python 2.7+ and 3.x compatible
- Standard library only (no external dependencies)

## Documentation Structure

### Core Documentation
- Homepage: https://ddns.newfuture.cc/
- Installation: https://ddns.newfuture.cc/install
- Docker Guide: https://ddns.newfuture.cc/docker
- Release Notes: https://ddns.newfuture.cc/release

### Configuration Guides
- CLI Arguments: https://ddns.newfuture.cc/config/cli
- Environment Variables: https://ddns.newfuture.cc/config/env
- JSON Configuration: https://ddns.newfuture.cc/config/json

### DNS Provider Guides
- Provider Overview: https://ddns.newfuture.cc/providers/
- DNSPod: https://ddns.newfuture.cc/providers/dnspod
- Cloudflare: https://ddns.newfuture.cc/providers/cloudflare
- ClouDNS: https://ddns.newfuture.cc/providers/cloudns
- AliDNS (Alibaba): https://ddns.newfuture.cc/providers/alidns
- Tencent Cloud: https://ddns.newfuture.cc/providers/tecentcloud
- Huawei Cloud: https://ddns.newfuture.cc/providers/huaweicloud
- Namecheap: https://ddns.newfuture.cc/providers/namecheap
- GoDaddy: https://ddns.newfuture.cc/providers/godaddy
- DynDNS: https://ddns.newfuture.cc/providers/dyndns
- HE.net: https://ddns.newfuture.cc/providers/he
- 51Dns: https://ddns.newfuture.cc/providers/51dns
- Aliesa: https://ddns.newfuture.cc/providers/aliesa
- Callback: https://ddns.newfuture.cc/providers/callback

### Developer Documentation
- Provider Development Guide: https://ddns.newfuture.cc/dev/provider

### Configuration Schemas
- v4.1 Schema: https://ddns.newfuture.cc/schema/v4.1.json

## Usage Examples

### Docker:
```bash
docker run -it --rm -e DNS=dnspod -e ID=your_id -e TOKEN=your_token newfuture/ddns
```

### Command Line:
```bash
ddns --dns dnspod --id your_id --token your_token
```

## Supported DNS Providers

DNSPod, Cloudflare, ClouDNS, AliDNS (Alibaba Cloud), Tencent Cloud, Huawei Cloud, GoDaddy, Namecheap, CloudXNS, HE.net, DynDNS, NoIP, 51Dns, Aliesa, Callback, and more.

## Technical Details

- **Language:** Python 2.7+ and 3.x
- **Dependencies:** Standard library only
- **Platform:** Cross-platform (Windows, Linux, macOS)
- **Docker:** Multi-architecture support (amd64, arm64, arm/v7)

## Links

- GitHub: https://github.com/NewFuture/DDNS
- Documentation: https://ddns.newfuture.cc
- Docker Hub: https://hub.docker.com/r/newfuture/ddns
- PyPI: https://pypi.org/project/ddns/
- Sitemap: https://ddns.newfuture.cc/sitemap.xml

---

*Generated by VitePress documentation builder. Last updated: {{DATE}}*
