---
title: 代理程式的 Proxy 支援
slug: neurons/help/zh_tw/proxy
createdAt: 2026-09-07T08:18:42.114Z
---

Ivanti Neurons 平台現已提供對 Linux 和 Windows 代理程式的 Proxy 支援。

## Linux 代理程式的 Proxy

::::ExpandableHeading
## Linux 代理程式

### 新增代理程式

若要新增新的 Proxy 伺服器，請輸入
`stagentctl proxy --add http://host:port`

:::hint{type="info"}
僅支援沒有憑證的 HTTP Proxy。
:::

### 列出已設定的 Proxy

**若要顯示所有已設定的 Proxy 和排除**，請輸入
`stagentctl proxy --list`

### 刪除 Proxy

- **若要從設定中刪除特定 Proxy**，請輸入
  `stagentctl proxy --remove http://host:port`
- **若要刪除所有已設定的 Proxy**，請輸入
  `stagentctl proxy --remove all`
- 指令在執行後返回組態狀態
  如果結果為「無已設定的 Proxy」，則表示指令執行後沒有剩餘 Proxy。

### 管理 Proxy 排除

- **若要管理應直接存取的主機，請使用下列指令排除特定的主機名，例如「host.com」**，
  `stagentctl proxy --addexclusion host.com`
- **對於後綴相符排除，使用以下指令排除所有以「.org」結尾的主機。**
  例如，新增「.com」將排除所有以「.com」結尾的主機。
  `stagentctl proxy --addexclusion .org`
- 排除指令中的前導點，例如「.org」用作萬用字元，表示應排除任何以指定後綴結尾的主機。
- **若要完全停用所有主機的 Proxy，請使用下列指令**:
  `stagentctl proxy --addexclusion "*"`
- **若要刪除特定主機排除，請使用下列指令**:
  `stagentctl proxy --removeexclusion host.com`
- **若要清除所有排除，請使用下列指令**:
  `stagentctl proxy --removeexclusion all`

### 使用 Proxy 組態註冊

- 註冊代理程式時，新增 `--addproxy` 參數例如
  `stagentctl register --addproxy http://host:port`.
  該 Proxy 用於註冊並儲存以供將來的通訊使用。
- 此外，在註冊時，從 `http_proxy` 或 `HTTP_PROXY` 環境變數收集並儲存組態。
- 在嘗試註冊之前，也可以使用 `proxy --add` 和 `proxy --addexclusion` 指令新增 Proxy 和排除。

### 具有授權的 Proxy 伺服器

- 當您使用 `--addproxy` 新增或執行代理程式註冊時，您可以使用 `--proxyauth` 選項透過憑證授權 Proxy 伺服器。
- 支援 Digest、Negotiate 和 NTLM 方法進行授權。
- 例如，當您使用具有授權的 Proxy 時，請使用以下命令:
  `stagentctl proxy --add http://user:pass@host:port --proxyauth ntlm`
  `stagentctl register --addproxy http://user:pass@host:port --proxyauth ntlm`

:::hint{type="info"}
如果您有憑證來驗證 Proxy 伺服器，請確保提供 `--authtype` 參數。 如果新增具有已存在主機名稱的 Proxy，將使用提供的參數 (驗證類型、連接埠或憑證) 覆寫現有 Proxy。 `http_proxy` 和 `HTTP_PROXY` 環境變數以及所有與代理相關的環境變數都被忽略。
:::

### 重要說明

- 支援 Proxy 清單。 如果連線失敗，則嘗試清單中的下一個 Proxy，最終嘗試不使用 Proxy 進行連線。 在用盡所有選項或發生逾時後，應用程式將循環回到第一個 Proxy，並優先考慮初始條目。
- `register --addproxy` 指令將 Proxy 加至清單頂部，並優先考慮提供的 Proxy。

### 安全和通訊

該應用程式確保透過 Proxy 進行的所有通訊都使用 CONNECT 方法進行安全隧道傳輸，適用於 Proxy 僅充當隧道提供者的加密通訊。 所有 Proxy 組態都經過驗證，以確保使用無需憑證的 HTTP 方案，並且可能包含連接埠號碼。
::::

## Windows 代理程式的 Proxy

::::ExpandableHeading
## Windows 代理程式

Windows 代理程式的 Web Proxy 可以透過多種方式設定。 所有方法都具有相同的可用 Proxy 屬性，且入口點有所不同。 選取適當的方法。

- **方法 1**: 將 Proxy 設定作為代理程式安裝的一部分。
- **方法 2**: 為正在註冊或重新註冊的已安裝代理程式設定 Proxy 設定。
- **方法 3**: 為已安裝和註冊的代理程式設定 Proxy 設定。

:::hint{type="info"}
當使用其中任何一種方法時，代理程式的現有 Proxy 設定都會被覆寫。
例如，使用 proxyConfig 設定了有明確 Proxy 設定的代理程式，後續註冊將覆寫這些 Proxy 設定。
:::

**方法 1: 初始安裝和註冊期間**

當代理程式設定時若 Proxy 組態已知 (例如大規模部署新代理程式)，可使用此方法。 在進行大規模部署的情況下，可以在靜默指令中設定 Proxy 屬性，或在一次性安裝的註冊 GUI 或隨附的選項檔案中設定 Proxy 屬性。

- 在 Neurons 中啟動的靜默 (無人照管) 安裝需要將 Proxy 屬性新增至指令。

例如:` IvantiCloudAgent.exe --tenantid 11111… --activationkey BLtwU… --cloudhost https://xxx.ivanticloud.com --mode unattended --proxyMode Custom --proxyServerList ProxyServer.localdomain.com:8080 --proxyBypassList contoso.org;acme.com --proxyAuthType Basic --proxyUsername admin1 --proxyPassword password1`

- 在 Neurons 中啟動的互動式安裝需要在隨附的選項檔案中新增 Proxy 屬性。

例如:

```bash
tenantid=1111….
```

```bash
activationkey=BLtwU….
```

```bash
cloudhost=https://xxx.ivanticloud.com
```

```bash
proxyMode=Custom
```

```bash
proxyServerList=ProxyServer.localdomain.com:8080
```

```bash
proxyBypassList=contoso.org;acme.com
```

```bash
proxyAuthType=Basic
```

```bash
proxyUsername=admin1
```

```bash
proxyPassword=password1
```

- 除了互動式安裝之外，您還可以在**設定 Proxy** 下的註冊 GUI 中指定設定。

**方法二: 顯式註冊組態**

當需要 (重新) 註冊但不需要重新安裝時，請使用此方法。 也就是說，代理程式已經安裝，但註冊需要更改。 這種方法除了需要 Proxy 資訊之外還需要註冊資訊。

STAgentManagement 工具可與 C:\Program Files\Ivanti\Ivanti Cloud Agent 中安裝的代理程式一起使用。

直接執行 `./STAgentManagement.exe` 取得說明文件。

- 使用靜默標幟以僅使用指令列

```bash
STAgentManagement.exe -register -p silent=true -p proxyMode=Custom -p proxyServerList=ProxyServer.localdomain.com:8080 -p proxyAuthType=Basic proxyUsername=admin1
```

```bash
proxyPassword=password1 <and additional arguments for registration>
```

- 執行註冊指令以調出註冊和 Proxy 組態 GUI。

```bash
STAgentManagement.exe - 註冊
```

**方法 3: 顯式 Proxy 組態**

當需要 Web Proxy 代理更新而無需更改註冊或安裝時，請使用此方法。
例如，Proxy 憑證或 Proxy 伺服器已變更。

已安裝代理程式的 STAgentManagement 工具位於 C:\Program Files\Ivanti\Ivanti Cloud Agent。

直接執行` ./STAgentManagement.exe` 取得說明文件。

- 使用靜默標幟以僅使用指令列。

`STAgentManagement.exe -proxyConfig -p silent=true -p proxyMode=Custom -p proxyServerList=ProxyServer.localdomain.com:8080 -p proxyAuthType=Basic proxyUsername=admin1 proxyPassword=password1`

- 執行 proxyConfig 指令以調出「Proxy 組態」GUI。

`STAgentManagement.exe -proxyConfig`

**Windows 使用者端上的 Proxy 屬性**:

1. **Proxy 模式**
   **說明**: 設定 Proxy 模式。
   - 「無」表示不使用 Proxy。
   - 「自動」是指從目前作業系統設定中偵測到的 Proxy 模式。 這是預設模式。
   - 「自訂」是指使用其他 Proxy 屬性。
2. **伺服器清單**
   **說明**: Proxy 伺服器名稱及對應連接埠；可指定多個伺服器。
3. **繞過清單**
   **說明**: 允許 Proxy 繞過的位址。
4. **授權類型**
   **說明**: 設定 Proxy 的驗證類型。
   - 「基本」要求定義使用的使用者名稱和密碼。
   - 其他選項包括「摘要」、「NTLM」、「協商」和「無」 (表示不使用任何憑證)。
   - 「無」是預設值。
5. **使用者名稱和密碼**
   **說明**: 憑證被安全儲存，以便與「基本」驗證類型一起使用。
6. **Update WinHttp Proxy**
   **說明**: 這僅可透過指令列使用，而不可透過任何 GUI 使用。 只有要求代理程式不干擾 WinHTTP Proxy 設定的客戶才應設定此項。 有關更多詳細資訊，請參閱[選擇退出 WinHTTP Proxy 設定。](https://forums.ivanti.com/s/article/Opting-Out-of-WinHTTP-Proxy-Settings-Modification-During-Ivanti-Neurons-for-UEM-Agent-Registration)
::::
