第18章 Web 模板与 FastCGI/代理缓存
Web 模板与 FastCGI/代理缓存
Web 模板是如何工作的?
警告:修改模板可能会导致服务器报错,并可能导致部分服务无法重新加载或启动。每次重建用户或域名配置时,域名的配置文件都会被新模板覆盖。这发生在以下情况:HestiaCP 更新时、管理员主动触发时、或用户修改设置时。
模板位于 /usr/local/hestia/data/templates/web/ 目录下。
服务路径对应关系如下: Nginx (Proxy): /usr/local/hestia/data/templates/web/nginx/ Nginx - PHP FPM: /usr/local/hestia/data/templates/web/nginx/php-fpm/ Apache2 (Legacy/modphp): /usr/local/hestia/data/templates/web/apache2/ Apache2 - PHP FPM: /usr/local/hestia/data/templates/web/apache2/php-fpm/ PHP-FPM: /usr/local/hestia/data/templates/web/php-fpm/
警告:请勿直接修改默认模板,因为更新时会覆盖它们。若要自定义,请先复制副本:
```bash cp original.tpl new.tpl cp original.stpl new.stpl cp original.sh new.sh ```
编辑完模板后,请在控制面板中为相应域名启用该模板。修改现有模板后,需要重建用户配置。可通过 `v-rebuild-user` 命令或 Web 界面中的批量操作完成。
可用变量
| 名称 | 描述 | 示例 | | :--- | :--- | :--- | | %ip% | 服务器 IP 地址 | 123.123.123.123 | | %proxy_port% | 代理端口 | 80 | | %proxy_ssl_port% | 代理端口 (SSL) | 443 | | %web_port% | Web 服务器端口 | 8080 | | %web_ssl_port% | Web 服务器端口 (SSL) | 8443 | | %domain% | 域名 | domain.tld | | %domain_idn% | 国际化域名 | domain.tld | | %alias_idn% | 国际化别名域名 | alias.domain.tld | | %docroot% | 域名文档根目录 | /home/username/web/public_html/ | | %sdocroot% | 域名私有根目录 | /home/username/web/public_shtml/ | | %ssl_pem% | SSL 证书位置 | /usr/local/hestia/data/user/username/ssl | | %ssl_key% | SSL 密钥位置 | /usr/local/hestia/data/user/username/ssl | | %web_system% | 使用的 Web 服务器软件 | Nginx | | %home% | 默认主目录 | /home | | %user% | 当前用户名 | username | | %backend_lsnr% | 默认 FPM 服务器 | proxy:fcgi://127.0.0.1:9000 | | %proxy_extensions% | 应由代理服务器处理的扩展名列表 | A list of extensions |
提示:可通过设置将 %sdocroot% 映射为 %docroot%。
如何更改特定域名的设置?
切换到 PHP-FPM 后,目前有两种方法: 1. 在主目录 /home/user/web/domain.tld/public_html 中使用 .user.ini。 2. 通过 PHP-FPM 池配置。
PHP 池的配置模板位于 /usr/local/hestia/data/templates/web/php-fpm/。
警告:由于我们支持多版本 PHP,需要识别所使用的 PHP 版本。因此采用以下命名规则:YOURNAME-PHP-X_Y.tpl,其中 X_Y 为 PHP 版本号。例如,PHP 8.1 的模板命名为 YOURNAME-PHP-8_1.tpl。
安装 PHP 模块
```bash apt install php-package-name ```
例如,以下命令将安装 php-memcached 和 php-redis,包括 PHP 所需的额外依赖包。
```bash apt install php-memcached php-redis ```
Nginx FastCGI 缓存
提示:FastCGI 缓存仅适用于 Nginx + PHP-FPM 服务器。如果你使用的是 Nginx + Apache2 + PHP-FPM,则不适用!
FastCGI 缓存是 Nginx 的一项功能,允许缓存 FastCGI(此处指 PHP)的输出。它会临时创建一个包含输出内容的文件。如果其他用户请求同一页面,Nginx 会检查该缓存文件是否仍在有效期内;若是,则直接将缓存文件发送给用户,而无需再次请求 FastCGI。
FastCGI 缓存最适合请求量大且页面更新不频繁的站点,例如新闻网站。对于更动态的网站,可能需要调整配置,甚至完全禁用此功能。
为什么软件包 x 和 y 无法与 FastCGI 缓存配合使用?
我们有 20 多种不同模板,且并非所有都在使用中。因此我们决定未来停止发布新的模板,并希望社区通过提交 Pull Request 帮助改进现有模板。
如果你想为某个模板添加支持,请遵循以下说明。
如何在我的自定义模板中启用 FastCGI 缓存?
找到调用 fastcgi_pass 的代码块:
```bash location ~ [^/]\.php(/|$) { fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; try_files $uri =404; fastcgi_pass %backend_lsnr%; fastcgi_index index.php; include /etc/nginx/fastcgi_params; } ```
在 include /etc/nginx/fastcgi_params; 下方添加以下内容:
```bash include %home%/%user%/conf/web/%domain%/nginx.fastcgi_cache.conf*;
if ($request_uri ~* "/path/with/exceptions/regex/whatever") { set $no_cache 1; } ```
如何清除缓存?
启用 FastCGI 缓存后,Web 域名的编辑页面会新增一个“Purge Nginx Cache”按钮。你也可以使用 API 或以下命令:
```bash v-purge-nginx-cache user domain.tld ```
为什么我没有 FastCGI 缓存选项?
FastCGI 缓存是 Nginx 模式独有的选项。如果你使用的是 Nginx + Apache2,可以选择代理缓存模板,从而启用代理缓存。功能上几乎相同。实际上,代理缓存在使用 Docker 镜像或 Node.js 应用时也能工作。
编写自定义缓存模板时,请使用以下命名规则:caching-yourname.tpl、caching-yourname.stpl 和 caching-yourname.sh。
Hestia 支持 WebSockets 吗?
支持。Hestia 可以正常处理 WebSockets;但我们的默认模板包含以下配置:
```bash proxy_hide_header Upgrade ```
这是为了解决 Safari 阻止网站加载的问题。若要允许使用 WebSockets,请删除该行。否则 WebSockets 将无法工作。