Halo CLI 认证

使用此技能处理 halo auth 和 halo auth profile 命令。

如果尚未设置认证，请在运行 post、single-page、plugin、theme、attachment、backup、moment、comment 或 notification 命令之前先完成认证设置。

命令

bash
halo auth --help
halo auth login --help
halo auth profile --help

主要工作流程：

• - halo auth login
• halo auth current
• halo auth profile list
• halo auth profile current
• halo auth profile get
• halo auth profile use
• halo auth profile delete
• halo auth profile doctor

常见流程

使用 Bearer Token 登录：

bash
halo auth login \
--profile local \
--url http://127.0.0.1:8090 \
--auth-type bearer \
--token

使用基本认证登录：

bash
halo auth login \
--profile local \
--url http://127.0.0.1:8090 \
--auth-type basic \
--username admin \
--password

查看和切换配置：

bash
halo auth current
halo auth profile list
halo auth profile use production
halo auth profile get production --json

诊断损坏的凭证：

bash
halo auth profile doctor
halo auth profile delete production --force
halo auth login --profile production --url https://halo.example.com --auth-type bearer --token

规则

• - 在非交互模式下，halo auth login 需要 --profile、--url 和 --auth-type 参数。
• basic 认证需要 --username 和 --password 参数。
• bearer 认证需要 --token 参数。
• 当其他工具需要结构化输出时，使用 --json 参数。
• profile delete 是破坏性操作；在非交互模式下需要使用 --force 参数。
• 配置元数据存储在配置文件中，但密钥存储在系统密钥环中。

路由

• - 使用 halo-cli-content 处理文章和单页。
• 使用 halo-cli-search 进行公开站点搜索。
• 使用 halo-cli-operations 处理主题、插件、附件、备份和动态。
• 使用 halo-cli-moderation-notifications 处理评论、回复和通知。