（3515期）gmail-oauth – 无头服务器 Gmail 认证专家

无头服务器 Gmail 认证专家 基于 gog CLI 的 Gmail OAuth 无头认证工具，支持在服务器环境完成 Google 授权流程，解决自动化邮件服务的令牌管理难题。 使用说明 核心用法 gmail-oauth 是一个专为无头服务器设计的 Gmail API 认证辅助工具，通过 gog CLI 实现完整的 OAuth 2.0 授权流程。用户需先在 Google Cloud Console 创建桌面应用类型的 OAuth 凭证，下载 client_secret.json 文件后，使用 gog auth credentials 导入配置。该 skill 提供交互式脚本 gmail-auth.sh，支持生成授权 URL、交换授权码、导入 token 等关键步骤，最终通过 gog gmail search 验证连接状态。 显著优点 无头环境友好：专为服务器/CI 环境设计，突破传统 OAuth 需要图形界面的限制，通过 localhost 重定向捕获授权码 流程标准化：严格遵循 Google OAuth 2.0 规范，支持 refresh token 持久化，避免频繁重新授权 故障排查详尽：文档覆盖 8 类常见错误场景，包括 "Testing 模式 7 天过期"、"redirecturimismatch"、移动端浏览器挂起等，提供针对性解决方案 权限粒度可控：支持 gmail.modify//gmail.readonly//gmail.send 等多档 scope，用户可按需最小化授权 潜在缺点与局限性 外部工具依赖：核心功能完全依赖第三方 gog CLI，该工具非 Google 官方出品，存在供应链风险 配置门槛较高：要求用户独立完成 Google Cloud 项目创建、API 启用、OAuth 同意屏幕配置等前置步骤，对非开发者不够友好 时效性敏感：授权码有效期仅数分钟，无头环境下需快速完成复制-粘贴-执行流程，操作窗口紧张 平台限制：gog CLI 主要通过 Homebrew 分发，Windows 原生支持有限 适合的目标群体 DevOps 工程师：需要在服务器/容器环境部署邮件自动化服务 后端开发者：构建基于 Gmail 的邮件收发、标签管理应用 个人技术用户：希望自建邮件归档、自动过滤等自动化工作流 小型团队：缺乏企业级 Google Workspace 管理员权限，需通过标准 OAuth 集成 Gmail 使用风险 凭证泄露风险：client_secret.json 和 refresh token 具有长期效力，一旦泄露可导致 Gmail 账户被完全控制，需严格设置文件权限（建议 600） 第三方工具信任：gog CLI 的更新维护、安全审计状态不透明，建议在使用前独立审查 Google 政策变动：Google 已废弃 urn:ietf:wg:oauth:2.0:oob 流程，未来可能进一步收紧桌面应用类型的 OAuth 政策 Token 失效场景：若未点击 "PUBLISH APP"，测试模式下的 token 7 天即过期，生产环境需特别注意 原始说明 Set up Gmail API access via gog CLI with manual OAuth flow. Use when setting up Gmail integration, renewing expired OAuth tokens, or troubleshooting Gmail authentication on headless servers.