> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Gateway トラブルシューティング

> Connect Gateway 実行時によくある問題と、その診断および解決手順。

## よくある問題

<AccordionGroup>
  <Accordion title="Gateway で 'tunneling configuration' のタイムアウトが発生する、または繰り返し再起動する。">
    **症状:** Gateway コンテナのログに `ConnectTimeoutException: connection timed out...cloud.cdata.com:443` が表示され、コンテナがループで再起動します。Gateway は Connect AI で **Success** ステータスに到達しません。

    **手順 1: ホストからの送信を確認する（Docker とは独立）**

    ホストで次のコマンドを実行します：

    ```bash theme={null}
    curl -v https://cloud.cdata.com/api
    ```

    TLS ハンドシェイクが完了し、何らかの HTTP レスポンス（例えば 404）が返れば、ホストからの送信は正常であり、問題はコンテナレベルにあります。企業ファイアウォールが原因ではありません。

    **手順 2: IP フォワーディングを確認する**

    ホストは `cloud.cdata.com` に到達できるがコンテナは到達できない場合、ホストで IP フォワーディングを確認します：

    ```bash theme={null}
    sysctl net.ipv4.ip_forward
    ```

    これが `0` を返す場合、ホストはコンテナのアウトバウンドトラフィックをインターネットにルーティングできません。Docker では IP フォワーディングが有効になっている必要があります。有効化するには：

    ```bash theme={null}
    sudo sysctl -w net.ipv4.ip_forward=1
    ```

    次のリトライで Gateway が再接続します。再ビルドやイメージの再プルは不要で、ローカルイメージと構成には影響しません。
  </Accordion>

  <Accordion title="再起動、パッチ適用、およびセキュリティ強化（ハードニング）の過程で、Gateway の接続を維持できない問題が発生する。">
    `net.ipv4.ip_forward` は、OS の再起動、パッチサイクル、セキュリティハードニングのベースラインによって `0` にリセットされることがよくあります。環境が必要とする永続性のレベルを適用してください。

    **再起動後も維持する:** 永続的な sysctl 設定を追加します：

    ```bash wrap theme={null}
    echo 'net.ipv4.ip_forward = 1' | sudo tee /etc/sysctl.d/99-ip-forward.conf
    sudo sysctl --system
    ```

    **パッチ適用およびセキュリティハードニング（CIS / DISA STIG 環境）にも耐える:** 多くのハードニング済みイメージ（例：企業の RHEL ビルド）は、標準のセキュリティコントロールとして IP フォワーディングを無効化し、パッチ適用または構成管理の実行のたびにそのコントロールを再適用します。このような環境では、上記の sysctl ファイルが上書きされる可能性があります。再発を防ぐには、ハードニングベースラインを管理するチームがホストレベルの例外を追加する必要があります：

    * Docker がコンテナ接続に IP フォワーディングを必要とすることを理由に、Connect Gateway を実行するホストでは `net.ipv4.ip_forward=1` を許可する。あるいは、
    * グローバルにフォワーディングを無効のままにする必要がある場合は、Docker ブリッジサブネットから `cloud.cdata.com` のポート 443 へのアウトバウンドのみを許可するスコープ付きフォワード/マスカレードルールを適用する。

    どちらも狭く意図的な例外であり、ホスト全体のハードニング状態を低下させるものではありません。

    **何が値をリセットしているかを特定するには:**

    ```bash wrap theme={null}
    grep -rns 'ip_forward' /etc/sysctl.conf /etc/sysctl.d/ /usr/lib/sysctl.d/
    ```

    `99-ip-forward.conf` より後のロード順序で `net.ipv4.ip_forward = 0` を設定しているハードニングファイルが、例外で上書きすべき対象です。
  </Accordion>
</AccordionGroup>

追加のサポートが必要な場合は、[CData サポート](https://jp.cdata.com/support/) にお問い合わせください。