API Changelog Bot 1179623e25 docs(changelog): 测试服 API 文档站登录改 Gitea 账号 SSO(登录一次30天免登录)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-06-12 14:56:10 +08:00

【环境变更·全员】测试服 API 文档站(doc.html)登录改 Gitea 账号 SSO——登录一次 30 天免登录

站点:https://api.test.1814.love:9443/doc.html | 生效:2026-06-12 | 无 PR(测试服 nginx + oauth2-proxy 配置变更,不涉及业务代码) 已端到端实测:Gitea 登录→授权→文档加载→二次访问纯 Cookie 免登录

⚠️ 关键说明

文档站专用账号(hulalv)停用:访问 doc.html 不再弹浏览器账号密码框,改为跳转 Gitea 登录页,用你自己的 Gitea(git.1814.love)账号登录。
浏览器已登录 Gitea 的话全程无感:直接跳回文档页,一个键都不用按。
首次使用会出现一次「授权 knife4j-api-docs-sso 访问您的帐户?」确认页:点「应用授权」即可,每个账号只出现这一次。
登录一次 30 天免登录(Cookie 有效期 720h,期间自动静默续期),浏览器重启也不用重新登录。
API 调用本身零影响:/admin/、/mp/、/v3/ 等接口的认证方式不变,仅 doc.html、/webjars/、/v2/api-docs、/swagger-resources 四个文档路径换了认证。

场景	旧	新
打开 doc.html	浏览器弹 Basic Auth 框,输文档专用账号	跳 Gitea 登录页(已登录 Gitea 则无感直进)
浏览器重启后	重新弹框输密码	Cookie 30 天内免登录
账号管理	共享一个 hulalv 账号	各自 Gitea 账号(cz/liutao/mmg/wx/yst 均可用)