---
url: /zh/guide/git-access.md
description: |
  说明 CNB 平台 Git 仓库地址格式规范及认证方式， 介绍如何使用访问令牌通过 HTTPS 认证 Git 操作。
---
## Git 仓库地址

Git 仓库地址直接使用**仓库页面地址**，无需添加 `.git` 后缀：

`https://cnbprod.alpha.qq.com/group-path/repo-path`

该地址与浏览器中访问仓库主页的 URL 相同，同时兼容带 `.git` 后缀的传统格式。

### 说明

* **使用便捷**：可直接从浏览器地址栏复制仓库 URL 作为 Git 地址。
* **兼容传统格式**：带 `.git` 后缀的格式同样支持。
* **功能一致**：两种格式均支持完整的 Git 操作，无功能差异。

## 认证方式

平台通过**访问令牌**认证：

* **用户名**：固定填写 `cnb`
* **密码**：填写创建的访问令牌（支持权限配置）

更多用法请参考：[访问令牌](./access-token.md)

> 第三方工具（如 IDE、Git 客户端）连接时，需在密码字段填写令牌，用户名字段填写 `cnb`。

### 命令示例

下面以 `git clone` 与 `git push` 为例，演示使用访问令牌进行 Git 操作的完整流程：

```bash
# 1. 克隆仓库（若是私有仓库，会提示输入凭据）
git clone https://cnbprod.alpha.qq.com/group-path/repo-path
cd repo-path

# 2. 修改代码并推送
git add .
git commit -m "feat: init"
git push origin main
```

> 提示：按提示输入用户名/密码时，用户名填 `cnb`，密码填你的[访问令牌](./access-token.md)。

### 设计背景

* 令牌支持细粒度权限控制（读写/只读），可随时撤销或更新，安全性高于静态密码。
* 固定用户名 `cnb` 简化认证流程，
  避免自定义用户名冲突或弱密码导致的安全风险。

## 不支持 SSH

平台不支持 SSH 协议访问，原因如下：

1. **安全性更高**：HTTPS + 令牌支持短期有效期和权限分级，可随时撤销，比长期有效的 SSH 私钥更易管理。
2. **使用门槛低**：无需生成 SSH 密钥或上传公钥，适合新手和临时协作者。
3. **防中间人攻击**：SSH 协议在公网环境下存在中间人劫持风险，
   绝大多数用户不会核对首次连接的指纹信息。
   HTTPS 的 CA 信任链机制自动解决了这一问题。