代理配置

代理配置允许你将出站请求通过代理服务器转发。这在企业防火墙环境下、需要特定代理访问 API，或希望控制网络流量时非常有用。

为什么使用代理？

• 企业网络要求 — 通过公司代理服务器转发流量
• API 访问 — 使用代理访问在你所在地区被阻止或限制的 API
• 流量控制 — 监控和控制出站请求
• 匿名性 — 在发起 API 调用时隐藏你的 IP 地址

代理设置

代理设置可以通过 配置方案 或对话配置对话框进行配置。

基本设置

设置项	说明
启用代理	切换代理开关
代理地址	代理服务器地址（如 http://127.0.0.1:7890）
代理模式	全局或规则模式
绕过本地地址	对 localhost 和 127.0.0.1 跳过代理

代理地址格式

Ruri 支持多种代理协议：

协议	示例	说明
HTTP	http://127.0.0.1:7890	标准 HTTP 代理
HTTPS	https://127.0.0.1:7890	HTTPS 代理
SOCKS5	socks5://127.0.0.1:1080	SOCKS5 代理
SOCKS4	socks4://127.0.0.1:1080	SOCKS4 代理

身份验证

如果代理需要身份验证，可以在 URL 中包含凭据：

http://username:password@127.0.0.1:7890

或使用 UI 中专用的用户名/密码字段。

代理模式

全局模式

在全局模式下，所有出站请求都通过代理服务器转发。这是最简单的设置 — 只需启用代理，所有流量都会路由。

适用于：

• 所有流量都应该通过代理的简单设置
• 有严格网络策略的企业环境

规则模式

规则模式允许你定义 Clash 风格的规则来控制哪些流量通过代理，哪些直连。规则按顺序匹配，首次匹配生效。

适用于：

• 选择性代理（如只代理 API 调用，不代理本地流量）
• 需要精细控制的高级用户

支持的规则类型

规则类型	说明	示例
DOMAIN	匹配精确域名	DOMAIN,api.openai.com
DOMAIN-SUFFIX	匹配域名后缀	DOMAIN-SUFFIX,.github.com
DOMAIN-KEYWORD	匹配域名关键词	DOMAIN-KEYWORD,google
IP-CIDR	匹配 IP 范围	IP-CIDR,192.168.0.0/16
GEOIP	匹配国家代码	GEOIP,CN
MATCH	匹配所有剩余流量	MATCH,DIRECT

规则示例

DOMAIN-SUFFIX,.openai.com,PROXY
DOMAIN-SUFFIX,.anthropic.com,PROXY
DOMAIN-SUFFIX,.github.com,PROXY
GEOIP,CN,DIRECT
MATCH,DIRECT

此配置将 OpenAI、Anthropic 和 GitHub 的请求通过代理转发，而所有中国 IP 地址和剩余流量直连。

绕过设置

绕过本地地址

启用后，对 localhost 和 127.0.0.1 的请求会跳过代理。这在以下情况有用：

• 运行不应通过代理的本地服务
• 使用本地开发服务器测试

绕过域名

你可以指定应始终绕过代理的域名：

1. 输入域名模式（如 *.local、*.internal）
2. 按回车添加
3. 这些域名将始终使用直连

在配置方案中配置代理

代理设置可以包含在 配置方案 中以便快速切换：

1. 进入 配置方案
2. 创建或编辑方案
3. 滚动到 代理配置 部分
4. 配置你的代理设置
5. 保存方案

这样你可以拥有：

• 工作 方案使用公司代理
• 个人 方案不使用代理或使用不同的代理
• 在它们之间快速切换

故障排除

代理连接失败

• 验证代理地址是否正确
• 检查代理服务器是否运行且可访问
• 确保代理协议受支持（HTTP、HTTPS、SOCKS4、SOCKS5）
• 检查可能阻止连接的防火墙设置

API 调用超时

• 代理服务器可能速度慢或过载
• 尝试减少超时时间或切换到不同的代理
• 检查代理是否阻止目标 API 端点

规则未按预期工作

• 规则按顺序匹配 — 确保特定规则在通用规则之前
• 使用 MATCH,DIRECT 或 MATCH,PROXY 作为最后一条规则以捕获所有剩余流量
• 检查域名或 IP 范围中的拼写错误

使用建议

• 先用全局模式测试 — 在添加复杂规则之前验证代理是否工作
• 保持规则简单 — 从几条必要的规则开始，根据需要添加更多
• 使用绕过本地地址 — 如果使用本地服务，始终启用此选项
• 监控代理使用情况 — 部分代理有带宽或请求限制
• 记录你的规则 — 保留关于为什么添加特定规则的笔记，方便日后参考