> For the complete documentation index, see [llms.txt](https://overleaf-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://overleaf-pro.ayaka.space/latex/zh-tw/zhi-shi-ku/042-git-integration-authentication-tokens.md).

# Git 整合驗證權杖

**此頁面說明透過 Overleaf 的** [**Git 整合**](/latex/zh-tw/zhi-shi-ku/040-git-integration.md)。此處說明的驗證權杖方法，是 Overleaf Cloud 與 Server Pro 唯一可用的登入方式。較舊的使用者名稱與密碼驗證方式已不再提供。

Overleaf Git 整合可讓您將 Overleaf 專案複製到本機儲存庫，並將您的 Overleaf 專案視為遠端儲存庫，可對其推送與從中拉取變更。

摘要

若要使用 Git 對 Overleaf 專案執行 Git 操作，您需要以專案擁有者或協作者身分驗證。您可以使用一個 **Git 驗證權杖**來完成。您可以在您的 [Overleaf 帳戶設定](https://www.overleaf.com/user/settings).

* 如果系統提示輸入使用者名稱，請輸入使用者名稱「git」
* 如果系統提示輸入密碼，請輸入您的驗證權杖
* 同一個驗證權杖可用於透過 Git 存取您所有的專案
* 您產生的權杖應僅供您自己使用，並妥善安全地存放

執行 Git 操作時，請使用使用者名稱 **git** 並將驗證權杖用作密碼。相同的驗證權杖可用於透過 Git 存取您所有的專案。您產生的權杖應僅供您自己使用，並妥善安全地存放。您可以在您的 Overleaf [帳戶設定](https://www.overleaf.com/user/settings) 頁面的整合區段中開啟或關閉 Writefull for Overleaf。

### 逐步說明：如何使用 Overleaf Git 驗證權杖複製專案

**以下步驟說明在使用 Git 命令列時，如何複製您的 Overleaf 專案。**

如果您使用的是其他 Git 用戶端，您可以採用適合該用戶端的方法，提供該專案的 Git URL，並以「git」作為使用者名稱，以及將 Git 驗證權杖作為密碼。請參見 [了解 Git URL](#understanding-the-git-url) 以說明 Git URL 的各個組成部分。

1. 選擇 **Git** 來自 [選單](/latex/zh-tw/zhi-shi-ku/148-using-the-overleaf-project-menu.md) 在您的專案中。

![專案選單 git.png](/files/b2c1420747700464f3c56b685ee91952f45f3569)

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/<YOUR_PROJECT_ID>
```

請將其替換為您的專案 ID

4\. 重新執行遠端指令，以確認變更成功：

```
git remote -v
```

您現在應該會看到列出的新 URL。

在下次從此本機儲存庫執行 pull 或 push 時，您需要提供驗證權杖作為密碼。如果您尚未產生驗證權杖，可以從您的帳戶設定中執行。使用驗證權杖時，如果系統提示輸入使用者名稱，請使用「git」，並將驗證權杖作為密碼；您可以使用認證協助程式（見下方註解）來避免每次操作都提供這些憑證。

### 關於驗證權杖的更多協助

#### 了解 Overleaf Git 驗證權杖

* 就像密碼一樣，Git 驗證權杖可以提供給 Git 操作以確認您的身分。正如您不會分享密碼一樣，您也絕不應分享您的驗證權杖。
* 您產生的驗證權杖可用於您透過 Git 整合存取的所有專案。
* 權杖在一年後會過期。
* **您最多可擁有 10 個權杖。** 如果您已達到 10 個權杖的上限，您應刪除舊的未使用或已過期的權杖，以便建立新的權杖。
* 我們建議使用 Git 認證協助程式來儲存您的驗證權杖，這樣您就不必每次使用 Git 整合時都輸入它。以下有更多關於如何設定的資訊。

#### 如何產生驗證權杖

* 您可以在您的 [帳戶設定](https://www.overleaf.com/user/settings)中檢視並產生 Git 驗證權杖。您最多可產生 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（您在專案中時瀏覽器網址列中的 URL）找到 Git 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) 包含以「git」使用者名稱為前綴的專案 ID 的完整 Git URL。

![git clone 指令與 URL 字串的視覺說明](/files/66badee629b8903a43efb5bd1f67b139db0ae479)

#### Overleaf Server Pro

如果您的 Overleaf 專案 URL 看起來像這樣：

```
 https://<SHARELATEX_SITE_URL>/project/1234567
```

注意：\<SHARELATEX\_SITE\_URL> 是您的 Overleaf Server Pro 管理員設定的主機值。

那麼用來複製專案的 Git URL 將會是：

```
https://<SHARELATEX_SITE_URL>/git/1234567
```

您的使用者名稱將會是 **git** 而密碼將會是您從 Overleaf 帳戶取得的權杖。

專案選單中的 Git 對話框提供的指令與 URL 由以下兩部分組成：(1) 在 Git 命令列中使用的 git clone 指令，以及 (2) 包含「git」使用者名稱、您的專屬 Overleaf 主機，以及包含專案 ID 的路徑的完整 Git URL。

![git clone 指令與 URL 字串的視覺說明](/files/963ece9cabc2e2e63b55bfb6c4f98f33df169faf)


---

# 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://overleaf-pro.ayaka.space/latex/zh-tw/zhi-shi-ku/042-git-integration-authentication-tokens.md?ask=<question>&goal=<endgoal>
```

`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.