> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 外部 URL

### 「From External URL」功能

若要啟用[「From External URL」](https://www.overleaf.com/learn/how-to/How_to_upload_a_file_using_an_external_URL)功能，變數 `ENABLED_LINKED_FILE_TYPES` 必須包含 `url` 類型：

```text theme={null}
ENABLED_LINKED_FILE_TYPES=project_file,project_output_file,url
```

這會擴充工具列中的 *Add Files* 選單與 *Insert Figure* 下拉選單：*Add Files* 選單可讓您使用 URL 將檔案新增至專案，而 *Insert Figure* 下拉選單則可讓您直接從 URL 將圖片插入文件中。

<Frame>
  <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=dec66ae04c3e2a379d6e356285e9dda4" alt="" width="2512" height="718" data-path="images/on-premises/image.png" />
</Frame>

#### 安全性注意事項

當使用者在專案中新增外部檔案的連結時，該檔案會由安裝 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 符合此正規表示式，即使其所在網路已遭封鎖，仍會允許存取。
    * 範例：若要允許像 `https://www.example.com/~john/pictures/frog.jpg` 與 `http://www.example.com/public/whatever/lit.bib` 這樣的 URL：

      `OVERLEAF_LINKED_URL_ALLOWED_RESOURCES=^https?://www\.example\.com/(?:~[^/]+|public)(?:/.*)?`
    * 範例：若要拒絕像 `http://www.example.com/private/whatever/file` 這樣的 URL，同時允許不在 `private` 子樹下的所有其他資源：

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

#### 對外代理

從重新發布的 `v6.3.0`（2026 年 10 月 3 日）開始，如果伺服器需要透過代理才能連上網際網路，您可以設定對外 HTTP(S) 代理。這也適用於 [Open in Overleaf API](/zh-TW/on-premises/configuration/overleaf-toolkit/overleaf-import-api "mention") 所擷取的外部 ZIP 與 TeX 資源。請設定以下變數：

* `OVERLEAF_LINKED_URL_OUTBOUND_PROXY`
  * 用於所有外部檔案請求的 HTTP(S) 代理 URL。若不設定則直接連線。
    * 範例：`OVERLEAF_LINKED_URL_OUTBOUND_PROXY=http://proxy.internal:3128`
  * 設定代理後，主機名稱會由代理解析，而非由 Overleaf 伺服器解析，因此 `OVERLEAF_LINKED_URL_BLOCKED_NETWORKS` 與上述受限範圍只適用於包含 IP 位址的 URL。<strong>代理必須封鎖對您內部網路的存取。</strong>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.