phpEnv Nginx防盗链配置与Referer白名单设置-php教程-PHP中文网

phpenv中防盗链需手动配置nginx：将valid_referers规则写入c:\phpenv\nginx\vhost\your-site.conf的location块，显式包含none、blocked及localhost等白名单，修改后执行nginx -t校验并-s reload；若报unknown directive，说明nginx版本不支持valid_referers，须改用if判断或升级。

phpenv nginx防盗链配置与referer白名单设置

phpEnv 是 Windows 下轻量级 PHP 开发环境，内置 Nginx（通常为 1.20+），但不提供图形化防盗链开关，所有防盗链逻辑必须手动修改 Nginx 配置文件。直接在面板里点“开启防盗链”是无效的——那只是宝塔或 AMH 的功能，phpEnv 没有这层抽象。

`valid_referers` 配置写在哪？路径和 reload 方式

phpEnv 的站点配置文件默认位于：
C:\phpEnv\nginx\vhost\your-site.conf（或 default.conf）

你必须把防盗链规则写进 location 块里，不能只丢在 server 根层级。常见错误是写在 server 外或拼错括号导致 nginx -t 报错。

修改后必须执行：C:\phpEnv\nginx\nginx.exe -t（检查语法）
再执行：C:\phpEnv\nginx\nginx.exe -s reload（热重载，不要用任务管理器杀进程）

注意：phpEnv 自带的 Nginx 不支持 valid_referers 中的 server_names 关键字（部分旧编译版本缺失该模块），若 reload 失败并报 unknown directive "valid_referers"，说明你得换用支持该指令的 Nginx 版本，或改用 if ($http_referer !~ ...) 替代。

`if ($invalid_referer)` 为什么总返回 403 却自己页面也打不开？

这不是规则写错了，而是 Referer 匹配逻辑太严：

浏览器直接输入地址访问图片 → Referer 为空 → 属于 none，必须显式允许
后台富文本编辑器（如 UEditor）预览图 → iframe 加载，Referer 为空或为 about:blank → 被判为 blocked
本地开发用 @#@#@#@#@#@#@#@#@#@0 访问前端 → 白名单没填 localhost，匹配失败

正确写法应包含三类来源：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

none（直接访问）
blocked（空或无效 Referer）
显式域名，如 yourdomain.com、www.yourdomain.com、localhost、127.0.0.1

示例：

location ~* \.(jpg|jpeg|png|gif|webp|pdf|zip)$ {
    valid_referers none blocked yourdomain.com www.yourdomain.com localhost 127.0.0.1;
    if ($invalid_referer) {
        return 403;
    }
    expires 1d;
}

漏掉 localhost 是 phpEnv 用户最常踩的坑——因为开发时几乎全靠它。