Mavenをプロキシ(proxy)経由で使用する方法

toc目次

Mavenをプロキシ経由で使用

Mavenをプロキシ経由で使用する場合、環境変数の「HTTP_PROXY」、「HTTPS_PROXY」をセットしていてもプロキシ経由のアクセスとはなりません。

Mavenでプロキシ経由のアクセスを行う場合は、Mavenの設定ファイルでプロキシ設定を行う必要があります。

Maven設定ファイルの場所

設定 パス
全体設定 %M2_HOME%\conf\settings.xml
ユーザ個別設定 %USERPROFILE%\.m2\settings.xml

%M2_HOME%」は「mvn -v」を実行した際に表示される「Maven home」のパスです。

> mvn -v
Apache Maven 3.9.5 (57804ffe001d7215b5e7bcb531cf83df38f93546)
Maven home: C:\Program Files\Maven\apache-maven-3.9.5

全体設定とユーザ個別設定どちらも設定されている場合は、ユーザ個別設定が使用されます。

Mavenのプロキシ設定

Maven設定ファイルにプロキシ設定を追記します。

<proxies>
  <proxy>
    <id>myproxy</id>
    <active>true</active>
    <protocol>http</protocol>
    <host>proxy.example.com</host>
    <port>8080</port>
    <username>user</username>
    <password>password</password>
    <nonProxyHosts>localhost|127.0.0.1</nonProxyHosts>
  </proxy>
</proxies>
項目 備考
id プロキシの一意の識別子
active プロキシを有効にする場合trueを指定(一度に有効になるのは1つ)
protocol プロトコル(httphttps)を指定
host プロキシサーバーのホスト名またはIPアドレスを指定
port プロキシサーバーのポート番号を指定
username プロキシサーバーのログイン名(認証がない場合は不要)
password プロキシサーバーのパスワード(認証がない場合は不要)
nonProxyHosts プロキシを経由しないホストのリストを指定

参考