Fresns 的代理环境配置，核心是让系统在 CDN 或反向代理

Fresns 的代理环境配置，核心是让系统在 CDN 或反向代理（如 Cloudflare、Nginx 反代）之后，能正确识别访客的真实 IP 地址。如果不配置，系统会把代理服务器的 IP 误认为访客 IP，导致日志、限流等功能失效。

📂 配置项说明

Fresns 从 2.7.0 版本开始适配代理环境，新增了 TRUSTED_PROXIES 环境变量。

⚙️ 配置示例

在 .env 文件中添加：

# 信任单个代理 IP
TRUSTED_PROXIES=192.168.1.1

# 信任多个代理 IP
TRUSTED_PROXIES=192.168.1.1,10.0.0.1

# 信任整个网段（CIDR 格式）
TRUSTED_PROXIES=172.16.0.0/12

配置完成后，需要清除配置缓存使设置生效：

rm bootstrap/cache/config.php

🔍 如何确定该填什么

• Nginx 反向代理：如果你在前面加了一层 Nginx 反代，填该 Nginx 服务器的 IP。

• Cloudflare：Cloudflare 的 IP 段是公开的，但数量较多且可能变动，手动维护比较麻烦。

• 宝塔面板反代：如果使用宝塔的反向代理功能，代理服务器通常就是本机，可以尝试填 127.0.0.1。

💡 注意事项

TRUSTED_PROXIES 的值不要随意设为 *（信任所有代理）。这会让 Fresns 直接采用请求头中声称的 IP 地址，攻击者可以伪造 X-Forwarded-For 头来伪装自己的 IP，导致安全风险。

如果只是本机 Nginx 反代，填 127.0.0.1 即可；如果前方是 Cloudflare 这类大型 CDN，建议使用专门的包（如 monicahq/laravel-cloudflare）来动态获取 IP 段，避免手动维护。