---
title: "Import from Git V2：管理 GitHub 连接与仓库访问范围"
language: "zh"
url: "https://docs.testany.io/zh/docs/import-from-git-v2-manage-connections/"
markdown_url: "https://docs.testany.io/zh/docs/import-from-git-v2-manage-connections.md"
translation: "https://docs.testany.io/en/docs/import-from-git-v2-manage-connections.md"
last_updated: "2026-03-26T15:39:24+08:00"
---

# Import from Git V2：管理 GitHub 连接与仓库访问范围

## 1. Connection Management 是做什么的

`Connection Management` 是 V2 的访问控制面板。

您可以在这里：

- 连接 GitHub 账号
- 查看每个账号的当前状态
- 按 GitHub App installation 管理仓库访问范围
- 在 GitHub 侧变更后刷新仓库范围

![Import from Git V2 连接管理](https://docs.testany.io/docs/images/zh/import-git-v2-connection-management-zh.png)

## 2. 理解“两阶段访问模型”

V2 不是“贴一个凭证就结束”的流程。

要让一个仓库真正可导入，下面两件事必须同时成立：

1. GitHub 账号已经在 Testany 中连接成功。
2. `Testany Git Connector` 已经在仓库所属 owner 上获得仓库访问权限。

这就是为什么您有时已经能在 Testany 里看到 GitHub 账号卡片，但向导里仍然看不到任何仓库。

## 3. 如何连接 GitHub 账号

连接新账号的步骤如下：

1. 打开 `Connection Management`
2. 点击 `Connect GitHub` 或 `Add New Account`
3. 完成 GitHub 授权弹窗

授权成功后，Testany 会：

- 新建一条连接
- 或者如果该 GitHub 账号已经存在，则复用现有连接

## 4. installation 和仓库范围怎么理解

一个已连接的 GitHub 账号，可能会对应多个仓库 owner，例如：

- 您自己的个人账号
- 一个或多个 GitHub 组织

在 Testany 中，它们会显示成多个 installation binding，每个 binding 都有自己独立的仓库访问范围。

![Import from Git V2 installation 范围详情](https://docs.testany.io/docs/images/zh/import-git-v2-connection-scope-zh.png)

界面会显示这类信息：

- installation owner
- 已选仓库数
- 当前可导入仓库数
- 最近验证时间

## 5. 各种状态分别是什么意思

| 状态 | 含义 | 下一步应该做什么 |
| --- | --- | --- |
| `Ready` | 账号已连接，仓库范围也已就绪 | 直接进入导入向导 |
| `Needs GitHub App Access` | GitHub 账号已连接，但 owner 还没有提供可用的 App 访问 | 打开 `Manage Repository Access`，或联系能管理该仓库访问范围的人处理 |
| `GitHub App Scope Empty` | App 范围存在，但当前没有任何可导入仓库 | 在 GitHub 中把目标仓库加入范围，然后回到 Testany 刷新 |
| `App Access Changed` | GitHub 侧仓库访问在上次快照之后发生了变化 | 先刷新范围，再重新确认目标仓库是否可见 |
| `Reconnect Required` | GitHub 账号授权已过期 | 重新连接 GitHub 账号 |
| `Needs Install` | App 安装本身还未完成 | 先在 GitHub 完成安装 |

## 6. 主要操作按钮该怎么用

### 6.1 Manage Repository Access

`Manage Repository Access` 会把您带到当前 owner 对应的 GitHub 入口。

以下场景都应该用它：

- 这个 owner 还没有安装 App
- App 已安装，但目标仓库没有被选进访问范围
- 您想检查当前到底开放了哪些仓库

### 6.2 Refresh GitHub App Scope

当您已经在 GitHub 里改完仓库访问范围后，需要回到 Testany 点击 `Refresh GitHub App Scope`。

这一步会让 Testany 重新构建它所使用的范围快照。

如果省略这一步，Testany 可能仍然停留在旧快照上。

### 6.3 Reconnect GitHub Account

当账号授权过期，或者 Testany 提示需要重新授权时，请使用 `Reconnect GitHub Account`。

## 7. 个人账号 owner 和组织 owner 的区别

目标仓库属于谁，会直接决定操作方式：

**个人账号**

- 该 GitHub 账号的持有者通常可以自己管理 App 访问范围

**组织**

- 目标仓库加入访问范围通常有两条途径：
- GitHub 组织管理员在组织 installation 中调整已选仓库
- 目标仓库管理员从仓库侧把该仓库加入访问范围


> **警告**
>
> 如果目标仓库属于 GitHub 组织，而您既不是组织管理员，也不是目标仓库管理员，请不要反复在 Testany 里重试。先联系能管理该仓库访问范围的人在 GitHub 侧处理，再回来刷新即可。


## 8. 为什么仓库还是看不到

如果仓库下拉框仍然为空，请按以下顺序排查：

1. 连接的是不是正确的 GitHub 账号
2. 在向导里选的是不是正确的 installation
3. 目标仓库是否已被加入这个 installation 的 GitHub App 范围
4. GitHub 侧改动后，是否已经执行 `Refresh GitHub App Scope`
5. 当前连接状态是否不是 `Reconnect Required`

## 9. 相关文档

连接就绪后，继续阅读：

- [Import from Git V2：连接 GitHub 并创建导入](https://docs.testany.io/zh/docs/import-from-git-v2-create-import.md)
- [Import from Git V2：维护 Sync Link 导入](https://docs.testany.io/zh/docs/import-from-git-v2-manage-sync-link.md)
- [Import from Git V2：维护 Managed Import 导入](https://docs.testany.io/zh/docs/import-from-git-v2-manage-managed-import.md)

## 本页术语

- [仓库访问范围 (Repository Access Scope)](https://docs.testany.io/zh/docs/glossary.md#repository-access-scope)
- [执行 (Execution)](https://docs.testany.io/zh/docs/glossary.md#execution)