> 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/external-url.md).

# 외부 URL

### "외부 URL에서 가져오기" 기능

활성화하려면 ["외부 URL에서 가져오기"](https://www.overleaf.com/learn/how-to/How_to_upload_a_file_using_an_external_URL) 기능의 변수 `ENABLED_LINKED_FILE_TYPES` 를 포함해야 합니다 `URL` 유형:

```
ENABLED_LINKED_FILE_TYPES=project_file,project_output_file,url
```

이렇게 하면 다음 두 항목 모두가 확장됩니다: *파일 추가* 메뉴와 *그림 삽입* 툴바의 드롭다운:  *파일 추가* 메뉴를 사용하면 URL을 사용해 프로젝트에 파일을 추가할 수 있으며,  *그림 삽입* 드롭다운을 사용하면 URL에서 바로 문서에 이미지를 삽입할 수 있습니다.

#### 보안 참고

사용자가 프로젝트에 외부 파일로 연결되는 링크를 추가하면, 해당 파일은 Overleaf가 설치된 서버를 대신하여 가져와집니다.

Overleaf 서버가 내부 HTTP 서버도 함께 포함된 비공개 네트워크 안에서 호스팅되는 경우(내부 용도로만 사용되는 서버), Overleaf에 접근할 수 있는 사용자가 이러한 내부 서비스의 데이터에 접근할 수 있을 가능성이 있습니다.

이를 방지하기 위해 외부 파일 링크는 IP 주소가 제한된 네트워크 범위에 속하는 서버를 가리키면 안 됩니다. 해당 범위는 다음과 같습니다:

* `127.0.0.0/8` (루프백)
* `169.254.0.0/16` (링크 로컬)
* `10.0.0.0/8` (사설 네트워크)
* `172.16.0.0/12` (사설 네트워크)
* `192.168.0.0/16` (사설 네트워크)

또한 다음 환경 변수가 추가됩니다:

* `OVERLEAF_LINKED_URL_BLOCKED_NETWORKS`
  * 외부 리소스를 가져오는 것이 금지된 CIDR 표기의 네트워크 목록을 공백으로 구분해 나열한 것입니다. 일반적으로 조직의 내부 네트워크를 포함해야 합니다.
    * 예: `OVERLEAF_LINKED_URL_BLOCKED_NETWORKS=123.123.0.0/16 124.124.124.0/24`

그러나 많은 조직에서는 내부 네트워크의 서버가 공개적으로 접근 가능해야 하는 데이터도 호스팅할 수 있습니다. 전체 네트워크가 차단되어 있더라도 특정 리소스에 대한 접근을 허용하려면 다음 환경 변수를 사용할 수 있습니다:

* `OVERLEAF_LINKED_URL_ALLOWED_RESOURCES`
  * 외부 파일을 가져올 수 있도록 허용되는 웹 리소스를 정의하는 정규 표현식입니다. URL이 이 정규 표현식과 일치하면, 네트워크가 다른 이유로 차단되어 있어도 해당 URL에 대한 접근이 허용됩니다.
    * 예: 다음과 같은 URL을 허용하려면 `https://www.example.com/~john/pictures/frog.jpg` 그리고 `http://www.example.com/public/whatever/lit.bib`:

      `OVERLEAF_LINKED_URL_ALLOWED_RESOURCES=^https?://www\.example\.com/(?:~[^/]+|public)(?:/.*)?`
    * 예: 다음과 같은 URL을 거부하려면 `http://www.example.com/private/whatever/file`, 해당 항목이 없는 다른 모든 리소스는 허용하면서 `private` 하위 트리:

      `OVERLEAF_LINKED_URL_ALLOWED_RESOURCES=^https?://www\.example\.com/(?!private)(?:.*)`<br>


---

# 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/external-url.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.
