Gadget 28：特殊ケース

ネットワーク制限・企業LAN・VPNなど、想定外の環境で Cloudflare OS を使う場合

特殊ケース

普通と違うネットワーク・環境（企業 LAN、VPN、プロキシ配下）での注意点と対策です。

目的

  • 「想定内で合わない環境」でも素早く切り分けて動かせる
  • 制限の多いネットワークでの失敗を事前に避ける

前提条件

ケース別の対策

ケース A：企業 LAN（プロキシ配下）

  • 症状例: pnpm install の git clone が失敗、WS（WebSocket）で UI が途中で切れる

  • 対処:

    # プロキシを明示
export https_proxy=http://proxy.example.com:8080
# NPM にも通す（必要時）
npm config set proxy http://proxy.example.com:8080

  • プロキシが WS / 大きいリクエストを落とす場合は、WebSocket 転送を許可設定する

ケース B：VPN 経由

  • 症状例: VPN 有効時だけ繋がらない / 逆に VPN 無効時だけ繋がらない
  • 対処:
    • VPN によるルーティングを確認（route / netstat -rn）
    • DNS が VPN 経由で引けない場合、/etc/resolv.conf やローカル DNS を確認
    • 切り分け: curl --interface や IP 直指定で「経路なのか DNS なのか」

ケース C：ポート制限（トラフィック制限）

  • 症状例: 8787 が外部から / 社内からも触れない
  • 対処:
    • よく使われるポート（443 / 8443 など）でリバースプロキシ
    • Cloudflare Tunnel（443 出のみ）が最も通りやすい（13）

ケース D：固定 IP が必要な連携先

  • 症状例: 外部 API が「許可 IP リスト」を要求
  • 対処: Tunnel / リバースプロキシの出口 IP を調べ、リストへ追加

手順（切り分けの順）

  1. 「経路 / DNS / ポート / プロキシ」のどこで落ちるか:

    ping <host>                        # 経路
dig +short <host>                  # DNS
nc -vz <host> 8787                 # ポート
curl -v https://<host>             # TLS・プロキシ

  2. 該当ケースの対策（上表）を適用

  3. 再テストして原因を記録（32）

よくある失敗

症状 原因 対処
プロキシ配下で clone 失敗 環境変数未設定 プロキシを明示
VPN でだけ繋がる/繋がらない ルーティング優先度 route で確認し固定
社内で 8787 不可 ポート制限 443 リバース / Tunnel
不許可 IP で拒否 連携先の許可リスト 出口 IP を把握

確認

次に読む