要配置好nginx静态页面，核心就三步：找到配置文件，设置server块和root路径指向你的站点目录，最后用nginx -t测语法并reload重载，大部分人在这一步卡住,是因为后面的配置细节没理顺。
开始配置前需要准备什么
想省事，先把地基打好，nginx配置静态页面前,有三个信息你必须心里有数。
确认nginx已经装好
先确认服务器上nginx到底装没装,命令行敲一句：
nginx -v
如果返回类似nginx version: nginx/1.24.0的信息，说明已经装好，如果提示command not found，需要先用系统包管理器安装，不同发行版安装命令不一样，Ubuntu和Debian用sudo apt install nginx，CentOS和Rocky Linux用sudo yum install nginx或者sudo dnf install nginx，国内云服务器厂商的镜像市场里，很多默认预装了nginx,买来直接用就行。
静态文件放到哪个目录
静态页面文件放在哪里，这直接决定你后面root指令怎么写，行业里的通用做法是放到/var/www/目录下,按站点名建子目录，
sudo mkdir -p /var/www/mysite
一个规范的静态站点目录结构大概长这样：
/var/www/mysite/站点根目录/var/www/mysite/index.html默认首页/var/www/mysite/css/样式文件目录/var/www/mysite/js/脚本文件目录/var/www/mysite/images/图片资源目录
目录结构准备妥当,后面出问题的概率会小很多。
配置文件在哪里修改
nginx配置文件的路径，不同系统有细微差异，多数Linux发行版的主配置文件在/etc/nginx/nginx.conf，而真正的站点配置通常放在/etc/nginx/conf.d/目录下单独一个.conf文件里，或者放在/etc/nginx/sites-available/目录里然后软链到sites-enabled/目录。
你自己建一个独立配置文件是更清晰的做法：
sudo vi /etc/nginx/conf.d/mysite.conf
这样不污染主配置文件，也方便后期维护，如果你完全没头绪，也可以先看一下默认配置里是怎么写的,以默认配置作为参照来改。
nginx配置静态页面的完整操作流程
基础准备做完，接下来就是核心动作了，下面是配置nginx静态页面的完整流程,每一步都有讲究。
先写一份最小可用的server块配置
打开刚才建好的配置文件,写入下面这份最简单的配置：
server {
listen 80;
server_name example.com www.example.com;
root /var/www/mysite;
index index.html;
location / {
try_files $uri $uri/ =404;
}
}
这段配置的含义简单说一下：
listen 80表示监听HTTP默认端口server_name是你的域名，可以用IP或者临时域名root指向静态文件所在的绝对路径index指定默认访问的文件名location /配合try_files，作用是当请求路径能找到对应文件就直接返回文件，找不到就返回404，不会误报其他错误
配置静态页面的核心逻辑其实就一句话：告诉nginx去哪找文件，找到就返回，找不到就告诉用户没有。
修改配置后测试并重载nginx
配置文件写完后，别急着重启,先检查语法：
nginx -t
如果输出syntax is ok和test is successful，说明语法没问题，接下来让nginx重新加载配置，用reload而不是restart：
sudo systemctl reload nginx
reload是平滑重载，不会中断正在处理的请求，静态页面更新频繁，每次更新文件后不需要任何操作,但每次修改nginx配置后都需要执行这一步。
验证静态页面是否正常访问
配置生效后，在本机或本地电脑的浏览器地址栏输入你的域名或服务器IP，能看到网站内容就说明配置成功，如果没有域名，想快速验证，可以用curl命令：
curl -I http://服务器IP/
返回200 OK说明nginx已经正常服务静态页面了，这时候你的静态网站已经可以访问，接下来才是真正的挑战排查各种隐藏问题。
nginx配置静态html页面无法访问，多半是这几个地方出了差错
配置nginx静态页面其实不难，但出错的时候千奇百怪，下面这些是静态页面无法访问时最常见的几个原因,按照出现频率排个序。
404错误的三种典型成因
404是最常见的错误，nginx配置静态页面返回404,通常有三个原因。
第一，root路径写错了。 root后面跟的是绝对路径，很多人容易把路径末尾多写一个，或者和location里的路径重复拼接，比如root设置为/var/www/mysite，配置了location /blog，nginx实际查找的路径就是/var/www/mysite/blog，如果目录里没有blog这个子目录,404就是必然结果。
第二，文件权限不够。 nginx运行用户通常是nginx或www-data，如果你手动创建的文件，属主是root，权限还是默认的600，nginx根本读不了,正确的做法是让其他人有读取权限：
sudo chown -R www-data:www-data /var/www/mysite
或者退一步,给文件目录加上读取权限：
sudo chmod -R 755 /var/www/mysite sudo chmod 644 /var/www/mysite/index.html
第三，try_files配置不完整。 上面提到的try_files $uri $uri/ =404;是推荐的标准写法，如果你把location /配置写成location / { }什么都不干，nginx会用默认行为处理,某些情况下会返回404或者拒绝访问。
403错误基本是权限或SELinux在拦路
403和404的排查思路不一样，403说明nginx能找到这个文件，但没权限打开，先确认一下文件权限是否对nginx运行用户开放了读取权限，还有一种情况容易被忽略如果你的服务器开启了SELinux，即使权限看着没问题,SELinux照样会拦你。
可以用下面命令临时放开试试：
sudo setsebool -P httpd_read_user_content 1
如果这个开了就有用，说明确实是SELinux在作怪，具体怎么配置对应类型,需要根据你的部署场景做设置。
直接看nginx错误日志最省事
排查问题最直接的手段就是看日志，nginx的错误日志默认位置在/var/log/nginx/error.log,用下面的命令实时查看：
sudo tail -f /var/log/nginx/error.log
日志会直接告诉你具体是哪个路径找不到、权限不够还是其他原因，相比一边猜一边试,看日志能少走很多弯路。
静态页面上线后的性能优化
页面能访问了，后面的问题就是如何让加载更快、更省资源，nginx托管静态页面本身就非常轻量,但还有几个细节可以再优化一下。
开启gzip让传输体积更小
静态页面里CSS、JS、HTML文本类资源占大头，gzip压缩后体积能小很多，在nginx.conf的http块中加上这些配置：
gzip on; gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss image/svg+xml; gzip_min_length 1k; gzip_vary on;
配置完成后记得nginx -t加sudo systemctl reload nginx，压缩传输能直观提升页面加载速度,尤其是文件比较多的时候。
给静态资源设置浏览器缓存
对于静态资源，浏览器缓存能大幅减少重复请求，给css、js、图片这类带指纹的文件设置长缓存是通用做法：
location ~ \.(css|js|jpg|jpeg|png|gif|ico|svg|webp)$ {
expires 30d;
add_header Cache-Control "public, no-transform";
}
HTML文件不建议设长缓存，因为内容更新频繁，长缓存会导致用户在浏览器端看不到新内容，图片和样式这种更新后文件名会变的资源类型,长缓存是安全的。
静态页面和反向代理并存的常见架构
有相当一部分场景是nginx既要托管静态页面，又要把动态请求转发给后端服务，配置写法上，location里做一下区分就行：
server {
listen 80;
server_name example.com;
root /var/www/mysite;
# 静态文件请求直接走nginx
location /static/ {
alias /var/www/mysite/static/;
expires 7d;
}
# 动态请求交给后端
location /api/ {
proxy_pass http://127.0.0.1:8000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
静态部分nginx直接读文件响应，动态部分nginx当中间人转发给后端程序，各司其职，业内专家指出，这种动静分离架构是nginx最经典的用法之一，既发挥nginx处理静态文件的高效性能,又保留后端业务的灵活性。
nginx配置静态页面常见问题解答
nginx配置静态页面和反向代理有什么区别？
nginx配置静态页面，是指nginx自己读取磁盘上的HTML、CSS、JS文件，直接返回给客户端，反向代理配置，指的是nginx接收请求后转发给其他服务，比如Node.js、Java应用或另一台服务器，再把响应返回给客户端，两者的关键区别在于：静态配置中nginx是最终提供内容的人，反向代理配置中nginx只是一个中转站，实际操作中，一个server块完全可以同时包含静态配置和反向代理配置,通过location来区分不同路径的请求分别怎么处理。
修改nginx静态页面配置后，需要重启nginx还是reload？
只需要reload，修改配置文件后先运行nginx -t检查语法，确认无误后执行sudo systemctl reload nginx或者sudo nginx -s reload，reload会平滑地让配置生效，不会中断当前正在处理的请求，但如果修改了listen监听的端口这类核心参数，有些情况下可能需要restart才能完全生效，不过正常静态配置改动,reload就够了。
一个nginx能同时配置多个静态页面站点吗？
能，而且这是非常常见的用法，每个站点写一个独立的server块，放在conf.d/目录下，通过server_name区分不同域名，或通过不同端口区分不同站点，每个server块的root指向各自目录，互不干扰，nginx配置静态页面这套机制,天然就是为多站点托管设计的。
nginx配置静态页面的核心逻辑清楚之后，剩下的只是练习问题，把root路径写对、权限放好、reload生效，这三步走通，你的静态页面就能稳定跑起来，如果遇到404，顺着错误日志倒推,找到原因通常比想象中快。