Curlese、5年後の考察
Curlese, Five Years Later (hypertesto.me)
要約
この記事は、HTTP連携の問題解決にcurlコマンドを活用する「Curlese」という手法について、5年前の提唱から現在までの進化を考察しています。HTTP/2やmTLSの普及、WAFやAPIゲートウェイの増加といった技術的変化に対応するため、curlコマンドの新たな活用法や便利なオプションが紹介されています。また、AIによる分析への応用にも触れ、curlコマンドが問題解決の普遍的なツールであり続けることを示唆しています。
全文翻訳
Curlese、5年後の今:curlは依然として壊れたインテグレーションの普遍的な言語
- HyperTesto
- Blog
- Curlese, five years later: curl is still the universal language of broken integrations
3 August 2026・7 分
[画像]
約5年前、私は(イタリア語で)、私が冗談でcurleseと呼んだものについて記事を書きました。それは、HTTPインテグレーションが壊れたときに、誰のせいかを突き止めるためにcurlを普遍的な言語として使用する習慣です。¹ アイデアはシンプルでした。相手が読みたがらないログファイルについてプロバイダーと議論する代わりに、curlコマンドを送るのです。それは自己記述的で、再現可能で、そして最も重要なことに、あなたのコードではないので、誰も「あなたのアプリケーションがバグっている」と却下することはできません。
5年後、この論文の主張は恥ずかしいほどよく持ったことを確認できます。私は今でもこれを頻繁に行っています。しかし、この論文を取り巻く世界はかなり変化したので、アップデートの時期が来ました。何が変わり、何が変わらず、そして2026年における私のサバイバルキットはどのようなものかを見ていきましょう。
何が変わらなかったか
社会的な問題は、私がそれを残したまさにその場所にあります。すべてのインテグレーションには、少なくとも2つのチーム、誰も完全に理解していないファイアウォール、そして「私の側では動く」という言葉で始まる会話が伴います。あなたの完璧に明確なアプリケーションログは、その会話では依然として価値がありません。なぜなら:
- 相手はあなたのログを解釈できない(またはしたくない)
- 問題があなたにあると仮定する方が常に簡単です
- あなたは実際にそれを修正できる人物と話していることはめったにありません
出力付きのcurlコマンドは、これら3つすべてを解決します。それは実行可能な証拠です。あなたはそれをチケットに貼り付けることができ、相手チームのネットワーク管理者はそれをそのまま実行できます。そして、その判断はプレーンテキストで書かれます。この記事のこの部分はまったく更新の必要がありません。それはあなたの気分次第で、安心できるか憂鬱になるかのどちらかです。
何が変わったか
実際、かなり多く変わりました。
HTTP/2はどこにでもあり、HTTP/3はもはや珍しくありません。 2021年には、私が扱うようなインテグレーションではプレーンなHTTP/1.1交換が標準でした。今では、HTTP/2をネゴシエートするエンドポイントに定期的に遭遇し、時にはALPN自体が問題の一部となることもあります。あなたのラップトップからはリクエストが機能するのに、サーバーからはハングする場合、「彼らが異なるHTTPバージョンを話している」というのは、今や正当な疑いです。
mTLSは珍しいものから日常的なものになりました。 クライアント証明書は、かつては年に一度の面倒なものでした。今では、2件に1件のB2Bインテグレーションが相互TLSを要求するようになり、私の2021年の自分ではカバーしていなかった、まったく新しいカテゴリの障害(とcurlフラグ)が発生しています。
すべてがWAF、プロキシ、またはAPIゲートウェイの後ろにあります。 これは、あなたが受けるエラーがアプリケーションからではなく、その前のバウンサーからであることが多いことを意味します。バウンサーは、どのUser-Agent文字列が存在する価値があるかについて独自の考えを持っています。私はかつて、あるエンドポイントが機能することを証明するために午後を費やしました。プロバイダーのエッジが特定のクライアントを気に入らなかっただけでした。修正は文字通りヘッダーを変更することでした。いつものように、その証明は、1つのフラグだけが異なる一対のcurlコマンドでした。
共通語には新しい話し手が加わりました。 2026年、あなたが問題を説明している相手は、ますます人間ではなくなっています。-v出力付きのcurlコマンドは、セットアップなしで完全で曖昧さのないコンテキストであるため、行き詰まったときにLLMに貼り付けるのに最適なものです。チケットに理想的なのと同じ特性が、プロンプトにも理想的であることがわかりました。機械もまた、curleseを話します。
2026年のサバイバルキット
古い記事のすべてが依然として適用されます(-v、-k、--connect-timeout、--trace-ascii、--trace-time — 後者は数ヶ月前に幽霊のような遅延を追跡しているときに私を救いました)。ここでは、それ以来、永久的な場所を確保したものを示します。
| フラグ | キットに入っている理由 |
| --- | |
| -w '%{time_total} %{time_connect} %{time_appconnect}' | タイミングの内訳。「あなたのサーバーが遅い」と「あなたのTLSハンドシェイクが遅い」の違いは、どこにも行かないチケットと修正されるチケットの違いです。 |
| --resolve host:port:ip | DNSをバイパスして、正しいSNI/Hostで特定のIPをテストします。DNSがロードバランシングされており、一部のバックエンドだけが壊れている場合に不可欠です。 |
| --connect-to ::alt-host: | 同じファミリー:ヘッダーをそのままにして、接続を別の場所にリダイレクトします。本番URLでステージングバックエンドをテストするのに最適です。 |
| --cert client.pem --key client.key | mTLS。障害の半分は証明書チェーンであり、curlは送信した証明書とサーバーがそれについて言ったことを正確に教えてくれます。 |
| --json | Content-Type: application/jsonを設定し、データをPOSTします。小さなことですが、再現コマンドを作成する際に「ヘッダーを忘れた」という間違いのクラス全体を削除します。 |
| --fail-with-body | 終了コードはHTTPステータスを反映しますが、エラー応答ボディは引き続き表示されます。スクリプトと人間の両方に最適です。 |
| --retry 5 --retry-all-errors | 「時々失敗する」は、もはや許容できるバグレポートではありません。統計に語らせましょう。 |
| --no-alpn | HTTPバージョンネゴシエーション自体が問題であると疑われる特別な午後のために。まれですが、必要なときは、他に何もできません。 |
-wに関する注記:フォーマット文字列は完全にカスタマイズ可能で、ひどく過小評価されています。curl -o /dev/null -s -w 'dns:%{time_namelookup} connect:%{time_connect} tls:%{time_appconnect} total:%{time_total} http:%{http_code} ' https://example.comは、あらゆるエンドポイントの1行パフォーマンス剖検を提供します。私はこれをシェルエイリアスとして持っています。² あなたもそうすべきです。
辞書、更新版
古い記事には、頻繁なエラーメッセージとその通常の原因のリストがありました。ここに2026年版があります。同じ形式で、症状が先、可能性のある原因が後です。
| 症状 | おそらく意味すること |
| --- | |
| connection timed out | ネットワークパスがありません。ファイアウォール、ルーティング、またはサービスがダウンしています。依然としてトップヒットです。 |
| connection refused | パスは存在しますが、そのポートでリッスンしているものはありません。サービスダウンまたはポート間違い。 |
| SSL certificate problem: unable to get local issuer certificate | 自己署名証明書、または信頼ストアが知らないCA。古典的で永遠。 |
| sslv3 alert handshake failure / curl: (35) | TLSバージョンまたは暗号スイートが一致しません。多くの場合、古いサーバーと最新のクライアント、またはその逆です。 |
| wrong version number | プレーンHTTPポートにTLSで話しかけています。または、途中で何かを改変しているプロキシがあります。 |
| HTTP/2ストリームエラー/リセットが--http1.1で消える | 中間ボックスまたはHTTP/2実装にバグがあるサーバー。誰かを非難する前にダウングレードして再テストしてください。 |
| 見たことのない製品からのHTMLページで403 | それはWAFです。ページを読んでください。通常はベンダーの名前が記載されており、どのエッジがあなたをブロックしているかがわかります。 |
| --insecureでは機能するが、それ以外では機能しない | 証明書チェーンの問題。どこを掘り下げるべきかが正確にわかりました。 |
言葉を広める、リロード
古い記事は、相手にcurlセッションを要求するためのフレーズのリストで締めくくられました。それらは当時翻訳不可能であり、今でも翻訳不可能なので、ここに2026年の英語スターターパックがあります。
- 「あなたの側からcurlして、チケットに出力を貼り付けてもらえますか?」
- 「私たち両方が同じコマンドを実行して、結果を比較しましょう。」
- 「Postmanのスクリーンショットではなく、
-vの出力を送ってください。」 ³ - 「自分でcurlするか、私があなたを激しくcurlしますよ。」 ⁴
5年経っても、私のアドバイスは変わりません。インテグレーションが壊れたときは、議論するのではなく、curlしろ!コマンドは契約であり、出力は判決であり、チケットは自己解決します。いくつかのテクノロジーは来て去りますが、謙虚なcurl呼び出しは、明らかに永遠です。
お読みいただきありがとうございます。そして今、言葉を広めに行きましょう!⁵
¹ 元の記事はこちらです。イタリア語が読めるなら。Curleseは実際には翻訳されません。それは「curl」を言語名にしたもので、「curlare」のような動詞や「curlata」(通常は怒って実行される単一のcurl呼び出し)のような名詞があります。 [↩︎]
² それはcurlopsy(curl + autopsy)と呼ばれます。はい、ひどい名前です。いいえ、変更しません。2台のラップトップを乗り越えてきましたし、現時点では年功序列があります。 [↩︎]
³ Postmanに反対しているわけではありません。しかし、GUIのスクリーンショットは再現可能なテストケースではなく、あなたもそれを知っています。 [↩︎]
⁴ 伝え方が重要です。無表情で、書面で、そして少なくとも1つのインシデントブリッジを一緒に乗り越えた相手とのみ。人事部は、curleseを流暢に話すことは notorietly ありません。 [↩︎]
⁵ はい、verbです。イタリア語の原典は「diffondete il verbo!」で締めくくられました。そしてイタリア語ではverboは「言葉」と「動詞」の両方を意味するため、それは唯一の正しい翻訳です。curlは今や動詞であり、誇りを持って活用してください。 [↩︎]