登录与认证问题

本页帮助解决登录与认证过程中的常见问题。登录方式见 登录与认证。

​

浏览器回调失败

浏览器登录会打开一个授权页面，完成后回调到本地。若卡在等待回调：

• 确认浏览器已成功打开授权页并完成授权。
• 无图形界面环境（CI、未设 DISPLAY 的 SSH 会话、BROWSER=www-browser 等）下 CLI 会自动跳过拉起浏览器，登录界面本身就会打印可复制的登录 URL——在浏览器中手动打开该 URL 即可。
• 也可以在 /login 的登录方式中选择使用 Qoder Personal Access Token，直接粘贴令牌完成认证。
• 若在无图形界面的服务器上长期使用，改用 Personal Access Token（PAT）认证（见下文）。
• 本地回调端口可能被防火墙或其他进程占用，关闭占用进程后重试。
• 完成授权后手动切回终端，等待登录状态刷新。

​

无浏览器环境登录

在 CI/CD 或无浏览器的服务器上，使用 PAT 认证：

1. 在 Qoder Integrations 生成一个 Personal Access Token。
2. 通过环境变量提供：
   Copy

   # Linux / macOS
   export QODER_PERSONAL_ACCESS_TOKEN="<你的令牌>"
   
   Copy

   # Windows（命令提示符），注意不要加引号，CMD 会把引号存进变量值
   set QODER_PERSONAL_ACCESS_TOKEN=<你的令牌>
   
   Copy

   # Windows（PowerShell）
   $env:QODER_PERSONAL_ACCESS_TOKEN="<你的令牌>"
   
3. 设置该变量后，Qoder CLI 会自动使用 PAT 认证，无需浏览器。

​

Token 无效或过期

• 确认 QODER_PERSONAL_ACCESS_TOKEN 的值完整无误、无多余空格或换行。
• Windows 命令提示符下用 set 赋值时不要加引号，否则引号会被一并存进变量值——这是「值看起来对但认证失败」的常见成因。
• Token 被吊销或过期后需重新生成并更新环境变量。
• 若更新了环境变量却仍以旧身份运行：认证优先读取 QODER_PERSONAL_ACCESS_TOKEN 环境变量，其优先级高于 /login 保存的本地凭据；要改用 /login 的凭据必须先清除该环境变量。
• 在 CI 中通过密文变量注入 Token，避免明文提交到版本库。

​

账号与状态

• 运行 /status 查看当前登录身份与账户状态。
• 若显示未登录，运行 /login 重新登录。
• 需要切换账号时，先 /logout 再 /login。
• 若当前是通过 QODER_PERSONAL_ACCESS_TOKEN 认证的，必须先清除该环境变量再 /logout；否则下次启动仍会用旧令牌自动登录，表现为「已登出但身份没变」。

​

认证网络问题

若登录请求超时或连接失败，通常是网络/代理问题：

• 确认可以访问认证服务域名。
• 在受限网络中配置代理（见 网络、代理与 VPC 问题）。

​

下一步

• 登录与认证指南：登录与认证。
• 网络与代理：网络、代理与 VPC 问题。