トラブルシューティング

プロキシ設定の構成

ネットワーク制限のあるエンタープライズ環境でBob Shellのプロキシ設定を構成する

エラーメッセージ

Bob Shellを使用しようとしたときの接続エラーまたはタイムアウト、例えば:

  • "Bobサービスに接続できません"
  • "ネットワークリクエストが失敗しました"
  • "接続タイムアウト"
  • "SSL証明書の検証に失敗しました"
  • "ECONNREFUSED"または"ETIMEDOUT"エラー

一般的な原因

組織では、直接接続を許可するのではなく、すべてのHTTP/HTTPSトラフィックをプロキシサーバー経由で流すことを要求しています。これは、厳格なネットワークセキュリティポリシーを持つエンタープライズ環境では一般的です。

解決策

環境変数を使用してBob Shellのプロキシ設定を構成し、組織のプロキシサーバー経由でトラフィックをルーティングします。

プロキシ環境変数の設定

テキストエディターでシェル構成ファイルを開きます:

  • Bashの場合:~/.bashrcまたは~/.bash_profile
  • Zshの場合:~/.zshrc
  • Fishの場合:~/.config/fish/config.fish

シェル構成ファイルに次の環境変数を追加します:

export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=https://proxy.example.com:8080
export NO_PROXY=localhost,127.0.0.1

proxy.example.com:8080を組織の実際のプロキシサーバーアドレスとポートに置き換えます。

注:

NO_PROXY変数は、プロキシをバイパスする必要があるアドレスを指定します。プロキシアクセスを必要としない内部ドメインまたはIPアドレスを追加します。

構成ファイルを保存して再読み込みします:

# Bashの場合
source ~/.bashrc

# Zshの場合
source ~/.zshrc

# Fishの場合
source ~/.config/fish/config.fish

環境変数が設定されていることを確認します:

echo $HTTP_PROXY
echo $HTTPS_PROXY

新しいセッションを開始してBob Shellの接続性をテストします。

SSL証明書検証の構成

プロキシが自己署名証明書またはカスタム認証局を使用している場合、SSL証明書検証を構成する必要がある場合があります。

シェル構成ファイルにSSL構成を追加します:

# 厳格なSSL検証を無効にする(本番環境では推奨されません)
export NODE_TLS_REJECT_UNAUTHORIZED=0

# またはカスタムCA証明書を提供する(推奨)
export NODE_EXTRA_CA_CERTS=/path/to/your/ca-bundle.crt
警告:

SSL検証を無効にする(NODE_TLS_REJECT_UNAUTHORIZED=0)とセキュリティが低下し、一時的にのみ使用する必要があります。NODE_EXTRA_CA_CERTSを使用して組織の証明書バンドルを提供してください。

ITチームから組織の証明書バンドルを取得し、安全な場所に保存します。

NODE_EXTRA_CA_CERTSパスを更新して、証明書バンドルファイルを指すようにします。

シェル構成を再読み込みし、Bob Shellの接続性をテストします。

一時的なプロキシ構成

シェル構成ファイルを変更せずに一時的なプロキシ構成を行うには、現在のターミナルセッションで環境変数を設定します:

export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=https://proxy.example.com:8080
bobshell

これらの設定は現在のターミナルセッションにのみ適用され、ターミナルを閉じると失われます。

このトピックはいかがですか?