dootask/resources/ai-kb/zh/concept/electron-client/proxy.md

id, title, type, feature, scope, locale, aliases, related_tools, related_pages, prerequisites, negative, last_verified

id	title	type	feature	scope	locale	aliases	related_tools	related_pages	prerequisites	negative	last_verified
electron-client.proxy.concept	桌面端代理设置	concept	electron-client	end-user	zh	桌面端代理 客户端代理 桌面端走代理 HTTP 代理 SOCKS 代理 公司代理 VPN 设置				桌面端**没有内置代理设置面板**,默认跟随操作系统代理配置 不支持在 App 内直接填写代理服务器地址 / 鉴权 全代理 / 分流策略需要在系统或网络层面解决	v1.7.90

桌面端代理设置

代理来源

DooTask 桌面端基于 Electron,网络请求默认遵循操作系统的代理设置(从 Chromium 继承)。客户端内没有独立的代理配置入口。代理生效路径:

• macOS:系统设置 → 「网络」→ 当前网络 → 「详细信息」→「代理」
• Windows:设置 → 「网络和 Internet」→「代理」
• Linux:多数发行版在「设置 → 网络 → 代理」

适用场景

• 内网部署需走公司 HTTP 代理出公网
• 通过 VPN 客户端访问私有 DooTask 实例
• 测试环境需经过 mitm / Charles 抓包(配 PAC 或全局代理)

启动参数(进阶)

Electron 支持启动时通过命令行参数注入代理。例如 macOS 终端启动:

open -a DooTask --args \
  --proxy-server="http://192.168.1.10:8080" \
  --proxy-bypass-list="*.internal.com"

Windows 在快捷方式属性里给 dootask.exe 加同样参数。这种方式属于绕过系统代理,生效优先级最高。

鉴权代理

需要用户名 / 密码的代理:

• 操作系统代理面板里录入凭证(macOS 钥匙串、Windows 凭据管理器)
• Chromium 弹出鉴权对话框时输入

故障排查

• 客户端打不开 / 登录失败,先确认浏览器(系统默认浏览器)能否打开 DooTask 网址
• 抓包检查请求是否经过预期代理
• 走代理后 WebSocket 连接可能被部分企业代理阻断,需让运维放通 wss://

不支持

• 客户端 UI 无代理配置项,无法在 App 内切换代理
• 不支持代理协议自动切换(SOCKS5 / HTTP / HTTPS)
• 不支持单 App 独立代理(全系统级)