# 連線你的代理

使用 HTTP CONNECT 或 SOCKS5 接入代理。

## 獲取連線資訊

在工作空間開啟已就緒的靜態資源或動態連線，複製對應協議的主機、連接埠、使用者名稱和密碼。

透過 API 可讀取 `GET /proxies/{id}` 或 `GET /dynamic/profiles/{id}`。金鑰需要 `credentials:read` 及對應代理權限。列表回應不包含密碼。

## HTTP 與 HTTPS 目標

把四個 `PROXY_` 環境變數設為實際連線資訊。HTTP 代理透過 CONNECT 支援 HTTPS 請求：

```sh
curl --proxy "http://$PROXY_HOST:$PROXY_PORT" \
  --proxy-user "$PROXY_USERNAME:$PROXY_PASSWORD" \
  --max-time 20 https://example.com/
```

代理地址使用 `http://`，目標網站仍可使用 `https://`。

## SOCKS5

使用 `socks5h` 讓代理解析目標域名：

```sh
curl --proxy "socks5h://$PROXY_HOST:$PROXY_PORT" \
  --proxy-user "$PROXY_USERNAME:$PROXY_PASSWORD" \
  --max-time 20 https://example.com/
```

請選擇該連線支援的協議。切換示例格式不會建立新的流量餘額。

## 連線失敗時

檢查資源是否就緒、主機和連接埠是否對應所選協議，以及憑證是否有效。靜態資源必須處於有效期內。動態連線需要標準流量，最佳化動態連線還需要最佳化流量。

請勿在截圖或記錄中暴露密碼。聯絡支援時，提供資源或連線編號和請求時間。