weerayuthmc/cloudflare-ddns repository overview

src/
├── domain/                    # Business logic and interfaces
│   ├── entities/             # Domain entities (IpRecord, DnsRecord)
│   ├── interfaces/           # Domain interfaces (IDnsProvider, IIpDiscoveryService)
│   └── services/             # Domain services (DdnsService)
├── infrastructure/           # External concerns
│   ├── adapters/            # Implementation of domain interfaces
│   │   ├── CloudflareDnsAdapter.ts
│   │   ├── MyIpDiscoveryAdapter.ts
│   │   └── MyIpComDiscoveryAdapter.ts
│   └── config/              # Configuration management
├── application/             # Application services
│   └── DdnsApplication.ts   # Main application orchestrator
└── index.ts                # Entry point

docker run -d \
  --name cloudflare-ddns \
  -e CLOUDFLARE_API_TOKEN=your_token \
  -e CLOUDFLARE_ZONE_ID=your_zone_id \
  -e CLOUDFLARE_DNS_RECORD_ID=your_record_id \
  -e CLOUDFLARE_SUB_DOMAIN_NAME=your_subdomain \
  -e CLOUDFLARE_TIME_SLEEP=60000 \
  weerayuthmc/cloudflare-ddns:latest

# Clone the repository
git clone [email protected]:9mc/tools/cloudflare-ddns.git
cd cloudflare-ddns

# Copy and configure environment variables
cp .env .env.local
# Edit .env.local with your actual Cloudflare credentials

# Start the service with Docker Compose
docker compose up -d

# View logs
docker compose logs -f

# Stop the service
docker compose down

# Clone the repository
git clone [email protected]:9mc/tools/cloudflare-ddns.git
cd cloudflare-ddns/src

# Install dependencies
npm install

# Build the project
npm run build

# Set environment variables (see Configuration section)
# ...

# Start the service
npm start

import { IDnsProvider } from '../../domain/interfaces/IDnsProvider';

export class NewDnsProviderAdapter implements IDnsProvider {
  async updateDnsRecord(record: DnsRecord): Promise<DnsUpdateResult> {
    // Implementation here
  }

  getName(): string {
    return 'New DNS Provider';
  }
}

import { IIpDiscoveryService } from '../../domain/interfaces/IIpDiscoveryService';

export class NewIpServiceAdapter implements IIpDiscoveryService {
  async getPublicIp(): Promise<string> {
    // Implementation here
  }

  getName(): string {
    return 'New IP Service';
  }
}

# Install dependencies
npm install

# Start development with hot reload
npm run dev

# Build the project
npm run build

# Clean build artifacts
npm run clean

# Build for development
docker build -t weerayuthmc/cloudflare-ddns:dev .

# Build for production with multi-platform support
docker buildx build --platform linux/amd64,linux/arm64 -t weerayuthmc/cloudflare-ddns:latest .

# Using Docker Compose for local development
docker compose build

# Using Docker Compose with custom environment file
docker compose --env-file .env.local up -d