> 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/on-premises/ko/configuration/overleaf-toolkit/github.md).

# GitHub 동기화

{% hint style="info" %}
이 기능은 [ayaka-notes/overleaf-pro](https://github.com/ayaka-notes/overleaf-pro), 다음에 의해 수정됨 [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep). 이 기능은 v6.2.0 이상에서 도입되었습니다. 아직 베타 상태입니다. 문제가 있으면 피드백을 보내 주세요.
{% endhint %}

{% columns %}
{% column %}

<figure><img src="/files/af090309846d122a84e68ae4f4538f40099201cd" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/e24d7e03e59ec8fcb0e2224fddda8373906276de" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/a43c04666aa93d5fadb76cb5e22e5faf70f31cd1" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/29b89fba40762a4a40ac557f27fd6401f4eb2588" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### GitHub 동기화 설정

{% hint style="warning" %}
먼저 [git-bridge](/on-premises/ko/configuration/overleaf-toolkit/git-integration.md) GitHub 동기화를 사용하기 전에 활성화해야 합니다.

{% code title="config/overleaf.rc" %}

```dotenv
GIT_BRIDGE_ENABLED=true
```

{% endcode %}
{% endhint %}

방문 [개발자 설정](https://github.com/settings/developers) 에서 GitHub OAuth 애플리케이션을 만들고, `CLIENT_ID` 그리고 `SECRET`.&#x20;

**참고**: OAuth 콜백 URL은 다음과 같습니다: `${OVERLEAF_SITE_URL}/user/github-sync/oauth2/callback`.

그다음, 다음 설정을 overleaf 환경 변수 파일에 추가하세요.

{% code title="config/variables.env" overflow="wrap" %}

```dotenv
# 사용자의 GitHub 액세스 토큰을 암호화하는 데 사용됩니다.
# 생성 방법: `openssl rand -hex 32`
GITHUB_TOKEN_CIPHER_PASSWORD=0123456789ABCDEFG # 본인 것으로 변경

# Github 동기화 설정
GITHUB_SYNC_ENABLED=true
GITHUB_SYNC_CLIENT_ID=
GITHUB_SYNC_CLIENT_SECRET=

# OAuth 콜백은 다음과 같습니다: ${OVERLEAF_SITE_URL}/user/github-sync/oauth2/callback
# (선택 사항) GITHUB_SYNC_PROXY_URL=http://10.0.0.1:10808
```

{% endcode %}

{% hint style="warning" %}
GitHub OAuth 콜백 URL을 구성하기 전에 `OVERLEAF_SITE_URL` 가 올바르게 설정되었는지 확인하세요.
{% endhint %}

중국 본토에 계신 경우 GitHub에 접속하려면 프록시를 구성해야 할 수 있습니다. 다음 환경 변수를 설정하세요: `GITHUB_SYNC_PROXY_URL=http://10.0.0.1:10808`.

{% hint style="warning" %}
사용하지 마세요 `127.0.0.1` 를 프록시 호스트로. 프록시가 호스트 서버에서 실행 중이라면 서버의 LAN IP(예: `192.168.1.xx`) 주소를 사용하고, 프록시가 로컬 네트워크의 장치에서 오는 연결을 허용하도록 구성되어 있는지 확인하세요.
{% endhint %}


---

# 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/on-premises/ko/configuration/overleaf-toolkit/github.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.