本文主要记录在 Linux 上安装 Gitea 官方 CLI tea，用个人访问令牌登录自建 Gitea，并用 tea whoami 验证。可与 git-lfs、git-rm-cached 等 Git 文对照。

背景说明

tea 用于在命令行操作 Gitea（仓库、PR 等）。推荐流程：本机安装 → 网页生成 Token → tea logins add → 验证。

安装 tea（示例）

mkdir -p "$HOME/.local/bin"
curl -L "https://dl.gitea.com/tea/0.13.0/tea-0.13.0-linux-amd64" -o "$HOME/.local/bin/tea"
chmod +x "$HOME/.local/bin/tea"
echo 'export PATH="$HOME/.local/bin:$PATH"' >> "$HOME/.bashrc"
export PATH="$HOME/.local/bin:$PATH"
tea --version

版本号请按 tea 发布页 调整；zsh 用户写入 ~/.zshrc。

生成 Token

在 Gitea Web：头像 → Settings → Applications → 生成 Access Token。

  • 权限至少覆盖目标仓库的写/PR 需求
  • 不要把 token 写进公开文档或发给他人

登录与验证

tea logins add --name <profile-name> --url "https://<gitea-host>" --token "<YOUR_TOKEN>"
tea logins default <profile-name>
tea whoami

若输出当前用户信息，说明配置成功。

注意事项

  • 示例域名请替换为实际 Gitea 地址。
  • Token 泄漏后立即在网页吊销并轮换。
  • 本文不记录任何真实 token。