> For the complete documentation index, see [llms.txt](https://docs.ipdunar.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ipdunar.com/zh/ji-cheng-zhi-nan/fan-jian-ce-liu-lan-qi/multilogin.md).

# Multilogin

Multilogin 在反检测浏览器中以指纹拟真度见长，对 ipdunar 所有产品支持完善。

## 单画像配置

1. **新建画像** → **代理** 区域。
2. **连接类型**：HTTP 或 SOCKS5。
3. 填写：

### 住宅 / 移动（网关型）

| 字段    | 值                                                                   |
| ----- | ------------------------------------------------------------------- |
| 主机    | `gate.ipdunar.com`                                                  |
| 端口    | `7777`                                                              |
| Login | `ipdunar_s1a2b3c4d5e-type-res-region-us-session-prof01-sesstime-30` |
| 密码    | 子账号密码                                                               |

### ISP

| 字段    | 值                     |
| ----- | --------------------- |
| 主机    | `198.51.100.42`       |
| 端口    | `8000`                |
| Login | `ipdunar_s1a2b3c4d5e` |
| 密码    | 子账号密码                 |

4. 点 **Check proxy** — Multilogin 探测并显示出口 IP、国家、时区。
5. Multilogin 会提示按代理国家**自动对齐指纹**，请接受。

\[screenshot: Multilogin 创建画像并配置 ipdunar 代理]

## 通过 API 批量

Multilogin 本地 API 支持程序化创建画像——非常适合批量为 N 个画像绑定 N 个 ISP IP：

```bash
curl -X POST http://127.0.0.1:35000/api/v1/profile \
  -H "Content-Type: application/json" \
  -d '{
    "name": "isp-us-042",
    "os_type": "windows",
    "proxy": {
      "type": "http",
      "host": "198.51.100.42",
      "port": 8000,
      "username": "ipdunar_s1a2b3c4d5e",
      "password": "PASSWORD"
    }
  }'
```

遍历你的 ISP 清单即可秒级配置画像。

## 指纹与代理匹配

Multilogin 的优势在于把浏览器指纹与代理 locale 对齐。开启 **按代理国家匹配指纹**：

* 语言请求头与国家一致
* 时区根据代理 IP 推导
* WebGL / Canvas 指纹按国家分布随机化

## 验证

访问 `https://browserleaks.com/ip` 与 `https://browserleaks.com/javascript`，确认 IP、时区、`navigator.language` 一致。

## 常见陷阱

* **`MultiloginProxyError: AUTHENTICATION_FAILED`** — 网关产品需要完整用户名（`ipdunar_...-type-res-region-us`），不能只填 `ipdunar_s1a2b3c4d5e`。
* **改完代理立即启动画像** — Multilogin 偶尔会用内存里的旧代理，请重启画像。


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.ipdunar.com/zh/ji-cheng-zhi-nan/fan-jian-ce-liu-lan-qi/multilogin.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
