How to Set Up Bright Data With NGINX
Integrate Bright Data with NGINX to efficiently route traffic, mask domains, and manage connections securely. Follow this guide to configure NGINX with Bright Data proxies for enhanced performance and flexibility.
Expand to get your Bright Data Proxy Access Information
Expand to get your Bright Data Proxy Access Information
Your proxy access information
Bright Data proxies are grouped in “Proxy zones”. Each zone holds the configuration for the proxies it holds.
To get access to the proxy zone:
- Login to Bright Data control panel
- Select the proxy zone or setup a new one
- Click on the new zone name, and select the Overview tab.
- In the overview tab, under Access details you can find the proxy access details, and copy them to clipboard on click.
- You will need: Proxy Host, Proxy Port, Proxy Zone username and Proxy Zone password.
- Click on the copy icons to copy the text to your clipboard and paste in your tool’s proxy configuration.
Access Details Section Example
Residential proxy access
To access Bright Data’s Residential Proxies you will need to either get verified by our compliance team, or install a certificate. Read more…
Targeting search engines?
If you target a search engine like google, bing or yandex, you need a special Search Engine Results Page (SERP) proxy API. Use Bright Data SERP API to target search engines. Click here to read more about Bright Data SERP proxy API.
Correct setup of proxy test to avoid “PROXY ERROR”
In many tools you will see a “test proxy” function, which performs a conncectivity test to your proxy, and some add a geolocation test as well, to identify the location of the proxy.
To correctly test your proxy you should target those search queries to:
https://geo.brdtest.com/welcome.txt
.
Some tools use popular search engines (like google.com) as a default test target. Bright Data will block those requests and you tool will show proxy error although your proxy is perfectly fine.
If your proxy test fails, this is probably the reason. Make sure that your test domain is not a search engine (this is done in the tool configuration, and not controlled by Bright Data).
What is NGINX?
NGINX is a high-performance web server and reverse proxy used for load balancing, caching, and securing connections. By integrating NGINX with Bright Data, you can mask proxy domains, route traffic seamlessly, and optimize your infrastructure for better performance.
How to Set Up Bright Data With NGINX
Install NGINX
- Install NGINX on your server following the official installation guide.
- Ensure you’re using version 1.15.10 or higher.
- Verify that your server’s IP is not added to the Bright Data proxy allowlist to avoid conflicts.
Configure the NGINX Core Settings
- Open the main NGINX configuration file:
-
Update the following parameters:
- Set
worker_processes
toauto
for dynamic optimization. - Set
worker_connections
to200
(or more, depending on your required number of ports).
- Set
-
At the end of the
http
section, add:
- Save the changes and exit the editor.
- Your updated
nginx.conf
should look like this:
Create a Proxy Configuration File
- Create the directory for custom configurations:
- Create a new configuration file:
- Add the following configuration to the file, adjusting the port range as needed:
- Save and close the file.
Restart NGINX
- Apply the changes by restarting NGINX:
Test the Proxy Configuration
- Verify the proxy connection with the following command, replacing
10.0.2.15
with your server’s IP:
-
Confirm that the response includes the expected proxy IP and location.
Expected output:
Restart NGINX
- To ensure that traffic routes through NGINX, monitor your proxy manager logs.
- Confirm that the “sent from” IP matches your NGINX server’s IP address.
Your Bright Data are now successfully integrated with NGINX, providing secure, efficient traffic routing and domain masking. This setup is ideal for optimizing web scraping, load balancing, and secure proxy management. Enjoy streamlined operations!