卡片能做什么
配置 Gitea 集成后，首页出现「Gitea」卡片，实时展示你的自托管 Git 仓库动态：账号与仓库总数的统计格、最近更新的仓库列表（仓库名 / 主语言 / Star / 更新时间），私有、归档与 Fork 的仓库带标记区分，点击任意仓库直达 Gitea 页面。
- 统计格：账号 + 仓库总数
- 最近更新仓库列表：名称 / 语言 / Star / 更新时间
- 私有、归档、Fork 标记区分
- 免费功能，无需 Pro 授权
接入步骤
进入「设置 → 集成 → Gitea」，填写两项信息：
- 服务地址：Gitea 访问地址（如 http://192.168.1.100:3000），支持内网 IP 与自定义域名
- Access Token：在 Gitea「设置 → 应用 → 管理 Access Token 令牌」中生成（勾选 repository 权限），令牌仅显示一次
填写后点击「测试连接」，通过后保存，首页 Gitea 卡片立即生效。版本兼容：Gitea 1.16+ 全版本，API 长期稳定，持续兼容新版本。
Access Token 生成步骤
Token 在 Gitea 侧生成，BestNav 无法替你创建：
- 1. 打开 Gitea Web 界面，登录账号
- 2. 点击右上角头像 → 「设置」
- 3. 进入「应用 → 管理 Access Token 令牌」
- 4. 输入令牌名称，勾选 repository 权限后生成
- 5. 复制生成的 Token 填入 BestNav（仅显示一次，请及时保存）
- 6. 服务地址填 Gitea 访问地址（如 http://192.168.1.100:3000）
常见问题
- Token 只显示一次，忘了保存怎么办？在 Gitea 删除旧令牌重新生成即可，无需其他操作
- Token 是否安全？令牌加密存储于你的服务器本地，仅用于读取仓库信息
- 会不会修改我的仓库？卡片为只读展示，不会写入或删除任何数据
- 权限最小化：建议只勾选 repository 读取权限，不要授予 admin 权限
What the Card Shows
After configuring the Gitea integration, a Gitea card appears on the home page with your self-hosted Git activity: an account + repo-count stat, and a recent-repos list (name / main language / stars / last updated), with private, archived and forked repos flagged. Click any repo to jump straight to Gitea.
- Stats: account + total repos
- Recent repos: name / language / stars / last updated
- Private, archived and fork flags
- Free feature — no Pro license needed
Setup
Go to Settings → Integrations → Gitea and fill in two fields:
- Server URL: your Gitea address (e.g. http://192.168.1.100:3000); LAN IPs and custom domains work
- Access Token: generate one in Gitea “Settings → Applications → Manage Access Tokens” (repository scope); shown only once
Click “Test Connection”, then save — the Gitea card appears on the home page instantly. Version compatibility: Gitea 1.16+ — the API is stable and continuously compatible with new releases.
Generating an Access Token
Tokens are created on the Gitea side; BestNav cannot create one for you:
- 1. Open the Gitea web UI and sign in
- 2. Click your avatar in the top right → “Settings”
- 3. Go to “Applications → Manage Access Tokens”
- 4. Enter a token name, select repository scopes, then generate
- 5. Copy the token into BestNav (shown only once — save it)
- 6. Enter the Gitea URL (e.g. http://192.168.1.100:3000)
FAQ
- Lost the token after it was shown once? Delete it in Gitea and generate a new one — nothing else needed
- Is the token safe? It is encrypted and stored on your own server, used only to read repo info
- Will it modify my repos? The card is read-only — it never writes or deletes anything
- Least privilege: grant repository read scope only, never admin