> 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/getting-started/quickstart.md).

# 快速入門

只需一個 Docker 指令即可啟動你自己的 MyIP 實例。

啟動 MyIP 最快的方法是預先建置的 Docker 映像。你需要 Docker 和一個免費的 MaxMind GeoLite2 帳戶。

{% stepper %}
{% step %}

#### 取得 MaxMind 憑證

MyIP 使用免費的 **GeoLite2** 資料庫來進行 IP 地理定位與 ASN 查詢。請在 [maxmind.com/en/geolite2/signup](https://www.maxmind.com/en/geolite2/signup)註冊，然後從 **管理授權金鑰** 頁面產生授權金鑰。

完整操作說明： [MaxMind 設定](/developer/zh-tw/getting-started/maxmind-setup.md).
{% endstep %}

{% step %}

#### 執行容器

{% code title="docker run" %}

```bash
docker run -d \\
  -p 18966:18966 \\
  -e MAXMIND_ACCOUNT_ID="your-account-id" \\
  -e MAXMIND_LICENSE_KEY="your-license-key" \\
  -e MAXMIND_AUTO_UPDATE="true" \\
  --name myip \\
  --restart always \\
  jason5ng32/myip:latest
```

{% endcode %}
{% endstep %}

{% step %}

#### 開啟應用程式

前往 <http://localhost:18966>.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**第一次啟動時會下載 GeoLite2 資料庫。** 後端會在開始監聽前先嘗試下載，並在 5 分鐘後放棄，因此錯誤的憑證絕不會阻礙啟動。請搭配 `docker logs -f myip` — 你要找的是這一行 `📦 已載入 MaxMind 資料庫`.
{% endhint %}

{% hint style="warning" %}
**`localhost` 可直接開箱即用。真正的網域則不行。** 後端會拒絕所有 `/api/*` 請求，其 `Referer` 主機名稱不是 `localhost` 且未列於 `ALLOWED_DOMAINS`中。在將 MyIP 部署到網域之前，請先閱讀 [反向代理與網域](/developer/zh-tw/getting-started/reverse-proxy-and-domains.md).
{% endhint %}

## 後續步驟

* [使用 Docker 部署](/developer/zh-tw/getting-started/deploy-with-docker.md) — Compose、升級、埠對映、資料儲存位置
* [使用 Node.js 部署](/developer/zh-tw/getting-started/deploy-with-nodejs.md) — 從原始碼建置，透過 pm2 執行
* [選用 API 金鑰](/developer/zh-tw/configuration/optional-api-keys.md) — 額外的 IP 資料來源、地圖、MAC 查詢
* [環境變數](/developer/zh-tw/reference/environment-variables.md) — 完整清單


---

# 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/getting-started/quickstart.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.