本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 HTTP 代理
<a name="using-http-proxy"></a>

若要使用 AWS 透過代理伺服器存取 適用於 Kotlin 的 AWS SDK，您可以設定 JVM 系統屬性或環境變數。如果兩者都提供，則 JVM 系統屬性優先。

## 使用 JVM 系統屬性
<a name="http-proxy-jvm-properties"></a>

SDK 會尋找 JVM 系統屬性 `https.proxyHost`、 `https.proxyPort`和 `http.nonProxyHosts`。如需這些常見 JVM 系統屬性的詳細資訊，請參閱 [Java 文件中的聯網和代理](https://docs.oracle.com/javase/8/docs/technotes/guides/net/proxies.html)。

```
java -Dhttps.proxyHost=10.15.20.25 -Dhttps.proxyPort=1234 -Dhttp.nonProxyHosts=localhost|api.example.com MyApplication
```

## 使用環境變數
<a name="http-proxy-environment-variables"></a>

SDK 會尋找 `https_proxy`、 `http_proxy`和 `no_proxy`環境變數 （以及每個變數的大寫版本）。

```
export http_proxy=http://10.15.20.25:1234
export https_proxy=http://10.15.20.25:5678
export no_proxy=localhost,api.example.com
```

## 在 EC2 執行個體上使用代理
<a name="http-proxy-ec2"></a>

如果您在使用連接的 IAM 角色啟動的 EC2 執行個體上設定代理，請務必排除用於存取[執行個體中繼資料](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html)的地址。若要這樣做，請將 `http.nonProxyHosts` JVM 系統屬性或`no_proxy`環境變數設定為執行個體中繼資料服務的 IP 地址，也就是 `169.254.169.254`。此地址不會改變。

```
export no_proxy=169.254.169.254
```