CDN¶
CDN Settings Tab¶
If you currently use a content delivery network, you can configure LSCWP so that it works together with your CDN.
QUIC.cloud CDN¶
OFF
Turn this option ON
to use LiteSpeed's QUIC.cloud CDN. You don't need to do anything else on this page.
Use CDN Mapping¶
OFF
This section allows you to specify multiple CDN paths for your content. If you only use one CDN, then only fill out the first box. If you have more than one path (for example, images served from one CDN, and JavaScript/CSS served from another), then you would fill out a box for each path.
Note
If you set up multiple CDN paths with the same settings, the last one will overwrite the others.
Warning
This setup is not necessary for Cloudflare or other distributed proxy networks. Only use CDN mapping for reverse proxy content delivery networks! If you wish to manage your Cloudflare cache from within LSCache, skip most of this page and jump to the Cloudflare API setting.
Video
Cloudflare may also be set up as a static content CDN (as opposed to its default use as a distributed proxy network). Setup is different in that case. See our blog post about Serving Static Content Through a Subdomain here.
CDN URL¶
empty string
This is the base URL for content that is served from this CDN. It should be a full URL beginning with http
.
Include Images¶
OFF
Turn this on to serve all images through this CDN. This includes image attachments, HTML <img>
tags, and CSS url()
attributes.
Include CSS¶
OFF
Turn this on to serve all CSS files through this CDN.
Include JS¶
OFF
Turn this on to serve all JavaScript files through this CDN.
Include File Types¶
default file types
Use this spot to list, one per line, the file types that are to be served from this CDN. These should be static files. This setting affects all of the following HTML tags: src
, date-src
, and href
. The default file types included in this setting are:
.aac
.css
.eot
.gif
.jpeg
.js
.jpg
.less
.mp3
.mp4
.ogg
.otf
.pdf
.png
.svg
.ttf
.woff
Important
If you have turned off any of the previous three settings, you will need to remove the corresponding file extensions from this Include File Types box.
For example, if Include CSS is set to OFF
, then remove .css
and .less
from the list.
Original URLs¶
your site URL(s)
This setting defaults to your site's base URL. It shouldn't be necessary to change this. If you do change it, be sure that the URL begins with //
as in //yoursite.com
. You may use a wildcard (*
) here to specify 0 or more characters.
If your site spans multiple base URLs, you may enter them all here, separated by commas. For example:
//a.yoursite.com, //b.yoursite.com, //c.yoursite.com
Included Directories¶
wp-content wp-includes
These are the directories that will be served by CDN. You shouldn't need to change this unless you have a non-standard configuration.
Exclude Path¶
list of paths to exclude from CDN
Use this spot to list file paths that you explicitly do not want to have served from the CDN. List them one per line. You can list a path in its entirety, or use a partial path that will be matched. Do not use wildcards.
Load JQuery Remotely¶
This setting has been deprecated.
Cloudflare API¶
OFF
Cloudflare isn't like other CDNs. You should not set Use CDN Mapping to ON
for Cloudflare. However, you can manage your Cloudflare cache through this plugin, if you wish. Simply set Cloudflare API to ON
and then fill in the three fields below. Once the settings are saved, you will be able to manage your Cloudflare cache through the LiteSpeed Cache > CDN > Manage area.
Email Address¶
Enter the email address you use with your Cloudflare account.
Global API Key¶
Enter the API key you were given by Cloudflare. You can find it on your Cloudflare profile.
Domain¶
Enter the domain name served by Cloudflare. You needn't enter the entire domain here. If you enter only part of it, the remainder of the domain will be filled-in automatically after save.
Auto QUIC.cloud Setup¶
LiteSpeed provides a simple three-step process for getting started with QUIC.cloud CDN.
Tip
If you would prefer to configure your domain for QUIC.cloud manually, please follow the Onboarding Instructions at QUIC.cloud.
Set up QUIC.cloud Account¶
If you have not set up QUIC.cloud CDN or any of QUIC.cloud's Online Services for this domain, this section will show a single Link to QUIC.cloud button.
If you already have a QUIC.cloud domain key for this site, then the button will say Begin QUIC.cloud CDN Setup instead.
Press the button (whatever it says) to add your site to a new or existing QUIC.cloud account.
Linking your domain to QUIC.cloud will be an automatic process, if all goes well, and you will be redirected back to this LiteSpeed Cache page. You should notice that the button has been replaced with a status of Ready to run CDN setup
.
You should also notice a new section at the bottom of the page labeled Action. More about this later.
CDN Setup Status¶
Once your domain has been linked to QUIC.cloud, the Run CDN Setup button will be available. Click it to continue.
The status should change to In Progress
and the button should now say Refresh CDN Setup Status. You will receive an email from QUIC.cloud when setup is complete, or you can press the button for an update.
If there are any errors during this process, the status will change to Paused
, and the error will be listed below the status. If the error is something you can fix on your own, you should do so and then press Run CDN Setup again. If you can't fix the error yourself, you can contact QUIC.cloud Support for help.
Nameserver detection¶
Auto Setup will attempt to verify that your nameservers are correctly set up at your domain registrar. This is the one step in the Setup process that you must complete manually.
Tip
Nameservers are a domain-level configuration. If you are setting up a subdomain like blog.example.com
, the namerservers are located at the domain registrar for the example.com
root domain. If you've already set up QUIC.cloud DNS for example.com
or some other subdomain of example.com
(like www.example.com
), then the nameservers should already be set to QUIC.cloud nameservers. You won't need to do anything for this step. Simply wait for QUIC.cloud to detect them.
Log into your domain registrar. Your previous DNS provider’s nameservers should still be on file. You’ll see them listed under NS1
, NS2
, and possibly NS3
and NS4
as well.
Warning
Your domain registrar is the the provider you purchased your domain name from. Sometimes this is the same as your hosting provider, but that is not always the case. Make sure that you are in the right place before you change anything!
Warning
QUIC.cloud DNS does not support DNSSEC. If you have DNSSEC enabled at your current DNS provider, please disable it before attempting to update nameservers and switch to QUIC.cloud DNS.
Change the NS1
and NS2
records, to match those displayed in the Nameservers section below. If your domain registrar has additional records (NS3
, NS4
, etc.) erase those values. You should now only have QUIC.cloud-provided NS records at your domain registrar.
Once the QUIC.cloud nameservers are detected at your domain registrar, the setup will be marked as Done
. Please note that this may take up to 48 hours.
You'll notice that the Set up QUIC.cloud Account section above will have two new links: Manage CDN
and Manage DNS Zone
. These will each bring you to your QUIC.cloud Dashboard to manage the CDN and DNS settings respectively. Finally, the Nameservers section will disappear, as it is no longer needed.
SSL Certificate Generation¶
During one of the steps of the CDN setup process, QUIC.cloud will generate an SSL certificate for your site. This may take 15-20 minutes. During this time, your site will still be accessible, however most browsers will give you a warning about insecure content before allowing you to proceed. This inconvenience will go away once the SSL certificate has been successfully generated.
Nameservers¶
This area is visible when QUIC.cloud is waiting for you to update the nameservers at your domain registrar, as described in the section above. The Nameservers area will disappear once the CDN setup is complete.
Action¶
These two buttons allow you to reset your Auto QUIC.cloud Setup to varying degrees.
- Reset CDN Setup resets the CDN setup to it's initial state in the LiteSpeed plugin and disables the CDN at QUIC.cloud if it's active. Your DNS Zone is not changed.
- Delete QUIC.cloud Data resets the CDN setup to it's initial state in the LiteSpeed plugin, disables the CDN at QUIC.cloud, and deletes the DNS Zone if it is inactive. If the DNS Zone is still in use, this button will fail.
With both buttons, your site remains connected to your QUIC.cloud account, and your domain key remains active. This is because you may want to use other QUIC.cloud services beyond the CDN.
Leaving QUIC.cloud¶
If you no longer want this domain paired with QUIC.cloud at all, you can use these buttons to start the process, but you will have to finish it manually.
If you have no other QUIC.cloud sites in this DNS Zone:
- Replace the nameservers at your domain registrar so you are no longer using QUIC.cloud nameservers
- Press the Delete QUIC.cloud Data button
- Visit your QUIC.cloud Dashboard, click on this domain, navigate to Settings, and click the
Delete Domain
link at the bottom of the screen. - Back in the LiteSpeed Cache Plugin, navigate to General > General Settings, clear the Domain Key field, and press the Save Changes button.
If you still have other QUIC.cloud sites in this DNS Zone (for example, this site is blog.example.com
, but you are still using QUIC.cloud DNS for www.example.com
and cannot delete the example.com
Zone):
- Press the Reset CDN Setup button
- Visit your QUIC.cloud Dashboard, click on this domain, navigate to Settings, and click the
Delete Domain
link at the bottom of the screen. - Back in the LiteSpeed Cache Plugin, navigate to General > General Settings, clear the Domain Key field, and press the Save Changes button.
CDN Manage Tab¶
LSCache for WordPress provides a mechanism for managing certain external CDN accounts, eliminating the need for an extra plugin.
QUIC.cloud¶
If you wish to use QUIC.cloud CDN, you can find all of the management tools on your QUIC.cloud dashboard.
Cloudflare¶
Before you can use the functions in this section, you will need to set up the Cloudflare API in the settings. Navigate to LiteSpeed Cache > Settings > CDN and set Cloudflare API to ON
.
Once the API settings are saved, the elements of this area will be populated.
Cloudflare Domain¶
This is the domain that you have configured to be served by Cloudflare. It is informational only and cannot be changed here. If it is in error, you will need to fix it in your Cloudflare account.
Cloudflare Zone¶
This is the unique id that was assigned to your domain by Cloudflare. It is informational only and cannot be changed here. You can see it on your Cloudflare profile.
Development Mode¶
These buttons allow you to turn on Development Mode, turn it off, and check to see whether it is running. If you are making updates to your site, and want to verify that they are working as planned, Development Mode allows you to temporarily disable Cloudflare so that you may see your updates in realtime.
After three hours, Development Mode will turn itself off, or you can turn it off manually via the button provided.
Cloudflare Cache¶
Press the Purge Everything button to purge your Cloudflare cache on demand. This is helpful if you have made changes that result in an LSCache purge, and you want to make sure Cloudflare is up-to-date.