> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/latex/zh-cn/zhi-shi-ku/042-git-integration-authentication-tokens.md). # Git 集成身份验证令牌 **本页介绍通过 Overleaf 的** [**Git 集成**](/latex/zh-cn/zhi-shi-ku/040-git-integration.md)。本文介绍的身份验证令牌方法是 Overleaf Cloud 和 Server Pro 唯一可用的登录方式。较旧的基于用户名和密码的身份验证方法已不再可用。 Overleaf 的 Git 集成允许您将 Overleaf 项目克隆到本地仓库，并将其视为一个远程仓库，您可以向其推送更改并从中拉取更改。 摘要 要使用 Git 对 Overleaf 项目执行 Git 操作，您需要以项目所有者或协作者身份进行身份验证。您可以使用一个 **Git 身份验证令牌**。您可以在您的 [Overleaf 账户设置](https://www.overleaf.com/user/settings). * 如果系统提示输入用户名，请输入用户名“git” * 当系统提示输入密码时，请输入您的身份验证令牌 * 同一个身份验证令牌可用于通过 Git 访问您的所有项目 * 您生成的令牌应仅由您本人使用，并安全存储 执行 Git 操作时，请使用用户名 **git** 并将身份验证令牌用作密码。同一个身份验证令牌可用于通过 Git 访问您的所有项目。您生成的令牌应仅由您本人使用，并安全存储。您可以在您的 Overleaf [账户设置](https://www.overleaf.com/user/settings) 页面。 ### 逐步说明：如何使用 Overleaf Git 身份验证令牌克隆项目 **以下步骤说明了在使用 Git 命令行时如何克隆您的 Overleaf 项目。** 如果您使用其他 Git 客户端，可以使用适合该客户端的方法来提供项目的 Git URL，以“git”作为用户名，并以 Git 身份验证令牌作为密码。请参见 [理解 Git URL](#understanding-the-git-url) ，了解 Git URL 各组成部分的说明。 1. 选择 **Git** 从该 [菜单](/latex/zh-cn/zhi-shi-ku/148-using-the-overleaf-project-menu.md) 在您的项目中。 ![项目菜单 git.png](/files/0be109e0731ab0d955d5feeb0bf07d9ebb6f8c47) 1. 复制对话框中显示的 git clone 命令和 URL。创建本地仓库时会用到它。 2. 将该命令和 URL 粘贴到命令提示符中。请注意，在提供的命令中，“git” 已作为用户名提供。 3. 获取您的 Git 身份验证令牌 * 如果您以前尚未创建过 Git 身份验证令牌，系统将为您提供立即生成一个的选项。要这样做，请点击 **生成令牌**. * 如果您已经创建过 Git 身份验证令牌，您可以继续使用同一个，或者在您的 Overleaf [账户设置](https://www.overleaf.com/user/settings). **小贴士**：您可以 [设置 Git 凭据帮助程序](#how-to-save-your-token-using-git-credential-helpers) ，这样您就无需每次都提供令牌。 4. 当系统提示输入密码时，请输入您的身份验证令牌。 ### 逐步说明：如何将 Git 远程 URL 从基于密码的格式更新为基于身份验证令牌的格式 **以下步骤说明了如何将 Git 远程 URL 从之前基于密码的格式更新为新的基于身份验证令牌的格式。** 1\. 打开您的终端并导航到项目目录： ``` cd path/to/your/project ``` 2\. 检查当前的远程 URL： ``` git remote -v ``` 这将显示远程仓库的当前 URL。 3\. 使用以下命令更新远程 URL： ``` git remote set-url origin https://git@git.overleaf.com/ ``` 将其替换为您的项目 ID 4\. 再次运行远程命令，确认更改是否成功： ``` git remote -v ``` 您现在应该能看到列出的新 URL。 在下次从该本地仓库执行拉取或推送时，您需要提供一个身份验证令牌作为密码。如果您尚未生成身份验证令牌，可以在您的账户设置中生成。使用身份验证令牌时，如果系统提示输入用户名，请使用“git”，并将身份验证令牌作为密码——您可以通过使用凭据帮助程序来避免在每次操作时都提供这些凭据（见下方说明）。 ### 有关身份验证令牌的更多帮助 #### 了解 Overleaf Git 身份验证令牌 * 就像密码一样，Git 身份验证令牌可提供给 Git 操作以确认您的身份。就像您不会分享密码一样，您也绝不应分享身份验证令牌。 * 您生成的身份验证令牌可用于您通过 Git 集成访问的所有项目。 * 令牌将在一年后过期。 * **您最多可以拥有 10 个令牌。** 如果您已达到 10 个令牌的上限，应删除旧的未使用或已过期令牌，以便创建新令牌。 * 我们建议使用 Git 凭据帮助程序来存储您的身份验证令牌，这样您每次使用 Git 集成时就无需输入它。下面有更多关于如何设置的说明。 #### 如何生成身份验证令牌 * 您可以在您的 [账户设置](https://www.overleaf.com/user/settings)。您最多可以生成 10 个令牌。 * 您首次使用 Git 集成时，还可以在选择 **Git** 在项目中 **菜单**. #### 如何使用 Git 凭据帮助程序保存您的令牌 我们建议使用 Git 凭据帮助程序。这将使您的 Git 客户端记住您的令牌。 如果您使用 Git 命令行客户端，可以运行此命令来存储您的凭据： ``` $ git config --global credential.helper store ``` 关于这一点的更多信息请参见此 [Git 文档页面](https://git-scm.com/book/en/v2/Git-Tools-Credential-Storage). #### 查看之前生成的令牌 您可以在账户设置中找到 Git 身份验证令牌列表。不过，您无法查看完整令牌。如果您记不住令牌，并且未启用 Git 凭据帮助程序，则需要生成一个新的。您可以在账户设置中这样做。 #### 删除已生成的令牌 删除令牌后，在执行 Git 操作时，它将不再可用于验证您的身份。如果您尝试使用已过期或已删除的令牌执行操作，您的 Git 客户端很可能会报告身份验证错误。 #### 如何与协作者协作 如果您使用 Overleaf 的 Git 集成与通常不使用 Overleaf 的人协作，您应与他们共享项目，他们可以创建一个 Overleaf 账户。完成后，他们可以获取该项目的 Git URL，并生成自己的令牌以访问该项目。 **您绝不应共享令牌。请像对待用户名和密码一样安全地对待它。如果您觉得自己不小心共享了令牌，应将其删除。** ### 理解 Git URL 该 `git clone` 以及 Git URL 可通过选择 **Git** 在项目中 **菜单**来获取。或者，您也可以从项目 URL 中找到 Git URL（即您在项目中时浏览器地址栏中的 URL）。 #### Overleaf Cloud 如果您的 Overleaf 项目 URL 看起来像： ``` https://www.overleaf.com/project/1234567 ``` 那么用于克隆该项目的 Git URL 将是： ``` https://git.overleaf.com/1234567 ``` 您的用户名将是 **git** ，密码将是您从 Overleaf 账户获取的令牌。 项目菜单中的 Git 弹窗里提供的命令和 URL 包括：(1) 在 Git 命令行中使用的 git clone 命令，以及 (2) 包含在项目 ID 前面加上“git”用户名的完整 Git URL。 ![git clone 命令和 URL 字符串的视觉说明](/files/7d3e76cf6a298dc8e4f546293d7a0df5bca6782d) #### Overleaf Server Pro 如果您的 Overleaf 项目 URL 看起来像： ``` https:///project/1234567 ``` 注意：\ 是您的 Overleaf Server Pro 管理员设置的主机值。 那么用于克隆该项目的 Git URL 将是： ``` https:///git/1234567 ``` 您的用户名将是 **git** ，密码将是您从 Overleaf 账户获取的令牌。 项目菜单中的 Git 弹窗里提供的命令和 URL 包括：(1) 在 Git 命令行中使用的 git clone 命令，以及 (2) 包含“git”用户名、您特定的 Overleaf 主机以及包含项目 ID 的路径的完整 Git URL。 ![git clone 命令和 URL 字符串的视觉说明](/files/ca49725fb933234f87f7c5b7a95e28270608e3d0) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ayakaleaf-pro.ayaka.space/latex/zh-cn/zhi-shi-ku/042-git-integration-authentication-tokens.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.