Zenn
📑

プロキシ環境下でサーバを構築するための設定メモ

2024/06/11に公開
Docker
GitHub
Linux
proxy
tech

企業内などプロキシサーバを経由してインターネットに接続する必要がある環境下でサーバを構築する際にハマったので、その解決策をメモしておく。

サーバはUbuntuを想定。

プロキシ設定

~/.profileや~/.bash_profileなどで、環境変数http_proxy, https_proxyにサーバURLを設定する。
プロキシを経由してほしくないホストはno_proxyにカンマ区切りで指定する。

~/.profile
export http_proxy=http://proxy.example.com:8080
export https_proxy=http://proxy.example.com:8080
export no_proxy=localhost,127.0.0.1,::1

接続確認

example.comにリクエストを送信し、応答が返ることを確認する。

  • HTTP

    $ curl -I http://example.com
HTTP/1.1 200 OK
Accept-Ranges: bytes
Age: 436224
Content-Type: text/html; charset=UTF-8
...(省略)...

  • HTTPS

    $ curl -I https://example.com
HTTP/1.1 200 Connection established

HTTP/2 200
accept-ranges: bytes
age: 210559
cache-control: max-age=604800
content-type: text/html; charset=UTF-8
...(省略)...

sudo

sudoコマンドには環境変数が引き継がれずプロキシ設定が効かないため、http_proxy, https_proxy, no_proxyが引き継がれるように設定を行う。

以下のコマンドで/etc/sudoersを編集し、

sudo visudo

末尾に下記の設定を追加する。

/etc/sudoers
Defaults env_keep += "http_proxy https_proxy no_proxy"

Ubuntuの場合、デフォルトで以下のように設定がコメントアウトされているので、コメントアウトを解除しても良い。

/etc/sudoers
# This preserves proxy settings from user environments of root
# equivalent users (group sudo)
#Defaults:%sudo env_keep += "http_proxy https_proxy ftp_proxy all_proxy no_proxy"

apt

/etc/apt/apt.conf.d/に適当な名前のファイル（ここでは01proxy）を作成し、プロキシ設定を記述する。

/etc/apt/apt.conf.d/01proxy
Acquire::http::Proxy "http://proxy.example.com:8080";
Acquire::https::Proxy "http://proxy.example.com:8080";

GitHubへのSSH接続をプロキシ経由で行う

プロキシを設定したらGitHubからのHTTPSでのアクセスは行えるようになるが、publicでないリポジトリにHTTPSでアクセスするためにはPersonal Access Tokenを使用する必要があり面倒。そのため、SSHで接続できるようにする。
プロキシを使うためのコマンドはいくつかあり、それぞれで設定方法が異なる。

ncを使用する場合

  1. コマンドがあることを確認する。

    $ nc
usage: nc [-46CDdFhklNnrStUuvZz] [-I length] [-i interval] [-M ttl]
          [-m minttl] [-O length] [-P proxy_username] [-p source_port]
          [-q seconds] [-s sourceaddr] [-T keyword] [-V rtable] [-W recvlimit]
          [-w timeout] [-X proxy_protocol] [-x proxy_address[:port]]
          [destination] [port]

  2. ~/.ssh/configに以下の設定を追加する。

    ~/.ssh/config
    Host github.com
  User git
  Hostname ssh.github.com
  Port 443
  ProxyCommand nc -X connect -x proxy.example.com:8080 %h %p

ncatを使用する場合

  1. コマンドがあることを確認する。

    $ ncat --help
Ncat 7.94SVN ( https://nmap.org/ncat )
Usage: ncat [options] [hostname] [port]

  2. ~/.ssh/configに以下の設定を追加する。

    ~/.ssh/config
    Host github.com
  User git
  Hostname ssh.github.com
  Port 443
  ProxyCommand ncat --proxy proxy.example.com:8080 --proxy-type http %h %p

corkscrewを使用する場合

  1. コマンドがあることを確認する。

    $ corkscrew
corkscrew 2.0

usage: corkscrew <proxyhost> <proxyport> <desthost> <destport> [authfile]

  2. ~/.ssh/configに以下の設定を追加する。

    ~/.ssh/config
    Host github.com
  User git
  Hostname ssh.github.com
  Port 443
  ProxyCommand corkscrew proxy.example.com 8080 %h %p

接続確認

$ ssh -T git@github.com
Hi xxxx! You've successfully authenticated, but GitHub does not provide shell access.

docker

dockerイメージのpull時、イメージのビルド時、コンテナの実行時でそれぞれプロキシ設定が必要。

イメージのpull時

Docker daemonにプロキシ設定を記述する必要がある。

まずは/etc/systemd/system/docker.service.d/http-proxy.confを作成する。

sudo mkdir -p /etc/systemd/system/docker.service.d
sudo vim /etc/systemd/system/docker.service.d/http-proxy.conf

http-proxy.confにプロキシ設定を記述する。

/etc/systemd/system/docker.service.d/http-proxy.conf
[Service]
Environment="http_proxy=http://proxy.example.com:8080"
Environment="https_proxy=http://proxy.example.com:8080"
Environment="no_proxy=localhost,127.0.0.1,::1"

設定ファイルを作成したら、以下のコマンドで設定を反映させる。

sudo systemctl daemon-reload
sudo systemctl restart docker

参考 : Configure the daemon with systemd | Docker Docs

イメージのビルド時

Dockerfileに基づいてイメージをビルドする際は、--build-argオプションを使用してプロキシ設定を渡す。

docker build \
  --build-arg http_proxy=http://proxy.example.com:8080 \
  --build-arg https_proxy=http://proxy.example.com:8080 \
  --build-arg no_proxy=localhost,127.0.0.1,::1 \
  -t my-image .

Configure Docker to use a proxy server | Docker Docs にもあるように、Doockerfile内でENVを使用するとイメージにプロキシ設定が含まれてしまうため、--build-argオプションを使用した方が良い。

コンテナの実行時

docker runコマンドを実行する際に-eオプションを使用してプロキシ設定を渡す。

docker run -e http_proxy=http://proxy.example.com:8080 -e https_proxy=http://proxy.example.com:8080 -e no_proxy=localhost,127.0.0.1,::1 my-image

~/.docker/config.jsonにプロキシ設定を記述する方法もあるが、Docker のプロキシ設定は割と地獄の記事にもあるようにすべてのコンテナ実行に共有されてしまうこと、sudoのときは設定ファイルが違うことを考えると、実行時にオプションとして渡したほうがスッキリしそう。

GitHubで編集を提案

Discussion