DNS Integration for Cloudflare®

Important: This extension is currently in beta, which means the following:

• The extension is provided "as is" for evaluation and testing purposes only. We do not recommend using it in production.
• The extension may crash, lack certain features or polish, and is expected to have bugs.
• Plesk disclaims any form of guarantee or liability in relation to the extension’s use or engineering.
• No technical support is provided.

Want to help us make the extension better? Report bugs, missing features, and any other issues with the extension to [email protected].

Key features

• Import DNS records from Cloudflare to Plesk.
• Export DNS records from Plesk to Cloudflare.
• Once import or export has been performed, the extension automatically syncs changes from Plesk to Cloudflare.
• Creating a subdomain in Plesk automatically imports its DNS records to Cloudflare.
• Enable or disable auto-sync from Plesk to Cloudflare as needed.

Known limitations

• No CDN support at the moment.
• Domains with the .cf, .ga, .gq, .ml, or .tk TLDs (top-level domain) cannot be exported to Cloudflare (because of the Cloudflare API limitations).
• Domains with nonexistent TLDs (for example, example.tld) cannot be exported to Cloudflare (because of the Cloudflare API limitations).
• Subdomains with standalone DNS zones cannot be exported to Cloudflare (because of the Cloudflare API limitations). By default, DNS records for subdomains in Plesk are created in the parent domain’s DNS zone. Such records can be exported.
• Domain aliases cannot be exported to Cloudflare.
• Renaming or removing a domain in Plesk does not rename or remove the corresponding site in Cloudflare.
• IDN domains are not supported.
• If the export finishes with the "Code: 400 Message: Bad Request: Record already exists" warning, enabling Proxy(CDN) may fail with the "This DNS record has not been exported to Cloudflare yet, so this setting is only displayed in Plesk. To export the DNS record to Cloudflare, enable auto-sync" error. To enable the Proxy(CDN) feature, export the domain once again.

Specifics of importing from Cloudflare to Plesk

• Records unsupported by Plesk (CERT, HTTPS, LOC, NAPTR, SMIME, URI, TLSA, SVCB, SSHFP) will not be imported to Plesk.
• NS records in Plesk are replaced with the NS records of a Cloudflare server.
• All records except NS records are removed from Plesk.
• All supported records are imported from Cloudflare to Plesk.
• Custom records in Plesk will be lost.
• Records in Plesk will match those in Cloudflare (except for unsupported ones).
• After a successful import, auto-sync will be enabled by default, and will become active after five minutes. To change the default value (300 sec), add the following lines to the panel.ini file:
• After a successful import, the status can be unavailable for a domain record of the A, AAAA, or CNAME type in the Proxy status column. It may happen if the record contains technical or internal data that Cloudflare cannot transfer to the DNS settings. In this case, you need to edit the corresponding records in Cloudflare and run the import again.

[ext-cloudflaredns]
autoSyncDisableTtl = 300

Specifics of exporting from Plesk to Cloudflare

• The extension will create a site in Cloudflare if it did not exist.
• Unsupported records (CERT, HTTPS, LOC, NAPTR, SMIME, URI, TLSA, SVCB, SSHFP) will remain in Cloudflare.
• All other records will be removed from Cloudflare.
• All records except NS are exported to Cloudflare.
• Records in Cloudflare will match those in Plesk (except for NS records and unsupported records).
• After a successful export, auto-sync will be enabled by default and will become active immediately.

To disable auto-sync (enabled by default), add the following lines to the panel.ini file:

[ext-cloudflaredns]
autoSyncEnable = 0

Showing all domains on a Plesk server to the Plesk administrator

• By default, Plesk filters domains on a server so that the Plesk administator can see only their domains.
• If required, the Plesk administrator can disable filtering of the domains on the Plesk server to see them all. To disable filtering, add the following lines to the panel.ini file:

[ext-cloudflaredns]
adminDomainFilters = 1

• To enable filtering again, remove the adminDomainFilters parameter or set its value to ‘0’.

• Cloudflare, the Cloudflare logo, and Cloudflare Workers are trademarks and/or registered trademarks of Cloudflare, Inc. in the United States and other jurisdictions.

Description of the defaultProxiedEnabledTypes Field (Default CDN-Enabled Record Types):

• With the defaultProxiedEnabledTypes setting, you can specify types of DNS records that will always have the CDN (Content Delivery Network) enabled by default. To do so, you need to add lines of the following pattern to the panel.ini file. You can specify multiple types by separating them with commas, for example:

[ext-cloudflaredns]
defaultProxiedEnabledTypes = A, AAAA, CNAME

• If you configure the extension as in the above example, CDN will be automatically enabled for all A, AAAA, and CNAME DNS records every time DNS records are created or updated.

[ext-cloudflaredns]
defaultSyncableDnsRecordTypes = A, AAAA, CNAME

• If you configure the extension as in the above example, the extension will automatically synchronize all A, AAAA, and CNAME DNS records. Other DNS records will not be synchronized.