功能调试¶

调试登录¶

调试登录用于在开发/联调时**免密切换前台用户**，通过管理后台「调试模式」进入 debuglogin.html，选择企业域与用户后直接以该用户身份进入运行时（写入 debugToken Cookie，无需该用户密码）。

该能力仅供本机开发使用，须同时满足：

本机访问：浏览器地址必须是 localhost、127.0.0.1 或 IPv6 ::1。经局域网 IP、机器名或远程主机访问会被拒绝（HTTP 403）。
合法 adminToken：须先登录管理后台（获得管理员 JWT）。令牌可通过 Cookie（登录后自动写入，path=/）、请求头 adminToken 或 query 参数传递。缺失、过期、伪造或已注销时返回 HTTP 401。

第一步：用本机地址打开管理后台并登录。

例如 http://localhost:8080/manager（经网关）或对应管理端端口。登录成功后浏览器会带上 HttpOnly 的 adminToken Cookie。

第二步：在管理首页点击「调试模式」。

入口仅在本机访问时显示，链接为 /static/login/debuglogin.html。也可直接访问：

http://localhost:8080/static/login/debuglogin.html

或 runtime 直连（须已在本机登录过管理后台，Cookie 对 localhost 各端口共享）：

http://localhost:8083/static/login/debuglogin.html

第三步：选择企业域与用户，点击登录。

无需填写密码。成功后跳转前台门户（debugToken 写入 Cookie），后续 runtime 接口可用该令牌作为登录态。

条件	HTTP	说明
非本机（非回环地址，或 `X-Forwarded-For` 等转发头含非本机 IP）	403	提示「调试登录仅允许本机 localhost / 127.0.0.1 访问」
本机但无合法 adminToken	401	提示「调试登录需要合法的管理员令牌，请先登录管理后台」