在 Mac 上将 Gmail 添加到 NodeMail
NodeMail 当前通过应用专用密码连接 Gmail 的 IMAP 和 SMTP。内置浏览器可以协助准备和导入密码；这不是用于邮箱接入的 Google OAuth 登录。
正文语言：简体中文 · 核对日期
下载版本 0.1.0 · 构建 2 · ≈ 492 MB
macOS 14+ · Apple Silicon · Free：1 个邮箱
开始之前
- 准备当前 NodeMail 版本支持的 Mac，以及你有权使用的 Gmail 邮箱。
- Google 账户需要开启两步验证，并允许生成应用专用密码。组织账户请先确认管理员的限制。
- 为该邮箱选择可用连接。使用内置浏览器准备密码前，还需确保“浏览器运行时”已就绪。
在 NodeMail 中操作
- 打开 NodeMail 设置，添加邮箱账户。填写完整 Gmail 地址，选择 Gmail 预设，认证保持“密码 / 应用专用密码”。
- 在“连接”中选择直连、Clash 节点或手动 SOCKS5。使用代理时，选好已有配置及适用的节点。
- 点击“在指纹浏览器中设置 Gmail”，登录与表单地址一致的 Google 账户。需要开启两步验证时，可打开“Google 安全设置”。
- 进入 Google 的应用专用密码页面，为 NodeMail 生成密码。在浏览器中仅选中生成的 16 位密码。
- 回到 NodeMail，点击“导入选中的应用专用密码”，也可手动填入“应用专用密码”。导入选中文本并不等于已保存账户。
- 点击“存储账户”并等待连接验证。打开收件箱，再向你自己的地址发送测试邮件，单独确认发信功能。
服务器设置
| 协议 | 服务器 | 端口 | 加密 | 认证 |
|---|---|---|---|---|
| IMAP | imap.gmail.com | 993 | SSL/TLS | 应用专用密码 |
| SMTP | smtp.gmail.com | 465 | SSL/TLS | 应用专用密码 |
如何理解服务器参数
表格列出 NodeMail 的 Gmail 默认值。收信与发信使用不同连接，浏览器登录成功或能看到收件箱，不能证明 SMTP 发信也正常。
Workspace 邮箱需由管理员确认 IMAP 访问权限及允许的认证方式。仅凭自定义邮箱域名，无法确定实际邮件服务商。
让凭据对应到具体邮箱
为此客户端单独生成应用专用密码，便于撤销时不影响其他客户端。联系客服时不要提供密码、OAuth 令牌或恢复码。
NodeMail 网站账户用于登录与管理 App 套餐，不能替代桌面 App 中添加的 Gmail 邮箱。
失败排查
找不到应用专用密码
检查 Google 账户的安全与组织设置。高级保护、仅使用安全密钥的验证方式或管理员策略可能禁止此方式。Google 推荐支持 OAuth 的客户端；NodeMail 当前 Gmail 设置无法绕过账户限制。
导入提示选中内容无效
在该邮箱的 NodeMail 浏览器中打开应用专用密码页面，只选中生成的密码，并确认表单地址没有改变。也可手动输入密码；不要使用验证码或恢复码。
原本可用的连接失效
修改 Google 主密码会撤销应用专用密码。密码被撤销后，请重新生成并更新已保存账户。若提示超时，先检查所选线路与 IMAP/SMTP 端口，再判断是否需要更换凭据。
无法打开设置浏览器
在设置中检查“浏览器运行时”，等待安装完成。确认选中的代理仍存在且可用，再重试，无需重复添加邮箱账户。
继续阅读
参考资料与维护
NodeMail 邮箱指南维护者
— 2026 年 9 月 12 日新增 Gmail 独立指南，核对应用专用密码流程、客户端默认参数与官方资料。
发现设置有变化？请联系 support@nodemail.app.