进阶 yourls.org 2026-11-19 17:39:56 · 2 阅读

第17章 YOURLS 代理配置指南

第17章:代理(Proxy) YOURLS 支持代理,这意味着你可以将其部署在防火墙或代理服务器之后,并期望在不受限制的情况下正常使用。 要启用代理支持,请编辑 config.php,并根据你的环境配置添加以下代码: 无认证的代理 define( 'YOURLS_PROXY', 'proxy:port' );
proxy:port 格式支持域名或 IP 地址。示例: define( 'YOURLS_PROXY', 'proxy.mycompany.com:3128' ); define( 'YOURLS_PROXY', '10.0.0.201:3128' ); 带认证的代理 同时定义 YOURLS_PROXY_USERNAME 和 YOURLS_PROXY_PASSWORD: define( 'YOURLS_PROXY', 'proxy:port' );
define( 'YOURLS_PROXY_USERNAME', 'my_login' );
define( 'YOURLS_PROXY_PASSWORD', 'my_password' );
绕过代理的特定主机 你可能希望 YOURLS 直接连接某些特定主机而不经过代理(例如公司内网中的其他主机)。添加以下代码: define( 'YOURLS_PROXY_BYPASS_HOSTS', 'example.com, *.mycorp.com' );
此配置项支持以逗号分隔的主机列表,必要时可使用 * 作为通配符。 用于 IP 检测的受信任代理 当 YOURLS 运行在反向代理、负载均衡器或 CDN 之后时,访客的真实 IP 地址会包含在 X-Forwarded-For HTTP 头中传递。 默认情况下,YOURLS 仅信任 REMOTE_ADDR 并忽略转发头部,以防止 IP 欺骗。 如果 YOURLS 需要从转发头部中读取真实客户端 IP,则必须通过插件中的 get_ip_trusted_proxies 过滤器声明受信任的代理 IP。 为何这很重要 如果没有受信任代理列表: 系统将使用 REMOTE_ADDR,即你代理服务器的 IP,而非访客的 IP。 点击统计和地理数据将反映代理服务器的 IP,而非实际访客。 洪水防护机制会将所有访客视为同一 IP。 如果配置了受信任代理列表: YOURLS 会检查 REMOTE_ADDR 是否匹配受信任的代理。 如果匹配,它将从 X-Forwarded-For 中读取访客的真实 IP。 如果不匹配,则直接使用 REMOTE_ADDR,并忽略转发头部。这可以防止非受信任客户端伪造其 IP。 通过插件配置受信任代理 使用 get_ip_trusted_proxies 过滤器返回一个受信任代理 IP 数组(单个 IP 或 IP 段)。创建一个包含以下代码的插件: yourls_add_filter( 'get_ip_trusted_proxies', 'my_trusted_proxies' );

/
* 为 X-Forwarded-For 头部解析定义受信任的代理 IP。
* @return array 受信任代理 IP 列表
*/
function my_trusted_proxies() {
return [
'10.0.0.1', // 本地 nginx 反向代理
'198.41.128.0/17', // Cloudflare IPv4 地址段(示例,参见 https://www.cloudflare.com/ips/)
];
}

评论 (0)