CacinieP/ネットワークトラブルシュートスキル

ネットワークトラブルシュートスキル は何をしますか？

AIコーディングエージェント向けの汎用ネットワークトラブルシューティングスキル：DNS、プロキシ、SSL、パッケージマネージャー、Docker、Git、および中国/GFWワークフローをカバーします。

使用方法

このスキルは、AIエージェント（Claude Code、Cursor、Codexなど）がネットワーク関連の問題に遭遇した際に自動的に呼び出されることを想定しています。以下のような状況で役立ちます：

• DNS解決に失敗する
• プロキシ経由の接続が拒否される
• SSL証明書エラーが発生する
• パッケージマネージャーがリポジトリにアクセスできない
• Dockerイメージのプル/プッシュが失敗する
• Gitリモート操作がタイムアウトする
• 中国のGFW環境下で接続がブロックされる

トラブルシューティングガイド

1. DNS問題

原因: DNSサーバーが正しく設定されていない、またはDNS解決が遅延している。

確認コマンド:

nslookup example.com
dig +short example.com

修正手順:

• /etc/resolv.conf の内容を確認する
• 信頼できるパブリックDNS（例：8.8.8.8、1.1.1.1）を使用する
• systemd-resolved の設定を確認する（Linux）

2. プロキシ設定

原因: 環境変数 HTTP_PROXY、HTTPS_PROXY、NO_PROXY が正しく設定されていない。

確認コマンド:

echo $HTTP_PROXY
echo $HTTPS_PROXY
echo $NO_PROXY

修正手順:

• プロキシのURLとポートが正しいことを確認する
• プロキシ認証が必要な場合は、ユーザー名とパスワードを含める（例：http://user:pass@proxy:8080）
• 内部ネットワークやループバックアドレスを NO_PROXY に追加する
• DockerやGitなどのツール固有のプロキシ設定も確認する

3. SSL/TLS証明書

原因: 証明書の有効期限切れ、信頼されていないCA、または中間証明書の欠落。

確認コマンド:

openssl s_client -connect example.com:443
curl -v https://example.com

修正手順:

• システムの証明書ストアを更新する（update-ca-certificates）
• 自己署名証明書の場合は、環境変数 SSL_CERT_FILE または NODE_EXTRA_CA_CERTS を設定する
• 企業内証明書の場合は、適切なルートCAをインストールする

4. パッケージマネージャー

npm

問題: npm install がタイムアウトまたは失敗する。

解決策:

# レジストリを変更する（中国向け）
npm config set registry https://registry.npmmirror.com
# プロキシ設定
npm config set proxy http://proxy:8080
npm config set https-proxy http://proxy:8080

pip

問題: pip install がダウンロードに失敗する。

解決策:

# インデックスURLを変更する（中国向け）
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple package_name
# プロキシ設定
pip install --proxy http://proxy:8080 package_name

brew (macOS)

問題: brew update または brew install が遅い/失敗する。

解決策:

# ミラーリング（中国向け）
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git"

5. Docker

問題: Dockerイメージのプル/プッシュがタイムアウトする。

解決策:

• Dockerデーモンにプロキシを設定する（/etc/systemd/system/docker.service.d/proxy.conf）
• レジストリミラーを使用する（中国向け）

  {
    "registry-mirrors": ["https://docker.mirrors.ustc.edu.cn"]
  }
  

確認コマンド:

docker info | grep -i proxy
docker info | grep -i mirror

6. Git

問題: git clone, git push, git pull が失敗する。

解決策:

# HTTPSプロキシ設定
git config --global http.proxy http://proxy:8080
git config --global https.proxy http://proxy:8080
# SSHの場合は ~/.ssh/config を確認
# 特定のホストのプロキシを無効にする
git config --global http.https://github.com.proxy ""

7. 中国/GFW環境

共通の問題: 多数の国際サービス（GitHub, Google, Docker Hubなど）が直接アクセスできない。

推奨される解決策:

1. ミラーリングを使用する:

   • GitHub: hub.fastgit.org または gitclone.com
   • Docker Hub: 国内ミラー（docker.mirrors.ustc.edu.cn, registry.cn-hangzhou.aliyuncs.com）
   • npm: https://registry.npmmirror.com
   • pip: https://pypi.tuna.tsinghua.edu.cn/simple

2. プロキシ/VPN:

   • 環境変数にプロキシを設定する
   • システム全体のプロキシ設定を行う

3. 特別なリモート設定:

   • Git: git config --global url."https://hub.fastgit.org/".insteadOf "https://github.com/"

注意事項

• このスキルは一般的なネットワーク問題のトラブルシューティングを提供します。特殊な環境（企業プロキシ、VPN、カスタムDNS）では追加の設定が必要な場合があります。
• セキュリティ上の理由から、プロキシ認証情報をコードや設定ファイルに平文で保存しないでください。
• 中国/GFW向けのミラーリングは、最新の有効なミラーを確認してから使用してください。
• 問題が解決しない場合は、システム管理者に問い合わせてください。