> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kasoftware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Git 版本控制设置

> 如何为知行之桥配置基于 Git 的版本控制，以实现配置追踪和环境管理。

export const cloudEnv = false;

export const siteNameShort = "知行之桥";

export const siteName = "知行之桥";

{!cloudEnv && (
<p>可以在 {siteName} 中使用<a href="../installation/git-version-control">基于 Git 的版本控制</a>，实现配置追踪、审计追踪和环境管理。在使用之前，必须安装 Git 并创建远程仓库。有关说明，请参阅<a href="../installation/git-version-control#prerequisites">前提条件</a>。</p>
)}

要完成配置，请导航至**设置 > 高级 > Git 版本控制**，然后点击**配置**。

<img src="https://mintcdn.com/qiao/ilnLy7gsSdFqbKmI/public/images/settings_git.png?fit=max&auto=format&n=ilnLy7gsSdFqbKmI&q=85&s=33a07fc4f8f6bcc270e1ce1cb6204d37" alt="Git version control configuration pane" width="400" data-path="public/images/settings_git.png" />

请提供以下信息：

* 远程 Git 仓库的 URL。如果使用 SSH，请勿在此处输入 HTTPS 地址，必须使用 SSH 地址（例如 `git@github.com:username/private-repo.git`）。支持所有主流 Git 平台（如 GitHub、GitLab、Bitbucket 和 Azure DevOps）。
* 认证方案。选择认证方案后，会显示配置所需的字段。
  * HTTPS：连接到仓库所需的**用户名**和**密码**或**令牌**。
  * SSH：连接到仓库所需的 **SSH 私钥**文件和**密码短语**。详情请参阅[使用 SSH 认证](#使用-ssh-认证)。
  * OAuth：点击**获取访问令牌**以检索用于连接的访问令牌。

点击**保存**后，{siteNameShort} 将连接到仓库并运行初始化任务。该初始化会在 `AppDirectory` 内部创建一个 Git 仓库，创建一个名为 `settings-before-git-init-<initialization_date>` 的分支（包含初始化时的现有配置），并将这些配置文件暂存以待提交。这确保了在远程仓库已有内容且与这些设置冲突时，配置不会丢失。

{siteNameShort} 的页脚将变为状态栏，显示多项 Git 指标和操作，例如当前本地修改的文件数量、远程提交数量以及当前分支。点击工具栏上的**提交并推送**，即可将初始提交推送到远程仓库。

<img src="https://mintcdn.com/qiao/ilnLy7gsSdFqbKmI/public/images/version_control_footer_toolbar.png?fit=max&auto=format&n=ilnLy7gsSdFqbKmI&q=85&s=3bb76694d52f283ecb33cd14f02f16aa" alt="Git version control footer toolbar" width="800" data-path="public/images/version_control_footer_toolbar.png" />

## 使用 SSH 认证

按照以下步骤使用 SSH 进行认证：

* 运行 `ls -al ~/.ssh` 检查是否存在现有的 SSH 密钥。
* 如果已有密钥，可以直接使用。或者运行以下命令生成新的 SSH 公钥/私钥对：`ssh-keygen -t ed25519 -C "your_email@example.com"`。
* 可选择为密钥添加密码短语以增强安全性。
* 使用 **SSH 私钥**字段上传您的私钥。
* 将公共 SSH 密钥添加到您的 Git 平台。

有关如何使用 SSH 认证的更多信息，请查阅您的 Git 平台文档。