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 配置文件的能力。