For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /ethereal/site/auth.md.

楠枝文档中心

登录与认证页

适用版本 ≥ 2.0.0 ｜后台路径：主题设置 → 杂项设置 → 认证设置

访客触发登录（评论、会员页、后台入口）时看到的登录页样式。

配置项

选项	默认值	说明
登录界面	Halo 默认	主题认证界面：使用主题风格的双栏登录页；Halo 默认：使用 Halo 官方登录样式

两种界面的差异

	主题认证界面	Halo 默认
视觉	双栏：左侧主题色面板 + 站点标题 + 头像 + 角色动画，右侧登录表单	Halo 官方样式
配色	跟随主题色相与深浅色	跟随 Halo 后台
适配	需要主题存在且启用	与主题无关，切主题也保持
装饰图标	隐藏 Halo 注入的装饰图标，避免与角色动画错位	保留

推荐配法

希望前后台观感统一：选「主题认证界面」。左侧头像取自「侧边栏 → 个人简介 → 头像」，未设置时使用主题示例头像。

多人协作 / 常进后台：选「Halo 默认」。登录页更朴素，但不会被主题升级影响，也不依赖前端资源加载。

排查登录问题：临时切换成「Halo 默认」，若问题消失，说明是主题资源或脚本冲突。

注意事项

切换后立即生效，无需重启；但浏览器可能缓存旧样式，切换后强刷一次
主题认证界面只影响登录网关页，不改变后台管理界面的样式
若使用了人机验证插件，主题登录页已对插件注入的元素做兼容；仍出现错位时优先切换回 Halo 默认
登录页不读取 Banner 设置，背景由主题色生成，不用担心 Banner 图片被用作登录背景