代理设置
服务器直连不上某些服务时（比如国内服务器连 Gmail、访问 chatgpt.com），可以在「设置 → 代理设置」添加代理，让这些连接经代理转发。代理按需选用：没选代理的地方仍然直连。
- 打开「设置 → 代理设置」，点「添加代理」
- 填写：
| 字段 | 说明 |
|---|---|
| 名称 | 自己看的名字，如「香港代理」 |
| 类型 | SOCKS5、HTTP、HTTPS、SOCKS4。HTTP / HTTPS 代理需要支持 CONNECT |
| 代理地址、端口 | 如 127.0.0.1 和 1080。DaMail 跑在 Docker 里时，127.0.0.1 指的是容器自己，要连宿主机上的代理请填宿主机的内网地址 |
| 用户名、密码 | 代理需要认证时填写；密码加密保存，编辑时留空表示不修改 |
| 测试目标 | 点「测试连接」时经代理连到这个地址，默认 imap.gmail.com:993，可以换成你要连的服务器 |
- 先点「测试连接」，成功后保存
修改或删除代理后，使用它的邮箱会自动重新连接；删除后这些邮箱改为直连。
| 用途 | 在哪里选 | 经代理的连接 |
|---|---|---|
| 邮箱收发 | 编辑邮箱 →「代理选择」 | IMAP 收信、SMTP 发信、Microsoft Graph、OAuth 刷新令牌 |
| Gmail / Microsoft 授权 | 「设置 → 授权应用」→「代理选择」 | 授权时向 Google / Microsoft 换取令牌；新授权的邮箱默认沿用这个代理 |
| AI 客户端登录授权 | 「设置 → OAuth 设置」→「代理选择」 | 读取 ChatGPT 等客户端的元数据文档和公钥；只会访问客户端 Client ID 所在的网站 |
| 检查新版本 | 环境变量 UPDATE_CHECK_PROXY_ID |
访问 api.github.com 读取最新版本 |
测试连接提示代理拒绝连接：检查代理地址和端口；Docker 部署时不要填 127.0.0.1，改填宿主机地址，或把代理也放进同一个 Docker 网络用服务名访问。
测试成功，但邮箱还是连不上：确认编辑邮箱时选了这个代理并已保存；用 Gmail OAuth 授权的邮箱，「授权应用」里也要选代理，否则授权和刷新令牌会失败。