☁️ Cloudflare DynDNS Panel

A modern, secure, and feature-rich Dynamic DNS management panel for Cloudflare. Automatically update your DNS records when your IP address changes, with a beautiful web interface and powerful automation features.

✨ Features

🔐 Security First

Secure password hashing with PHP's password_hash()
CSRF protection on all forms
Session-based authentication
API token validation
XSS protection with input sanitization

🌐 Multi-Domain Management

Multiple domains support
Individual proxy settings per domain
Enable/disable domains without deletion
Bulk operations for all domains

🔍 Smart Domain Discovery

Automatic domain browser - no manual ID lookup needed
One-click domain addition from Cloudflare API
Real-time A-record display
Proxy status detection

⏰ Flexible Automation

Configurable update intervals:
- Manual only
- Every 5, 15, 30 minutes
- Every 1, 6, 12 hours
- Daily updates
Automatic cron job generation
IP change detection (only updates when needed)
Comprehensive logging

📊 Advanced Monitoring

Detailed update logs with pagination
Success/failure statistics
Automatic vs manual update tracking
Error reporting with detailed messages

🎨 Modern Interface

Responsive design for all devices
Clean, intuitive UI
Real-time status updates
Copy-to-clipboard functionality

🚀 Quick Start

🐳 Docker Guide

You can run the Cloudflare DynDNS Panel directly from the published GitHub Container Registry image. No local build is required.

1. Pull the image

docker pull ghcr.io/ilovekohl/cloudflare-dyndns-panel:latest

2. Run the container

docker run -d \
  --name cloudflare-dyndns-panel \
  -p 8080:80 \
   ghcr.io/ilovekohl/cloudflare-dyndns-panel:latest

The panel will be available at http://localhost:8080
Adjust the port (8080:80) as needed.
If you want persistent data, mount volumes for the configuration and log files.

3. (Optional) Set up a cron job for automatic updates

You can run the auto-update script inside the container using cron. The container already starts cron automatically.

To add a cron job, you can either:

Use the web panel to generate the cron command and add it to the container's crontab, or
Exec into the container and edit the crontab manually:

docker exec -it cloudflare-dyndns-panel bash
crontab -e
# Paste the cron command from the panel (e.g. */15 * * * * php /var/www/html/auto_update.php)

4. Update and logs

All configuration and logs are stored in the container or in mounted volumes if you add them.
To update the panel, pull the latest image tag again and restart the container.

Manual Installation

Download and extract the files to your web directory:

git clone https://github.com/IloveKOHL/cloudflare-dyndns-panel.git
cd cloudflare-dyndns-panel

Set proper permissions:

chmod 755 *.php
sudo chown -R www-data:www-data /var/www/html
sudo chmod -R 755 /var/www/html
chmod 666 config.json  # Will be created automatically

Access the panel in your web browser:
```
https://yourdomain.com/path/to/panel/
```
First login:
- Default password: changeme
- Change the password immediately after first login!

🔑 Cloudflare API Token Setup

Creating an API Token

Go to Cloudflare Dashboard
Click your profile → "My Profile"
Go to "API Tokens" tab
Click "Create Token"
Choose "Create Custom Token"

Required Permissions

Permissions:
- Zone:Zone:Read
- Zone:DNS:Edit

Zone Resources:
- Include:All zones (or specific zones)

Client IP Address Filtering:
- (Optional) Your server's IP

Why These Permissions?

Zone:Read - List your domains and find Zone IDs
DNS:Edit - Update A records with new IP addresses
No other permissions needed - Maximum security!

📖 Usage Guide

Initial Setup

Login with default password changeme
Change password immediately
Add your Cloudflare API token
Choose update interval (or keep manual)

Adding Domains

Method 1: Domain Browser (Recommended)

Click "Load My Domains"
Select your domain
Click "Show A Records"
Click "Add" next to the record you want to manage

Method 2: Manual Entry

Find your Zone ID in Cloudflare Dashboard
Find your Record ID using browser dev tools or API
Enter the IDs manually in the form

Setting Up Automatic Updates

Choose an interval in the panel
Copy the generated cron command
Add to your crontab:
```
crontab -e
# Paste the copied command
```

Example cron command for 15-minute updates:

*/15 * * * * /usr/bin/php /path/to/your/panel/auto_update.php

📁 File Structure

cloudflare-dyndns-panel/
├── index.php              # Main panel interface
├── update.php              # Manual update script
├── auto_update.php         # Automatic update script (for cron)
├── change_password.php     # Password change interface
├── logs.php               # Update logs viewer
├── api_helper.php         # API communication helper
├── config.json            # Configuration file (auto-created)
├── update_log.json        # Update logs (auto-created)
├── last_ip.txt           # Last known IP (auto-created)
└── README.md              # This file

⚙️ Configuration

The config.json file stores all settings:

{
    "password": "$2y$10$...",           // Hashed password
    "api_token": "your_api_token",      // Cloudflare API token
    "update_interval": "15min",         // Update frequency
    "domains": [                        // Managed domains
        {
            "id": "unique_id",
            "zone_id": "cloudflare_zone_id",
            "record_id": "dns_record_id",
            "name": "dyn.example.com",
            "proxied": true,
            "enabled": true
        }
    ]
}

🔧 Advanced Configuration

Custom PHP Path

If PHP is not in /usr/bin/php, edit the cron command:

*/15 * * * * /custom/path/to/php /path/to/auto_update.php

Logging

Update logs: Stored in update_log.json
Last 100 entries kept automatically
View in panel: Go to "View Update Logs"

IP Change Detection

The system only updates DNS when your IP actually changes:

Current IP stored in last_ip.txt
Saves API calls and reduces logs
Can be disabled by deleting the file

🛠️ Troubleshooting

Common Issues

"Not logged in" Error

Cause: Session expired or cookies disabled
Solution: Clear browser cache and login again

"No API token configured"

Cause: API token not saved or invalid
Solution: Re-enter your API token in the panel

"Network error while fetching zones"

Cause: Invalid API token or network issues
Solution: Check token permissions and internet connection

Cron job not working

Check cron logs: grep CRON /var/log/syslog
Test manually: php auto_update.php
Check PHP path: which php

Debug Mode

Run the auto-update script manually to see detailed output:

php auto_update.php

🔒 Security Considerations

Best Practices

Change default password immediately
Use strong passwords (8+ characters, mixed case, numbers, symbols)
Restrict file permissions: chmod 600 config.json
Use HTTPS for the web interface
Regular token rotation (every 6-12 months)

File Permissions

chmod 755 *.php           # PHP files
chmod 600 config.json     # Configuration (sensitive)
chmod 644 *.json          # Other JSON files
chmod 644 *.txt           # Text files

📊 Monitoring

Update Logs

Access: Click "View Update Logs" in the panel
Information: Timestamp, domain, IP, status, type (auto/manual)
Statistics: Success rate, error count, update frequency

Log Rotation

Automatic: Keeps last 100 entries
Manual cleanup: Delete update_log.json to reset

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Development Setup

Fork the repository
Create a feature branch
Make your changes
Test thoroughly
Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Cloudflare for their excellent API
PHP community for security best practices
Contributors who help improve this project

📞 Support

Issues: GitHub Issues
Documentation: This README and inline comments
Community: Discussions

Made with ❤️ for the self-hosting community

Keep your dynamic DNS records updated automatically and securely!

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
img		img
.dockerignore		.dockerignore
.gitattributes		.gitattributes
.gitignore		.gitignore
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
api_helper.php		api_helper.php
auto_update.php		auto_update.php
change_password.php		change_password.php
docker-entrypoint.sh		docker-entrypoint.sh
edit_domain.php		edit_domain.php
helper-script.sh		helper-script.sh
index.php		index.php
logout.php		logout.php
logs.php		logs.php
test_cron.php		test_cron.php
update.php		update.php

Latest commit

History

Folders and files

Repository files navigation