← 返回 GitHub Proxy 最新地址发布 - GitHub 文件 , Releases 首页

Proxy SwitchyOmega 怎么设置?从创建配置到连接排查

更新于 2026-10-18 · ghproxy.cyou

简答:Proxy SwitchyOmega 的设置流程是:打开扩展选项,新建 Proxy Profile,填写代理协议、服务器和端口,保存并应用配置,再从浏览器工具栏选择该配置。它本身不提供代理服务器,必须先准备可用的代理地址和端口。

定义:Proxy SwitchyOmega 是一个用于管理和切换浏览器代理配置的扩展,不负责提供代理服务器或网络服务。

一、设置前先确认:你需要哪些信息

Proxy SwitchyOmega 只是浏览器代理配置工具,不会自动生成服务器、端口或订阅内容。官方说明明确表示,使用前需要准备自己的代理服务器;扩展本身不提供免费代理、VPN 或其他网络服务。github.com

通常需要从网络管理员、企业代理服务或本机代理客户端中确认以下字段:

如果你使用的是本机代理客户端,应先确认客户端已经启动,并查看其设置页面中的监听地址、端口和协议。常见的本机地址可能是 127.0.0.1,但不能据此推断端口,必须以客户端实际显示内容为准。

二、Proxy SwitchyOmega 基础设置步骤

  1. 在 Chrome、Edge 或其他 Chromium 浏览器中安装 Proxy SwitchyOmega,然后点击浏览器工具栏中的扩展图标。
  2. 进入扩展的选项页面,在左侧找到新增配置的入口,点击 New profile。
  3. 在 Profile name 中填写一个容易识别的名称,例如“办公代理”或“本机代理”。
  4. 将配置类型选择为 Proxy Profile,然后点击 Create。
  5. 在代理服务器表格中填写 Protocol、Server 和 Port。协议、地址和端口必须与代理服务端完全一致。
  6. 如果页面提供认证设置,并且代理服务要求用户名和密码,再按页面提示填写认证信息;如果服务端没有要求认证,不要随意填写。
  7. 点击左侧或页面底部的 Apply changes,保存配置。
  8. 回到浏览器工具栏,点击 Proxy SwitchyOmega 图标,选择刚刚创建的配置,使其成为当前生效配置。

官方项目将配置分为固定服务器、直连、系统代理、自动检测、PAC 和切换配置等类型;其中固定服务器配置最适合先验证“服务器、端口和协议是否正确”。github.com

第一次设置时建议先只创建一个固定服务器配置,不要同时修改规则列表、PAC 或多个扩展。这样出现问题时,比较容易判断是代理地址错误、代理服务未启动,还是浏览器扩展冲突。

三、只让指定网站走代理:Switch Profile 设置方法

如果你的需求不是让所有网站都经过代理,而是只让部分域名使用代理,可以创建或编辑 Switch Profile。它会根据匹配条件,在不同配置之间自动选择。官方文档将 Switch Profile 定义为一种可以按照用户设置的匹配规则动态选择结果配置的模式。github.com

  1. 先确保已经创建至少一个可用的 Proxy Profile,同时保留 Direct 或 Direct Connection 作为直连配置。
  2. 在左侧点击 New profile,填写配置名称,并选择 Switch Profile。
  3. 在规则区域新增匹配条件,根据页面字段填写域名、主机名或 URL 模式。
  4. 在匹配结果中选择要使用的 Proxy Profile。
  5. 在 Default 行选择未命中规则时的处理方式。如果只想让指定站点使用代理,可选择 Direct。
  6. 点击 Apply changes 保存,然后从扩展弹窗中启用这个 Switch Profile。

使用规则列表时,官方教程建议在 Switch Profile 中添加规则列表地址,下载规则内容,再为“Rule list rules”和“Default”分别指定结果配置,最后应用更改。github.com

需要注意,Chromium 对 HTTPS 请求提供给 PAC 脚本的信息存在限制,依赖完整路径的 URL 通配符或正则规则可能无法按预期匹配。更稳妥的做法是优先使用域名或主机名规则,避免把规则写得过度依赖 URL 路径。github.com

四、设置后无法连接的排查顺序

如果启用配置后网页打不开,建议按下面顺序排查,不要一开始就反复重装扩展。

  1. 先切换到 Direct:确认浏览器普通网络连接正常。如果直连也打不开,问题不一定来自 SwitchyOmega。
  2. 确认代理程序或服务端已启动:如果使用本机代理客户端,检查客户端是否正在运行,监听地址和端口是否发生变化。
  3. 核对三项核心字段:逐字检查 Protocol、Server、Port。协议选错、端口少写一位、地址中多了空格,都可能导致连接失败。
  4. 确认当前选中的配置:保存配置后,还要在工具栏弹窗中主动选择该配置;只保存而未启用,不会改变浏览器当前代理。
  5. 检查其他扩展:多个扩展同时控制浏览器代理时可能发生冲突。官方 FAQ 建议检查所有可能修改代理设置的扩展,并观察是否出现权限或优先级提示。github.com
  6. 查看浏览器代理状态:在 Chromium 浏览器地址栏打开 chrome://net-internals/#proxy,检查实际生效的代理信息是否与 SwitchyOmega 中填写的内容一致。官方 FAQ 将该页面列为排查代理配置的检查项。github.com
  7. 确认认证方式:Chrome 对 SOCKS 代理的用户名密码认证存在限制,官方 FAQ 说明 SwitchyOmega 无法替浏览器实现 SOCKS 认证。如果 SOCKS 服务必须认证,需查看服务端是否支持其他兼容方式。github.com

不要把“能打开扩展设置页面”误认为“代理已经可用”。扩展能正常运行,只能说明浏览器加载了扩展;最终是否连接成功,还取决于代理服务器状态、协议兼容性、端口可达性和认证配置。

五、旧版 SwitchyOmega 与 v3 版本怎么选

截至 2026-10-18,原始 FelisCatus/SwitchyOmega 项目仓库首页标注为不再维护。github.com 如果浏览器提示扩展与当前扩展规范不完全兼容,建议先查看扩展来源、项目说明和浏览器商店页面,不要直接安装来历不明的压缩包。

一些项目以“Proxy SwitchyOmega 3”或 ZeroOmega 的名称提供 Manifest V3 版本。其公开仓库说明该项目是从 SwitchyOmega 派生、面向 Manifest V3 的版本,并支持 Chromium 浏览器;这类项目与原始项目并非同一个仓库,安装前应自行核对项目来源、权限和更新记录。github.com

无论使用哪个版本,设置思路基本一致:创建代理配置,填写协议、服务器和端口,保存并启用;如果需要按域名分流,再建立 Switch Profile 或规则列表。对于涉及账号登录、支付或敏感信息的访问,应优先使用可信的代理服务,并避免使用来源不明的代理地址。

六、常见设置对照表

需求推荐配置关键操作
所有浏览器流量使用同一代理Proxy Profile填写 Protocol、Server、Port,Apply changes 后启用
只有指定域名使用代理Switch Profile添加域名规则,未匹配项设置为 Direct
使用已有 PAC 地址PAC Profile填写 PAC 内容或 PAC URL,再应用配置
恢复普通网络连接Direct从扩展弹窗选择 Direct 或 Direct Connection
使用系统当前代理System Profile确认操作系统代理已正确配置

这些配置类型和用途来自 SwitchyOmega 官方项目文档;不同版本的按钮位置可能略有差异,但字段含义通常围绕配置类型、代理服务器和规则结果展开。github.com

七、设置时的安全注意事项

常见问题

Proxy SwitchyOmega 本身提供代理服务器吗?

不提供。它是浏览器代理配置和切换工具,必须先准备可用的代理服务器、协议和端口。官方 FAQ 明确说明,SwitchyOmega 不提供免费代理、VPN 或其他网络服务。

为什么填写了 127.0.0.1 还是不能用?

127.0.0.1 只表示本机地址,不代表一定存在可用代理。请确认本机代理客户端已经启动,并核对客户端实际监听端口和协议;如果客户端使用其他地址,应以客户端设置为准。

Proxy SwitchyOmega 怎么设置 SOCKS5?

新建 Proxy Profile 后,将 Protocol 选择为 SOCKS5,再填写 Server 和 Port,保存并从工具栏启用。若服务端要求 SOCKS 用户名密码认证,需要先确认浏览器和服务端是否支持该认证方式。

设置后网页显示 ERR_PROXY_CONNECTION_FAILED 怎么办?

先切换到 Direct,确认普通网络正常;再检查代理服务是否启动、Protocol 是否选对、Server 和 Port 是否准确,并通过 chrome://net-internals/#proxy 查看浏览器实际采用的代理配置。

为什么规则没有按网址路径生效?

Chromium 对 HTTPS 请求提供给 PAC 脚本的完整 URL 信息存在限制,依赖路径的规则可能无法按预期工作。建议优先按域名或主机名设置规则,减少对具体路径的依赖。

相关阅读

参考资料

  1. SwitchyOmega 官方 GitHub 仓库
  2. SwitchyOmega 官方 FAQ
  3. SwitchyOmega 官方 Profile 文档
  4. SwitchyOmega 官方规则列表使用说明
  5. SwitchyOmega 官方 Chromium URL 限制说明
  6. SwitchyOmega 官方隐私说明
  7. ZeroOmega 公共项目仓库说明