> For the complete documentation index, see [llms.txt](https://docs.ipcheck.ing/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ipcheck.ing/developer/zh-tw/configuration/features-tied-to-ipcheck-ing.md).

# 與 IPCheck.ing 綁定的功能

哪些 MyIP 功能依賴 IPCheck.ing 的私有服務、你的自架分支會顯示什麼替代內容，以及哪些功能仍可完全使用。

MyIP 的設計可完全自架：每個核心工具都能在你自己的部署上運作，無需任何特殊存取。不過，有少數功能是建立在一個 **封閉的配套服務** 為官方網站運作， [ipcheck.ing](https://ipcheck.ing)。本頁會準確列出它們是哪些，讓你在針對「缺少」工具提出問題之前，就能知道從分支版本會遇到什麼。

{% hint style="info" %}
**限制機制如何運作。** 後端會告訴前端它是否正在服務官方網站（`/api/configs` 會回傳一個 `originalSite` 根據請求主機名稱產生的旗標）。標示為僅限官方網站的工具，在其他地方根本不會渲染——它們看起來不是壞掉，而是完全不會出現。
{% endhint %}

## 分支版本上有何不同

| 功能                      | 顯示位置                             | 在你的分支版本上                                                                                                                                                                                                                                                                                           |
| ----------------------- | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **隱形性測試**               | 進階工具抽屜                           | 隱藏。此工具會呼叫一個私有的代理偵測後端。                                                                                                                                                                                                                                                                              |
| **深入 DNS 外洩測試**         | 進階工具抽屜                           | 隱藏。標準的 [DNS 外洩測試](https://docs.ipcheck.ing/knowledge-base/connection-tools/dns-leak-test) 在主頁上的版本可在任何地方運作。                                                                                                                                                                                         |
| **深入 Persona 檢查**       | 進階工具抽屜（只有抽屜本身——它沒有 `/tools/` 頁面） | 隱藏。評分是在配套 API 中進行；這個倉庫只負責收集觀察結果並呈現判定。                                                                                                                                                                                                                                                              |
| **IPCheck.ing IP 資料來源** | IP 卡片 + IP 詳細資訊面板                | 略過——卡片鏈會回退到其他來源，而此來源在詳細資訊面板中的額外內容（IP 類型、代理偵測、品質分數）不會顯示。                                                                                                                                                                                                                                            |
| **帳號（登入）**              | 導覽列                              | 除非你設定自己的 Firebase 專案，否則不會出現（`VITE_FIREBASE_*` 變數）。MyIP 的任何核心工具都不需要登入。                                                                                                                                                                                                                              |
| **成就**                  | 成就彈出通知 + 個人檔案                    | 實際上僅限官方網站：解鎖內容是透過私有使用者 API 儲存的，即使你接上自己的登入系統也一樣。                                                                                                                                                                                                                                                    |
| **文件助理**                | 導覽搜尋框（桌面）／問號圖示（行動版）              | 隱藏。它會從 IPCheck.ing 自己的文件網站回覆——而且可以透過應用程式命令匯流排執行訪客的四項核心測試——因此這個入口不僅受官方部署限制，也受 [`VITE_DOCS_URL`](/developer/zh-tw/reference/environment-variables.md#vite-docs-url) 在建置時被設定。                                                                                                                         |
| **Earth Online**        | 導覽列中的地球圖示                        | 部分可用——這是此處唯一不是全有或全無的一列。社群半部依賴一個獨立的封閉彙整服務，其限制取決於 [`VITE_PULSE_BEACON_URL`](/developer/zh-tw/reference/environment-variables.md#vite-pulse-beacon-url) 在建置時；全球故障資訊流則由這個倉庫自己的後端提供，並可在任何具備 [`CLOUDFLARE_API_KEY`](/developer/zh-tw/reference/environment-variables.md#cloudflare-api-key) 的部署上運作——見下文。 |

私有服務背後的環境變數（`IPCHECKING_API_KEY`, `IPCHECKING_API_ENDPOINT`, `VITE_INVISIBILITY_TEST_KEY`）記載於 [環境變數](/developer/zh-tw/reference/environment-variables.md) 參考文件中，以求完整，但認證資訊並不會隨附提供——把它們設成任意值不會有任何實際作用。

## Earth Online 的限制方式不同

表格中的其他每一列都會被 `originalSite` 旗標隱藏。 **Earth Online** 不是：它有兩個彼此獨立受限制的半部，而分支版本可以執行其中一個。

**故障資訊流可完全自架。** 此面板的全球故障公告由這個倉庫自己的後端提供—— `GET /api/cfradar?view=outages`，由 Cloudflare Radar 支援。設定 [`CLOUDFLARE_API_KEY`](/developer/zh-tw/reference/environment-variables.md#cloudflare-api-key) 而後端會回報 `cloudFlare: true` 位於 `/api/configs`；光是這樣就會讓導覽項目顯示，並註冊 <kbd>p</kbd> 快捷鍵，因此你的部署會得到一個僅顯示故障資訊的 Earth Online 面板，不涉及任何私有服務。

**社群半部需要一個脈動信標後端。** 狀態編輯器、最新動態資訊流、訪客地圖，以及每次頁面載入僅發送一次的訪問信標，都受建置時變數 [`VITE_PULSE_BEACON_URL`](/developer/zh-tw/reference/environment-variables.md#vite-pulse-beacon-url)的限制；此變數保存彙整服務的完整 URL。保持空白——就像 `.env.example` 所做的一樣——那麼這些區塊就永遠不會渲染，也不會向任何外部服務送出任何請求。

前端部分完全在這個倉庫中（`frontend/components/widgets/Pulse.vue` 面板部分在 `frontend/utils/pulse-beacon.js` 頁面載入時由 `App.vue`觸發的一次性訪問信標。這個倉庫中 **沒有** 的是接收社群流量的服務：它會計算訪問次數、按國家彙整、保留近期狀態資訊流，並在發佈前遮蔽每個位址。該服務是封閉的，因此將 `VITE_PULSE_BEACON_URL` 指向你自己的某個系統，意思是你得自行實作一個相容的後端——前端會呼叫 `POST <url>/beacon`, `POST <url>/status` 以及 `GET <url>/stats`.

{% hint style="info" %}
這個信標被刻意設計成無法影響任何其他東西：它是 fire-and-forget，不會被等待，會在閒置時排程，而且所有拒絕都會被吞掉。失效或設定錯誤的 pulse URL 不會拖慢任何東西，也不會破壞其他工具。
{% endhint %}

面向訪客的行為，包括儲存哪些內容以及保存多久，都記錄在知識庫中： [Earth Online](https://docs.ipcheck.ing/knowledge-base/getting-started/earth-online).

## 為什麼這些是封閉的

配套 API 目前還不夠成熟，還不能開源——它的程式碼和介面變動太快，尚不足以支援外部部署。Earth Online 社群半部背後的彙整服務是另一個、規模小得多的程式庫，但狀態相同。任一者在穩定後都可能開放；目前沒有時間表。與此同時，本頁唯一可自架的路徑是 Earth Online 的故障資訊流，它不需要任何超出 `CLOUDFLARE_API_KEY`.

## 其他一切都可運作

更明確地說：這個六區塊儀表板（IP 卡片、連線狀態、WebRTC、DNS 外洩、速度測試）以及所有其他進階工具——全球延遲、MTR、規則測試、DNS 解析器、審查檢查、Whois、MAC 查詢、ASN 面板、瀏覽器指紋、安全檢查清單——完全在公開基礎設施與開放程式碼上運作，僅受 [選用的 API 金鑰](/developer/zh-tw/configuration/optional-api-keys.md) 是否由你自行設定。

{% hint style="success" %}
要部署你自己的執行個體嗎？請從 [快速開始](/developer/zh-tw/getting-started/quickstart.md) ——唯一的硬性需求是一個免費的 [MaxMind 帳號](/developer/zh-tw/getting-started/maxmind-setup.md).
{% 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://docs.ipcheck.ing/developer/zh-tw/configuration/features-tied-to-ipcheck-ing.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.