require local 不用于防盗链，仅限制访问来源为本机或内网，作用于网络层而非 referer 协议层；防盗链必须通过 rewritecond %{http_referer} 或 setenvifnocase referer 实现，二者机制不同、不可替代。
Require local 本身不用于保护“防盗链接口”，它只控制 HTTP 请求的网络来源访问权限，作用对象是整个目录或 Location 块，而非 Referer 验证逻辑。把 Require local 和“防盗链”混用，属于概念错位——前者管“谁在连”，后者管“从哪来（Referer）”。
真正要保护的是静态资源（如图片、PDF）不被外站直接引用，这必须靠 Referer 检测（如 RewriteCond %{HTTP_REFERER} 或 SetEnvIfNoCase Referer），而不是 IP 限制。
但如果你的场景确实存在一个内部专用的资源访问入口（例如：后台预览页 /admin/preview 或内网调试接口 /debug/referer-test），且你希望仅允许本机或内网访问该路径（防止外部探测或绕过 Referer 规则），这时 Require local 才适用。
✅ 正确使用 Require local 的典型场景
1. 限制内部调试接口仅本机可访问
比如你有个 /debug/referer-check 页面，用来模拟不同 Referer 测试防盗链规则是否生效：
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
<location>
Require local
# 可选：配合 auth 增强安全
# Require ip 192.168.1.0/24
</location>
这样只有 127.0.0.1 或 ::1 能访问该路径，避免被外网扫描或滥用。
2. 保护管理后台静态资源目录
若 /admin/assets/ 下存放了仅供后台页面调用的图标、水印图等，且不希望被公网 URL 直接猜到：
<directory>
Require local
# 禁止所有外部请求，包括 Referer 合法的外站也无法命中
# 注意：此目录不应被前端 HTML 直接引用（否则后台打不开）
</directory>
⚠️ 注意：
Require local会彻底拒绝非本地请求，哪怕 Referer 是你自己的域名也不行。它和防盗链是两条防线，不可替代。
❌ 常见误用（需避免）
把
Require local加在主站点图片目录（如/images）上
→ 导致所有用户（包括你自己网站的正常页面）都无法加载图片，因为浏览器请求来自客户端 IP，不是local。以为
Require local能“增强 Referer 防盗链”
→ 实际上它完全不读取或校验Referer头，二者机制无关。防盗链靠环境变量或重写条件，访问控制靠地址匹配。
? 推荐组合策略（真实有效）
| 目标 | 推荐配置方式 |
|---|---|
| 防止外站盗链图片 |
RewriteCond %{HTTP_REFERER} !^$ + !^https?://(www\.)?yourdomain\.com
|
| 允许空 Referer（直接输入 URL） | 必须保留 !^$ 条件，否则用户收藏图片链接会失效 |
| 拦截盗链并返回 403 | RewriteRule \.(jpg|png|gif)$ - [F] |
| 拦截后跳转提示图 | RewriteRule \.(jpg|png|gif)$ /static/banned.png [R=302,L] |
| 保护调试页不被外网访问 | <location> Require local </location> |
? 补充说明
-
Require local在 Apache 2.4+ 中生效，依赖mod_authz_host模块（默认启用）。 - 它等价于
Require ip 127.0.0.1 ::1，但更简洁；若需扩展为内网段，改用Require ip 192.168.0.0/16。 - 不与
.htaccess中的Order Allow,Deny混用（那是 Apache 2.2 旧语法，2.4 已废弃）。
不复杂但容易忽略：防盗链是协议层（HTTP Header）控制，Require local 是网络层（TCP/IP）控制，各司其职，配错位置就全盘失效。
