# A.2.使用 Git ### A.2.1. 介绍 截至 2020 年 12 月，FreeBSD 使用 git 作为存储所有 FreeBSD 基础源代码和文档的主要版本控制系统。截至 2021 年 4 月，FreeBSD 使用 git 作为存储所有 FreeBSD ports 的唯一版本控制系统。 本节演示了如何在 FreeBSD 系统上安装 Git 并使用它创建 FreeBSD 源代码存储库的本地副本。 ### A.2.2. 安装 Git 可以从 Ports 中安装，或者作为软件包安装： ```sh # pkg install git ``` ### A.2.3. 运行 Git 要将源代码的干净副本提取到本地目录中，请使用 git clone。这些文件的目录称为工作树。 Git 使用 URL 来指定存储库。有三个不同的存储库，src 用于 FreeBSD 系统源代码，doc 用于文档，ports 用于 FreeBSD Ports 。所有三个存储库都可以通过两种不同的协议访问：HTTPS 和 SSH。例如，URL [https://git.FreeBSD.org/src.git](https://git.freebsd.org/src.git) 指定了 src 存储库的主分支，使用 https 协议。 表 1. FreeBSD Git 存储库 URL 表 | Item | Git URL | | ---------------------------- | ------------------------------------------------------------------------ | | Read-only src repo via HTTPS | [`https://git.FreeBSD.org/src.git`](https://git.freebsd.org/src.git) | | 通过 anon-ssh 访问只读源代码存储库 | `ssh://anongit@git.FreeBSD.org/src.git` | | 通过 HTTPS 访问只读文档存储库 | [`https://git.FreeBSD.org/doc.git`](https://git.freebsd.org/doc.git) | | 通过 anon-ssh 访问只读文档存储库 | `ssh://anongit@git.FreeBSD.org/doc.git` | | 通过 HTTPS 读取只读 ports 存储库 | [`https://git.FreeBSD.org/ports.git`](https://git.freebsd.org/ports.git) | | 通过 anon-ssh 读取只读 ports 存储库 | `ssh://anongit@git.FreeBSD.org/ports.git` | 项目成员维护的外部镜像也可用；请参考外部镜像部分。 克隆 FreeBSD 系统源代码存储库的副本： ```sh # git clone -o freebsd https://git.FreeBSD.org/src.git /usr/src ``` -o freebsd 选项指定源头；按照 FreeBSD 文档规定，源头默认为 freebsd。由于初始的检出必须下载远程存储库的完整分支，可能需要一些时间。请耐心等待。 最初，工作树包含 main 分支的源代码，对应于 CURRENT。要改为使用 13-STABLE： ```sh # cd /usr/src # git checkout stable/13 ``` 工作树可以使用 git pull 进行更新。要更新上面示例中创建的 /usr/src，请使用： ```sh # cd /usr/src # git pull --rebase ``` 更新比检出快得多，只传输已更改的文件。 ### A.2.4. 基于 Web 的仓库浏览器 FreeBSD 项目使用 cgit 作为基于 web 的存储库浏览器：[https://cgit.FreeBSD.org/。](https://cgit.freebsd.org/%E3%80%82) ### A.2.5. 对于开发人员 有关对存储库的写访问权限的信息，请参阅 Committer’s Guide。 ### A.2.6. 外部镜像 这些镜像并非托管在 FreeBSD.org 上，但仍由项目成员维护。用户和开发人员可以拉取或浏览这些镜像上的存储库。对 doc 和 src GitHub 存储库的拉取请求正在接受；否则，与这些镜像的项目工作流程仍在讨论中。 Codeberg * 文档: * ports: * 源码: GitHub * 文档: * ports: * 源码： GitLab * 文档： * ports： * src： ### A.2.7. 邮件列表 FreeBSD 项目中用于一般使用和关于 git 的问题的主邮件列表是 freebsd-git。有关更多详细信息，包括提交消息列表，请参阅邮件列表章节。 ### A.2.8. SSH 主机密钥 * gitrepo.FreeBSD.org 主机密钥指纹: * ECDSA 密钥指纹是 SHA256:seWO5D27ySURcx4bknTNKlC1mgai0whP443PAKEvvZA * ED25519 密钥指纹是 SHA256:lNR6i4BEOaaUhmDHBA1WJsO7H3KtvjE2r5q4sOxtIWo * RSA 密钥指纹是 SHA256:f453CUEFXEJAXlKeEHV+ajJfeEfx9MdKQUD7lIscnQI * git.FreeBSD.org 主机密钥指纹： * ECDSA 密钥指纹为 SHA256:/UlirUAsGiitupxmtsn7f9b7zCWd0vCs4Yo/tpVWP9w * ED25519 密钥指纹为 SHA256:y1ljKrKMD3lDObRUG3xJ9gXwEIuqnh306tSyFd1tuZE * RSA 密钥指纹为 SHA256:jBe6FQGoH4HjvrIVM23dcnLZk9kmpdezR/CvQzm7rJM 这些也会作为 SSHFP 记录发布在 DNS 中。