索引
在宝塔面板(BT Panel)中,0.default.conf 文件是 nginx 或 Apache 的虚拟主机默认配置文件。它的主要作用是当服务器接收到一个不匹配任何已配置虚拟主机的请求时,Nginx 或 Apache 会自动使用这个默认配置来处理请求。
0.default.conf
具体来说,0.default.conf 有以下几个作用:
- 默认站点:
0.default.conf通常会设置一个默认站点,比如一个提示页面,告知访问者该域名尚未绑定或站点未配置。这在用户访问未绑定的域名时,避免返回空白页面或错误信息。 - 顺序优先:文件名以
0开头,使得它在虚拟主机列表中位于第一个,从而确保它作为默认配置被优先处理。当某个请求没有匹配到其它虚拟主机时,将会被导向这个默认配置。 - 安全性:可以将默认站点配置成安全提示或限制访问,以防止敏感信息泄露。例如,默认站点可以返回一个 HTTP 403 禁止访问的页面,保护服务器免受一些恶意访问。
- 简化管理:在不需要手动为每个域名配置时,
0.default.conf提供一个统一的方式来处理未绑定域名的访问。
如果你不希望未绑定的域名访问到服务器,可以将 0.default.conf 设置为返回 403 禁止访问,或者跳转到指定的提示页面,这样可以提升站点的安全性和用户体验。

在宝塔中,0.default.conf 文件其实就是对应到「未设置默认站点」
以下为宝塔nginx 0.default.conf 的配置内容:
server
{
listen 80;
listen 443 ssl http2;
server_name _;
index index.html;
root /www/server/nginx/html;
# DEFAULT SSL CONFIG
ssl_certificate /www/server/panel/vhost/cert/0.default/fullchain.pem;
ssl_certificate_key /www/server/panel/vhost/cert/0.default/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers EECDH+CHACHA20:EECDH+CHACHA20-draft:EECDH+AES128:RSA+AES128:EECDH+AES256:RSA+AES256:EECDH+3DES:RSA+3DES:!MD5;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 10m;
add_header Strict-Transport-Security "max-age=31536000";
}
0.websocket.conf
额外补充,在 Nginx 配置中,0.websocket.conf 文件通常用于设置服务器块,以处理 WebSocket 连接。WebSocket 允许客户端和服务器之间进行实时的双向通信。以下是在宝塔中 0.websocket.conf 的基本配置示例:
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
这段代码的作用是创建一个变量 $connection_upgrade,用来动态设置 Connection 头的值,从而帮助 Nginx 更好地处理 WebSocket 连接的状态。具体含义如下:
map指令:map指令用于根据一个变量的值来设置另一个变量的值。在这个例子中,$http_upgrade的值决定了$connection_upgrade的值。$http_upgrade变量:$http_upgrade表示客户端请求头中的Upgrade字段。如果客户端发起的是 WebSocket 请求,这个字段通常为websocket;如果是普通 HTTP 请求,这个字段会为空。- 配置逻辑:
default upgrade;:如果$http_upgrade有值(如 WebSocket 请求),则$connection_upgrade被设置为upgrade,这样 Nginx 会将Connection: upgrade头信息添加到请求中,以保持 WebSocket 连接。'' close;:如果$http_upgrade为空(即不是 WebSocket 请求),则$connection_upgrade被设置为close,表示普通的 HTTP 请求。
这段配置用于在 WebSocket 和普通 HTTP 请求之间做出区别。通过将 $connection_upgrade 设置为合适的值,Nginx 可以自动处理 WebSocket 请求所需的头信息,从而确保 WebSocket 连接的正确建立。通常,它会配合 proxy_set_header 一起使用,如下范例所示:
location /ws/ {
proxy_pass http://backend_server;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
...
}
这样,在接收到 WebSocket 请求时,Nginx 会自动发送 Connection: upgrade 头,而对于普通 HTTP 请求则会发送 Connection: close 头,确保了不同类型请求的正确处理。
总体结论
0.default.conf 是一个默认的 Nginx 配置文件,用于处理未匹配的请求。其目的是确保服务器具有基础的响应能力,同时也能防止恶意解析或攻击,无论是提供静态内容、错误页面还是转发请求,同时可以根据需求添加 HTTPS 和 WebSocket 支持等功能。

剧搜博客