logo

Nginx 模板

概述

Nginx 模板允许您自定义 Forge 在创建新站点时使用的 Nginx 站点配置。

损坏的 Nginx 模板可能会导致停机

无效的 Nginx 模板将阻止 Nginx 正确工作,并且您现有的站点可能停止响应。在创建和部署自定义 Nginx 模板时,您应该谨慎行事。

创建模板

您可以在服务器的管理仪表板中创建自己的 Nginx 模板。创建新模板时,您需要提供模板名称和模板内容。Forge 将提供一个默认模板,您可以根据需要对其进行修改。

TLSv1.3

尽管默认模板没有显示对 TLSv1.3 的支持,但如果服务器能够支持,Forge 会自动更新站点以支持它。

模板变量

Forge 提供了多个变量,可以在模板中使用这些变量来动态更改新站点的內容。

变量描述
{{DIRECTORY}}站点的配置 Web 目录,例如 /public
{{DOMAINS}}站点配置的响应域名,例如 laravel.com alias.laravel.com
{{PATH}}站点的 Web 可访问目录,例如 /home/forge/laravel.com/public
{{PORT}}站点应监听的 IPv4 端口 (:80)。如果站点名称为 default,此变量还将包含 default_server
{{PORT_V6}}要监听的 IPV6 端口 ([::]:80)。如果站点名称为 default,此变量还将包含 default_server
{{PROXY_PASS}}要监听的 PHP 套接字,例如 unix:/var/run/php/php8.0-fpm.sock
{{ROOT_PATH}}配置站点的根目录,例如 /home/forge/laravel.com
{{SERVER_PUBLIC_IP}}服务器的公网 IP 地址
{{SERVER_PRIVATE_IP}}服务器的私网 IP 地址(如果可用)
{{SITE}}站点的名称,例如 laravel.com。这与 {{DOMAINS}} 不同,因为它不包含站点别名。
{{SITE_ID}}站点的 ID,例如 12345
{{USER}}站点的用户,例如 forge

使用这些变量时,应确保它们与上面显示的语法完全匹配。

管理模板

您可以随时编辑 Nginx 模板的名称和内容。对模板的更改不会影响使用该模板的现有站点。

删除模板不会删除配置为使用该模板的任何站点。

圈子权限

管理 Nginx 模板的能力由 site:manage-nginx 权限决定。此权限也用于限制编辑现有站点 Nginx 配置文件的能力。