宝塔面板 Nginx 配置实例详解

1. 概述

本文对宝塔面板中的 Nginx 配置文件进行详细解析，并为各项配置添加注释，以便更好地理解其作用和调整方法。

server
{
    listen 6636;
    server_name 129.204.60.15;
    index index.php index.html index.htm default.php default.htm default.html;
    root /www/wwwroot/itlooker1_com;
    #CERT-APPLY-CHECK--START
    # 用于SSL证书申请时的文件验证相关配置 -- 请勿删除
    include /www/server/panel/vhost/nginx/well-known/itlooker1.com.conf;
    #CERT-APPLY-CHECK--END

    #SSL-START SSL相关配置，请勿删除或修改下一行带注释的404规则
    #error_page 404/404.html;

    #SSL-END

    #ERROR-PAGE-START  错误页配置，可以注释、删除或修改
    error_page 404 /404.html;
    #error_page 502 /502.html;
    #ERROR-PAGE-END

    #PHP-INFO-START  PHP引用配置，可以注释或修改
    include enable-php-80.conf;
    #PHP-INFO-END

    #REWRITE-START URL重写规则引用,修改后将导致面板设置的伪静态规则失效
    include /www/server/panel/vhost/rewrite/itlooker1.com.conf;
    #REWRITE-END

    #禁止访问的文件或目录
    location ~ ^/(\.user.ini|\.htaccess|\.git|\.env|\.svn|\.project|LICENSE|README.md)
    {
        return 404;
    }

    #一键申请SSL证书验证目录相关设置
    location ~ \.well-known{
        allow all;
    }

    #禁止在证书验证目录放入敏感文件
    if ( $uri ~ "^/\.well-known/.*\.(php|jsp|py|js|css|lua|ts|go|zip|tar\.gz|rar|7z|sql|bak)$" ) {
        return 403;
    }

    location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$
    {
        expires      30d;
        error_log /dev/null;
        access_log /dev/null;
    }

    location ~ .*\.(js|css)?$
    {
        expires      12h;
        error_log /dev/null;
        access_log /dev/null;
    }
    access_log  /www/wwwlogs/itlooker1.com.log;
    error_log  /www/wwwlogs/itlooker1.com.error.log;
}

2. Nginx 配置文件解析

server {
    listen 6636;
    server_name 129.204.60.15;
    index index.php index.html index.htm default.php default.htm default.html;
    root /www/wwwroot/itlooker1_com;

解析：

• listen 6636; ：指定 Nginx 监听 6636 端口，通常用于自定义 HTTP 端口。
• server_name 129.204.60.15; ：指定服务器的域名或 IP 地址，此处为服务器的公网 IP。
• index index.php index.html ... ：设定默认首页文件，按优先级查找。
• root /www/wwwroot/itlooker1_com; ：指定网站的根目录。

---

    #CERT-APPLY-CHECK--START
    # 用于SSL证书申请时的文件验证相关配置 -- 请勿删除
    include /www/server/panel/vhost/nginx/well-known/itlooker1.com.conf;
    #CERT-APPLY-CHECK--END

解析：

• 该部分用于 Let’s Encrypt 或其他 SSL 证书自动申请验证，
• include /www/server/panel/vhost/nginx/well-known/itlooker1.com.conf;：引用证书验证配置，确保能成功申请 SSL 证书。

---

    #SSL-START SSL相关配置，请勿删除或修改下一行带注释的404规则
    #error_page 404/404.html;
    #SSL-END

解析：

• error_page 404 /404.html;：自定义 404 页面，可根据需求修改。
• 由于 SSL 配置被清空，若启用 SSL，需手动配置 ssl_certificate 和 ssl_certificate_key。

---

    #ERROR-PAGE-START  错误页配置，可以注释、删除或修改
    error_page 404 /404.html;
    #error_page 502 /502.html;
    #ERROR-PAGE-END

解析：

• 404 错误页定向到 /404.html，
• 502 错误页配置被注释，如有需要可取消注释并自定义 502 错误页面。

---

    #PHP-INFO-START  PHP引用配置，可以注释或修改
    include enable-php-80.conf;
    #PHP-INFO-END

解析：

• include enable-php-80.conf; ：启用 PHP 8.0 版本，
• 若要切换 PHP 版本，可修改为 enable-php-74.conf（PHP 7.4）等。

---

    #REWRITE-START URL重写规则引用,修改后将导致面板设置的伪静态规则失效
    include /www/server/panel/vhost/rewrite/itlooker1.com.conf;
    #REWRITE-END

解析：

• 引用伪静态规则文件，适用于 WordPress、Discuz 等 CMS。
• 直接修改 rewrite 规则可能会影响宝塔面板的伪静态设置。

---

    #禁止访问的文件或目录
    location ~ ^/(\.user.ini|\.htaccess|\.git|\.env|\.svn|\.project|LICENSE|README.md) {
        return 404;
    }

解析：

• 阻止访问 .user.ini、.git、.env 等敏感文件，避免信息泄露。

---

    #一键申请SSL证书验证目录相关设置
    location ~ \.well-known{
        allow all;
    }

    #禁止在证书验证目录放入敏感文件
    if ( $uri ~ "^/\.well-known/.*\.(php|jsp|py|js|css|lua|ts|go|zip|tar\.gz|rar|7z|sql|bak)$" ) {
        return 403;
    }

解析：

• .well-known 目录用于 SSL 证书申请验证，放行所有请求。
• 禁止上传 .php、.zip、.sql 等文件，防止恶意利用。

---

    location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$ {
        expires 30d;
        error_log /dev/null;
        access_log /dev/null;
    }

解析：

• 设置图片缓存 30 天，减少服务器负担。
• error_log /dev/null; access_log /dev/null; 关闭日志，减少磁盘写入。

---

    location ~ .*\.(js|css)?$ {
        expires 12h;
        error_log /dev/null;
        access_log /dev/null;
    }

解析：

• JS/CSS 文件缓存 12 小时，加速加载。
• 关闭日志记录，减少存储占用。

---

    access_log  /www/wwwlogs/itlooker1.com.log;
    error_log  /www/wwwlogs/itlooker1.com.error.log;
}

解析：

• access_log 记录访问日志，
• error_log 记录错误日志。

---

3. 可能的优化点

1. 优化 SSL 配置
   • 目前未配置 SSL 证书，可添加：

     ssl_certificate /path/to/fullchain.pem;
     ssl_certificate_key /path/to/privkey.pem;

2. 启用 Gzip 压缩

   gzip on;
   gzip_types text/plain text/css application/json application/javascript text/xml application/xml;

3. 开启 HTTP/2 以提升性能

   listen 443 ssl http2;

4. 日志切割
   • 定期归档日志，避免文件过大。

---

4. 结语

本文详细解析了宝塔面板 Nginx 配置文件的各项参数，并提供了一些优化建议。希望能帮助你更好地理解和优化 Nginx 配置，提高网站性能与安全性。