How to set up an Nginx server block (virtual host)?
Jul 19, 2025 am 02:00 AM
To set up an Nginx server block, first understand its structure using the server directive with settings like listen, server_name, and location; next, create a directory structure for your site such as /var/www/example.com/html and set proper permissions; then enable the server block by creating a symbolic link from sites-available to sites-enabled and test configuration with nginx -t before reloading Nginx; finally, troubleshoot issues like port conflicts, incorrect root paths, multiple matching server blocks, missing index files, browser caching, or local DNS setup. Following these steps ensures smooth deployment of multiple websites on one server.
Setting up an Nginx server block (also known as a virtual host in Apache terms) is a common task when hosting multiple websites on a single server. It allows you to serve different content based on the domain name requested by the client. The process is straightforward once you understand how Nginx interprets configuration files.
1. Understand the Basic Structure of a Server Block
A server block in Nginx is defined using the server directive inside the main config file or in separate files under /etc/nginx/sites-available/. You can think of it like a container that tells Nginx how to respond to requests for a specific domain.
Here’s a basic skeleton:
server {
listen 80;
server_name example.com www.example.com;
location / {
root /var/www/example.com/html;
index index.html;
try_files $uri $uri/ =404;
}
}listendefines which port this server block listens on.server_nameis the domain(s) this block responds to.location /sets how the root request should be handled — where to find files, what to do if they're missing, etc.
You can add more directives depending on your needs, like handling PHP files, setting up redirects, or configuring SSL later.
2. Create the Directory Structure for Your Site
Before setting up the server block, make sure you have a directory for your site's files. A typical setup looks like:
/var/www/example.com/
└── html/
└── index.htmlYou can create this with:
sudo mkdir -p /var/www/example.com/html
Then place your HTML files inside the html folder. This keeps things organized, especially if you manage multiple domains.
Also, ensure the permissions are correct so Nginx can read the files:
sudo chown -R www-data:www-data /var/www/example.com sudo chmod -R 755 /var/www
3. Enable the Server Block and Test Configuration
Once the config file is ready, here’s what to do next:
- Save the server block in
/etc/nginx/sites-available/example.com. - Create a symbolic link to enable it:
sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/
This makes Nginx aware of the new site.
After that, test your configuration for syntax errors:
sudo nginx -t
If everything looks good, reload Nginx to apply the changes:
sudo systemctl reload nginx
Now, if your DNS points example.com to your server IP, you should see your website live.
4. Handle Common Issues and Gotchas
Even if you follow all steps, sometimes things don’t work right away. Here are some common issues and how to fix them:
- Port conflicts: Make sure no other service is using port 80 (e.g., Apache).
-
Wrong root path: Double-check the
rootdirective matches where your files are. -
Multiple server blocks matching the same domain: Nginx uses the first match alphabetically unless you specify
default_serverinlisten. -
Missing index file: If
index.htmldoesn’t exist, you’ll get a 403 error. - Caching issues in browser: Try clearing cache or testing from a private window.
Also, keep in mind that if you’re testing locally, you may need to edit your local machine’s hosts file to point example.com to your server’s IP address.
That’s basically it. Once you’ve got one working, adding more sites becomes a matter of copying the structure and tweaking the domain and paths. Not too bad once you know where everything fits.
The above is the detailed content of How to set up an Nginx server block (virtual host)?. For more information, please follow other related articles on the PHP Chinese website!
Hot AI Tools
Undress AI Tool
Undress images for free
Undresser.AI Undress
AI-powered app for creating realistic nude photos
AI Clothes Remover
Online AI tool for removing clothes from photos.
Clothoff.io
AI clothes remover
Video Face Swap
Swap faces in any video effortlessly with our completely free AI face swap tool!
Hot Article
Hot Tools
Notepad++7.3.1
Easy-to-use and free code editor
SublimeText3 Chinese version
Chinese version, very easy to use
Zend Studio 13.0.1
Powerful PHP integrated development environment
Dreamweaver CS6
Visual web development tools
SublimeText3 Mac version
God-level code editing software (SublimeText3)
How to execute php code after writing php code? Several common ways to execute php code
May 23, 2025 pm 08:33 PM
PHP code can be executed in many ways: 1. Use the command line to directly enter the "php file name" to execute the script; 2. Put the file into the document root directory and access it through the browser through the web server; 3. Run it in the IDE and use the built-in debugging tool; 4. Use the online PHP sandbox or code execution platform for testing.
After installing Nginx, the configuration file path and initial settings
May 16, 2025 pm 10:54 PM
Understanding Nginx's configuration file path and initial settings is very important because it is the first step in optimizing and managing a web server. 1) The configuration file path is usually /etc/nginx/nginx.conf. The syntax can be found and tested using the nginx-t command. 2) The initial settings include global settings (such as user, worker_processes) and HTTP settings (such as include, log_format). These settings allow customization and extension according to requirements. Incorrect configuration may lead to performance issues and security vulnerabilities.
How to limit user resources in Linux? How to configure ulimit?
May 29, 2025 pm 11:09 PM
Linux system restricts user resources through the ulimit command to prevent excessive use of resources. 1.ulimit is a built-in shell command that can limit the number of file descriptors (-n), memory size (-v), thread count (-u), etc., which are divided into soft limit (current effective value) and hard limit (maximum upper limit). 2. Use the ulimit command directly for temporary modification, such as ulimit-n2048, but it is only valid for the current session. 3. For permanent effect, you need to modify /etc/security/limits.conf and PAM configuration files, and add sessionrequiredpam_limits.so. 4. The systemd service needs to set Lim in the unit file
What are the Debian Nginx configuration skills?
May 29, 2025 pm 11:06 PM
When configuring Nginx on Debian system, the following are some practical tips: The basic structure of the configuration file global settings: Define behavioral parameters that affect the entire Nginx service, such as the number of worker threads and the permissions of running users. Event handling part: Deciding how Nginx deals with network connections is a key configuration for improving performance. HTTP service part: contains a large number of settings related to HTTP service, and can embed multiple servers and location blocks. Core configuration options worker_connections: Define the maximum number of connections that each worker thread can handle, usually set to 1024. multi_accept: Activate the multi-connection reception mode and enhance the ability of concurrent processing. s
NGINX's Purpose: Serving Web Content and More
May 08, 2025 am 12:07 AM
NGINXserveswebcontentandactsasareverseproxy,loadbalancer,andmore.1)ItefficientlyservesstaticcontentlikeHTMLandimages.2)Itfunctionsasareverseproxyandloadbalancer,distributingtrafficacrossservers.3)NGINXenhancesperformancethroughcaching.4)Itofferssecur
Nginx Troubleshooting: Diagnosing and Resolving Common Errors
May 05, 2025 am 12:09 AM
Diagnosis and solutions for common errors of Nginx include: 1. View log files, 2. Adjust configuration files, 3. Optimize performance. By analyzing logs, adjusting timeout settings and optimizing cache and load balancing, errors such as 404, 502, 504 can be effectively resolved to improve website stability and performance.
What are the SEO optimization techniques for Debian Apache2?
May 28, 2025 pm 05:03 PM
DebianApache2's SEO optimization skills cover multiple levels. Here are some key methods: Keyword research: Use tools (such as keyword magic tools) to mine the core and auxiliary keywords of the page. High-quality content creation: produce valuable and original content, and the content needs to be conducted in-depth research to ensure smooth language and clear format. Content layout and structure optimization: Use titles and subtitles to guide reading. Write concise and clear paragraphs and sentences. Use the list to display key information. Combining multimedia such as pictures and videos to enhance expression. The blank design improves the readability of text. Technical level SEO improvement: robots.txt file: Specifies the access rights of search engine crawlers. Accelerate web page loading: optimized with the help of caching mechanism and Apache configuration
How to implement automated deployment of Docker on Debian
May 28, 2025 pm 04:33 PM
Implementing Docker's automated deployment on Debian system can be done in a variety of ways. Here are the detailed steps guide: 1. Install Docker First, make sure your Debian system remains up to date: sudoaptupdatesudoaptupgrade-y Next, install the necessary software packages to support APT access to the repository via HTTPS: sudoaptinstallapt-transport-httpsca-certificatecurlsoftware-properties-common-y Import the official GPG key of Docker: curl-
