はじめに

自宅サーバーでNginx Proxy Manager（NPM）を使用していたところ、host.docker.internalを使った内部サービスへのプロキシ設定で502 Bad Gatewayエラーが発生。原因調査と解決策として、TraefikへのProxyツール移行を実施した記録です。

問題の概要

環境

Ubuntu Server 22.04
Docker Compose
内部ネットワーク（192.168.2.0/24）
対象アプリ：ポート17681で動作

発生した問題

# Nginx Proxy Managerの設定
extra_hosts:
  - "host.docker.internal:192.168.2.40"

上記設定にも関わらず、ブラウザアクセス時に502エラーが発生。

原因調査結果

# コンテナ内からの接続テスト
$ docker-compose exec app curl -s -o /dev/null -w "%{http_code}" http://host.docker.internal:17681
200  # ← 接続成功

# エラーログ確認
$ docker-compose exec app cat /data/logs/proxy-host-1_error.log
host.docker.internal could not be resolved (3: Host not found)

根本原因：Nginxワーカープロセスがhost.docker.internalの名前解決に失敗

解決策：Traefikへの移行

なぜTraefikを選んだか

項目	Nginx Proxy Manager	Traefik
内部エンジン	Nginx	Go言語独自実装
名前解決	Nginxの制約あり	Docker統合優秀
設定方法	Web UI	ファイル/ラベル
学習コスト	低	中

Traefik導入手順

1. ディレクトリ構成

sudo mkdir -p /opt/traefik/dynamic
cd /opt/traefik

2. Docker Compose設定

# docker-compose.yml
services:
  traefik:
    image: traefik:v3.0
    container_name: traefik
    restart: unless-stopped
    ports:
      - "80:80"
      - "8080:8080"  # Web UI
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - ./traefik.yml:/etc/traefik/traefik.yml:ro
      - ./dynamic:/etc/traefik/dynamic:ro
    extra_hosts:
      - "host.docker.internal:192.168.2.40"

3. Traefik基本設定

# traefik.yml
api:
  dashboard: true
  insecure: true

entryPoints:
  web:
    address: ":80"

providers:
  docker:
    endpoint: "unix:///var/run/docker.sock"
    exposedByDefault: false
  file:
    directory: /etc/traefik/dynamic
    watch: true

log:
  level: INFO

4. プロキシ設定（動的ファイル）

# dynamic/services.yml
http:
  routers:
    web-terminal:
      rule: "Host(`web-terminal.gpuserver.lan`)"
      service: web-terminal-service
      entryPoints:
        - web

  services:
    web-terminal-service:
      loadBalancer:
        servers:
          - url: "http://host.docker.internal:17681"

5. systemd自動起動設定

# /etc/systemd/system/traefik.service
[Unit]
Description=Traefik Proxy
After=docker.service
Requires=docker.service

[Service]
Type=oneshot
RemainAfterExit=yes
WorkingDirectory=/opt/traefik
ExecStart=/usr/bin/docker compose up -d
ExecStop=/usr/bin/docker compose down

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable traefik.service
sudo systemctl start traefik.service

動作確認

Web UI確認

http://192.168.2.40:8080/dashboard/

HTTP Routersにweb-terminal@fileが表示されることを確認。

プロキシ動作確認

http://web-terminal.gpuserver.lan

正常にアプリケーションにアクセスできることを確認。

トラブルシューティング

よくある問題と対処法

1. ポート競合エラー

# NPMが動いている場合は停止
cd /opt/nginx-proxy-manager
sudo docker-compose down

2. YAMLシンタックスエラー

# 設定ファイルの確認
sudo docker logs traefik --tail 10

# よくある間違い：URLの末尾にコロン
- url: "http://host.docker.internal:17681":  # ← NG
- url: "http://host.docker.internal:17681"   # ← OK

3. 設定が反映されない

# ファイル存在確認
sudo docker exec traefik ls -la /etc/traefik/dynamic/

# 権限確認
sudo chmod 644 traefik.yml dynamic/services.yml

追加サービスの設定例

新しいサービスを追加する場合：

# dynamic/services.yml に追加
http:
  routers:
    web-terminal:
      rule: "Host(`web-terminal.gpuserver.lan`)"
      service: web-terminal-service
      entryPoints:
        - web
    
    # 新しいサービス
    portainer:
      rule: "Host(`portainer.gpuserver.lan`)"
      service: portainer-service
      entryPoints:
        - web

  services:
    web-terminal-service:
      loadBalancer:
        servers:
          - url: "http://host.docker.internal:17681"
    
    # 新しいサービス
    portainer-service:
      loadBalancer:
        servers:
          - url: "http://host.docker.internal:9000"

ファイル保存後、自動的に設定が反映されます（watch: trueのため）。

まとめ

移行のメリット

✅ host.docker.internalの名前解決問題が解決
✅ 設定ファイルによるバージョン管理が可能
✅ ホットリロード対応（設定変更時に再起動不要）
✅ Docker統合が優秀

移行のデメリット

❌ Web UIでの設定変更不可（読み取り専用）
❌ 学習コストが若干高い
❌ GUIでの直感的操作ができない

適用場面

Infrastructure as Codeを重視する環境
設定の変更頻度が低い環境
Docker環境での内部プロキシ

Web UIでの設定管理を重視する場合は、ZoraxyやCaddyなど他の選択肢も検討することをお勧めします。

参考リンク