🔍 Cloudflare DNS Records Export Tool

This Python script retrieves all DNS records from your Cloudflare account, filtered by Account Name, and saves them into a CSV file. It uses parallel processing to speed up DNS record collection and includes built-in support for containerized environments (e.g., Docker).

---

🚀 Features

• ✅ Authenticates using a Cloudflare API token (via environment variable)
• 🔍 Filters zones by your Cloudflare Account Name
• 📄 Exports DNS records (A, CNAME, MX, TXT, etc.) into a clean CSV format
• ⚡ Fast DNS record fetching using ThreadPoolExecutor
• 📁 Compatible with containerized environments (e.g., output defaults to /app)
• 🔄 Handles pagination for large Cloudflare accounts

---

🧠 Requirements

• Python 3.7+ *Cloudflare API token with at least Zone.Read and DNS.Read permissions *Installed Python packages: requests

---

Install dependencies:

pip install requests

---

🔐 Environment Variables

Variable	Description	Required
API_KEY	Cloudflare API token (with read permissions)	✅ Yes
ACCOUNT_NAME	Name of the Cloudflare account to filter zones	✅ Yes
OUTPUT_FILENAME_PREFIX	Custom prefix for the output CSV file name (e.g., CF_DNS_Export)	✅ Yes
OUTPUT_DIR	(Optional) Directory to store the output file (default: /app)	❌ No

Set environment variables (example on Linux/macOS):

export API_KEY=your_cloudflare_token
export ACCOUNT_NAME="Your Corp Name"
export OUTPUT_FILENAME_PREFIX=CF_DNS_Export

---

🧪 Example Usage

Once your environment is set up:

python export_dns_records.py

Sample Output:

Output file will be saved to: /app/CF_DNS_Export.csv
Fetching zones...
Fetched page 1, 12 matching zones
Total zones fetched: 12
Fetching DNS records...
Writing data to /app/CF_DNS_Export.csv...
Done!

🗃️ Output

The script generates a CSV file named:

<OUTPUT_FILENAME_PREFIX>.csv

The file will contain the following columns:

Zone Name	Hostname	DNS Type	DNS Value

Example row:

example.com, www.example.com, A , 192.0.2.1

💡 Notes

• The script uses pagination to fetch zones in chunks of 100.
• If the OUTPUT_FILENAME_PREFIX is not provided via env, the script will prompt you to enter it.
• It automatically sanitizes the filename (e.g., removes spaces and slashes).\

🧵 Threading

DNS record fetching is parallelized using Python's ThreadPoolExecutor for faster execution.

🐳 Docker Compatibility

If you're using this script inside a Docker container:

• Make sure /app exists and is mounted as a volume.
• The default output directory will be /app.\

❓Troubleshooting

• No zones returned: Make sure your ACCOUNT_NAME matches exactly what's shown in the Cloudflare dashboard.
• Empty CSV: Your API token might lack Zone and DNS permissions.

🤝 Contributing

Pull requests are welcome. For major changes:

• Fork the repo
• Create a feature branch
• Test your changes
• ubmit a PR with context

📝 License

This project is licensed under the MIT License

📬 Contact

For issues, questions, or feature requests, please contact: Author: Mainul Hossain Email: hossainmainul83@gmail.com