🎥 Hint: you can also watch DataUnlocker setup tutorial video.
Adding DataUnlocker to your website consists of 3 steps: choosing a routing option, adding a script and running a health check to ensure that you have set things up properly.
In the first step, you will be asked to choose a routing option, which can be either:
- DNS-based (default and preferred)
- Path-based (for extraordinary cases when you want to use your own servers)
Choose a DNS-based option if you have an access to your domain, as it is the easiest option available. The second option requires you to set up a reverse proxy on your own, which will forward all traffic to our proxy servers with a few additional headers.
After choosing DNS routing option, the setup will suggest a new DNS records you will need to add to your domain. This is usually done on the website where you have purchased your domain. The exact steps for adding a DNS record vary between domain registrars, but we suggest looking at some common cases.
Add DNS records exactly as the setup guide suggests:
Note the following:
- ⚡ If you're using CloudFlare for managing DNS records, please ensure the proxy is turned off for this DNS record (an orange-cloud icon is not orange).
The path-based routing option can be used when your (website hosting) provider doesn't give you access to manage your domain's DNS records. However, you will need to run proxy servers on your own, following the UI instructions.
The path-based routing option can also bring you a benefit of having same-origin proxied requests, however, this is not necessary, as all third-party requests normally already have all appropriate CORS headers.
If you decide to use the path-based routing option, you will need to run your own reverse
proxy back end like this one.
You also need to ensure that your reverse proxy server additionally pass
X-Du-IP headers to all proxied requests, and it doesn't modify any existing headers.