Rama 0.4: システムプロキシとPACサポート
Rama 0.4: System proxy and PAC support (plabayo.tech)
要約
Rama 0.4がリリースされ、システム全体のプロキシ設定とプロキシ自動設定(PAC)ファイルのサポートが追加されました。このバージョンでは、ttRPCおよびgRPCのサポート、HAR WebSocket処理の改善、その他多数の機能強化も行われています。
全文翻訳
Rama 0.4: システムプロキシとPACサポート
0.3のリリースから6週間後、約束された2〜8週間のリリースサイクル内で、私たちはrama 0.4をリリースできたことを誇りに思います。このリリースには、多くの改善が含まれているだけでなく、以前からバックログにあったいくつかの項目にも取り組むことができました。
技術的な詳細については、rama 0.4のリリースノートを含む完全なCHANGELOGをhttps://github.com/plabayo/rama/blob/main/CHANGELOG.mdでご確認ください。また、Ramaでサポートされているプロトコルやその他の機能の概要は、いつでもhttps://ramaproxy.org/#featuresで確認できます。
システムプロキシ設定
Ramaは長らくHTTP、TLS over HTTP(HTTPS)、SOCKS5プロキシをサポートしてきました。最も簡単な方法は、ProxyRoute(s)(以前はProxyAddressとして直接挿入されていました)を使用して直接設定することです。アプリケーション内では、これらをハードコーディングするか、何らかの設定を介して公開できます。例としては、ブラウザやエディタの設定ファイルやGUIからプロキシを設定できる機能が挙げられます。このアプローチについては、Ramaブックの「アプリケーションプロキシ」の章で詳しく読むことができます。
アプリケーションはしばしばHTTP_PROXY環境変数もサポートしています。curlはCGIの理由から小文字のhttp_proxyバリアントを使用しますが、これはProxyEnvLayerを使用する際にデフォルトで従う規約でもあります。それ以外にも、ALL_PROXY、HTTPS_PROXY、NO_PROXYといったより一般的な環境変数があります。特にNO_PROXYは、一部の(サブ)ドメインがプロキシを経由しないようにするためのバイパスルールを追加するために使用されます。これらすべてが、ProxyEnvLayerとNoProxyEnvLayerを介してサポートされるようになりました。
しかし、ご存知かもしれませんが、オペレーティングシステムはシステム全体でプロキシを設定することも可能にしています。ここではHTTP、HTTPS、SOCKS5プロキシを設定できるほか、プロキシしないものに対するバイパスルールも設定できます。これらは前述の環境変数と非常によく似ていますが、システム全体に適用されます。もちろん、一般的に、アプリケーションがこれらのシステム設定設定を尊重することを強制するものは何もありません。それは、アプリケーションがそうしたくない場合や、単にそのための組み込み機能を持っていない場合(これは、これまでRamaで構築されたネットワーククライアントの場合でした)があります。rama 0.4では、SystemProxyLayerを介してこれが標準でサポートされます。これらの設定がどのように機能するかについては、Ramaブックの「システムプロキシ」の章で詳しく学ぶことができます。
システム設定設定では、JavaScriptファイルを使用してプロキシを動的に選択することもできます。これはProxy Auto Configuration、または略してPACとして知られています。これを行うには、JavaScriptランタイムが必要ですが、これはrama 0.4以前のRamaには含まれていませんでした。しかし、今では含まれています。rama-jsにより、WASMランタイム内でJavaScriptランタイムを実行できるようになりました(wasmtimeを使用します。これは将来的にrama-wasmを構築するためにも使用するランタイムです)。これは、JavaScriptランタイムがクラッシュしてもプロセス全体が停止しないように、分離を提供するため重要です。Google Chromeのようなアプリケーションは、JavaScriptエンジンを別のOSプロセスで実行しますが、Ramaフレームワーク内では、代わりにWASMランタイム内でこれを行うことを選択しました。同じ分離ですが、Ramaを使用して構築された任意のアプリケーションが別のプロセスを実行およびバンドルできるようにする必要はありません。
Ramaは現在、rama-pacクレートを介してPACサポートを提供しています。これにより、PACランタイムを取得し、PACスクリプトを評価できるだけでなく、ドメインXをプロキシルールYにルーティングする機能だけが必要な場合にスクリプトを簡単に生成することもできます。
これらの新しいRamaフレームワークの機能で遊びたい場合は、コマンドラインアプリケーション(CLI)でも簡単に試すことができます。インストール方法については、Ramaブックの「ramaバイナリ」の章で学ぶことができます。
- クライアントの
sendコマンドは(環境変数やコマンド引数で上書きされない限り)標準でこれをサポートしています。 - PACスクリプトを生成したり、REPLを介してPACスクリプトを評価したりできる
rama pacサブコマンドが追加されました。後者は特に便利です。なぜなら、これ以前はPACファイルで遊べる環境は非常に古く、マイナーなアプリケーションに限られていたからです。私に言わせれば、ネットワークCLIツールキットへのもう一つの素晴らしい追加機能です。
ttRPCとgRPC
プロトコルに関しては、Ramaは新しいrama-ttrpcクレートを介してttRPCもサポートするようになりました。これはgRPCの軽量な代替手段と見なすことができ、TCPのようなトランスポートプロトコル上で直接動作しますが、依然としてprotobuf(proto)コントラクトを介します。
ただし、この分野での新しいクレートはこれだけではありません。rama-grpc-macrosクレートも登場し、Ramaは単一行のprotoコードを書くことなく、クライアント側とサーバー側のgRPCコードを生成する能力を得ました。これは、独自のコーデックに依存し、オプションでSerdeによって駆動されます(define_serviceを参照)。これは、すでにgRPCを使用しており、スタック全体を制御しているユーザーに最適です。
HAR WebSockets
HAR (HTTP Archive)がWebSocketデータをサポートしていることが判明しました。この最後の瞬間のrama 0.4のサプライズは、商業パートナーのおかげで私たちの注目するところとなりました。しかし、これはあまり一般的ではない機能です。数年前にChromeに追加されましたが、他の多くのアプリケーションではまだ採用されていません。そのため、私たちは主にChromeを実装の指針とするための「オラクル」として使用しました。
現在サポートされており、以前のHARエクスポート実装が、一貫性と順序付けのためにメモリに保持しすぎていたことも判明しました。これらはすべて解決され、HTTPおよびWSデータをメモリにバッファリングすることなく、ディスクにストリーミングできるようになりました。
Rama CLIのsendコマンドも、実行したHTTP/WS会話のHARファイルをエクスポートするサポートを追加しました。これを行うには、--har引数を使用できます。
その他の変更と改善
いくつかの破壊的変更と多数の改善があります。完全なリストについては、変更履歴を参照してください。いくつか例を挙げると:
- 私たちのピーカ―(トランスポートストリーム上で流れるプロトコルをチェックするために使用されます。Ramaブックの「プロトコル検査」の章を参照してください)は、バイトがヒューリスティクスを満たせなくなった場合に、可能な限り速く失敗できるようになり、いくつかの軽微なバグ修正も受けました。HTTPピーカ―ルーターは、HTTPヘッダー行と混同される可能性のある一般的なメソッド名をスキップするようにオプトインできるようになりました。
PINGのような一部のケースでは、タイムアウトまでピーカ―ロジックを不必要に遅延させる可能性があり、これは理想的ではありません。この追加設定を使用することで、ほとんど、あるいはすべてのそのようなエッジケースを防ぐことができるはずです。 - このリリースでは、Apple Network Extensionサポートにもいくつかの改善が加えられました。これは、Appleプラットフォーム向けのL4およびL3プロキシを構築するためにこれに依存している人々にとって、大いに感謝されることでしょう。
- 私たちの(クライアント)接続サービスは、わずかに異なるトレイトシグネチャを持つようになり、より良いエラーハンドリングと、いつリトライすべきか、いつ完全に失敗すべきかを知るような、よりスマートな意思決定が可能になりました。
- PACの関数として、複数のプロキシルート(アドレス)を入力拡張に挿入できるようになり、指定された順序で試行されます。既存のプロキシDB機能もデフォルトでこれを利用しますが、古いランダムな単一プロキシ選択動作を希望する場合は、引き続きオプトインできます。
感謝
このリリースを機に、Ramaを可能にした、そしてこれからも可能にしてくれるすべての人々に感謝したいと思います。貢献者、私たちが依存しているプロジェクト、そして私たちがフォークしたプロジェクト、より広いTokioおよびRustエコシステム、スポンサー、そしてもちろん商業パートナーに感謝します。
今後のリリースも非常に楽しみにしています。
このブログのRSSフィードを購読するか、独自のニュースレターを購読することもできます。ニュースレターは私たち自身が執筆し、お客様のメールはRamaで構築されたシステム内でプライバシーに配慮して保管されます。
Ramaを単独で、または組織で何かを構築していますか?メールまたはDiscordでぜひお知らせください。
力を得て、変化を起こしましょう。