用途:通过 Forgejo CLI(fj)对 Forgejo 实例进行认证并执行常见操作,包括议题、PR 和仓库管理,同时正确指定主机、排查主机与登录不匹配问题。
前置条件:需在 Forgejo 网页界面创建个人访问令牌(PAT);fj 已安装并在 PATH 中;可选使用 secret-tool(GNOME Keyring)安全存储令牌。
主机用法:-H/--host 是全局选项,必须放在子命令之前,例如:fj -H <FORGEJO_HOST> repo view <owner>/<repo>。为避免重复指定,可设置环境变量:export FJ_HOST=<FORGEJO_HOST>。
认证示例(secret-tool):一次性存储令牌并注册:echo -n "<PAT_VALUE>" | secret-tool store --label="Forgejo PAT" service forgejo user <username>@<FORGEJO_HOST>;echo -n "$(secret-tool lookup service forgejo user <username>@<FORGEJO_HOST>)" | fj -H <FORGEJO_HOST> auth add-key <username>。验证:fj -H <FORGEJO_HOST> auth list 与 fj -H <FORGEJO_HOST> whoami。清理:fj auth logout <FORGEJO_HOST>;secret-tool clear service forgejo user <username>@<FORGEJO_HOST>。
限制与排查:出现“not logged in”通常因主机默认指向 github.com,需添加 -H 或设置 FJ_HOST;若 secret-tool lookup 无返回,需解锁钥匙串或确认存储的用户/主机键。资料未提供收费、价格、平台及效果信息。