
カスタマイズ可能なHTTP/HTTPSプロキシライブラリ for Go。通常のフォワーディング、CONNECTトンネリング、MITM TLSインターセプション、プログラムによるリクエスト/レスポンスの変更をサポートしています。
# GoProxy  [](https://pkg.go.dev/github.com/elazarl/goproxy) [](https://goreportcard.com/report/github.com/elazarl/goproxy) [](https://opensource.org/licenses/BSD-3-Clause) [](https://makeapullrequest.com) [](https://github.com/avelino/awesome-go?tab=readme-ov-file#networking) GoProxy は、Go(別名 Golang)を使って `カスタマイズ可能な` HTTP/HTTPS `プロキシサーバー` を作成するためのライブラリで、設定可能なオプションがいくつか用意されています。 このプロジェクトの目標は、ある程度のトラフィックを処理できる `最適化された` プロキシサーバーを提供しつつ、`カスタマイズ可能` で `プログラム可能` なものにすることです。 プロキシ自体は単なる `net/http` ハンドラなので、その上に複数のミドルウェア(パニックリカバリ、ロギング、圧縮など)を追加できます。また、他の任意の HTTP ネットワークライブラリと簡単に統合できます。 goproxy を使用するには、ブラウザ(またはその他のクライアント)が HTTP プロキシとして goproxy を使用するように設定する必要があります。 [Chrome](https://www.wikihow.com/Connect-to-a-Proxy-Server) と [Firefox](http://www.wikihow.com/Enter-Proxy-Settings-in-Firefox) での設定方法はこちらです。 `base` サンプルから始める場合、プロキシとして使用する URL は `localhost:8080` です。これはサンプルでのデフォルト値です。 また、クライアント側での証明書の問題を避けるために、プロキシの CA 証明書を[信頼](https://github.com/elazarl/goproxy/blob/master/examples/customca/README.md)する必要があります。 > [✈️ Telegram グループ](https://telegram.me/goproxygroup) > > [🎁 スポンサーになる](https://opencollective.com/goproxy) ## 特徴 - 単一の等価比較または正規表現評価により、`特定のホスト` に対してのみ特定のアクションを実行 - ブラウザに送信する前に `リクエスト` と `レスポンス` を操作 - ターゲットサーバーへのリクエスト実行に `カスタム http.Transport` を使用 - `MITM 証明書キャッシュ` を指定して、同じホストへの後続のリクエストで再利用し、CPU を節約。デフォルトでは無効ですが、本番環境では使用すべきです! - ターゲットが `相対パス`(例: `/ping`)の場合、通常の HTTP トラフィックを `カスタムハンドラ` にリダイレクト - `Logger` インターフェースを実装することで、使用するロガーを選択可能 - `PreventCanonicalization` を true に設定することで、HTTP リクエストヘッダーの `正規化` を `無効化` 可能 ## プロキシモード 1. 通常の HTTP プロキシ 2. CONNECT による HTTPS 3. HTTPS MITM(「Man in the Middle」)プロキシサーバー。サーバーが TLS 証明書を生成してリクエスト/レスポンスデータを解析し、それらに対してアクションを実行 4. 「ハイジャックされた」プロキシ接続。設定されたハンドラが生の net.Conn データにアクセス可能 ## スポンサー あなたの会社は GoProxy を使用していますか?プロジェクトの維持と健全性の維持にご協力ください! GoProxy をサポートすることで、バグ修正と新機能により多くの時間を割くことができます。 その代わりに、Gold Supporter または Enterprise プランを選択していただければ、ここに会社のロゴを掲載させていただきます。 > [スポンサーになる](https://opencollective.com/goproxy) [](https://opencollective.com/goproxy) [](https://opencollective.com/goproxy) ## メンテナ - [Elazar Leibovich](https://github.com/elazarl): プロジェクトの創設者、ソフトウェアエンジニア - [Erik Pellizzon](https://github.com/ErikPelli): メンテナ、フリーランサー(コラボレーション歓迎!) GoProxy をプロジェクトに統合する必要がある場合、またはフォークで維持したいカスタム機能がある場合は、現在のメンテナである [Erik](mailto:[email protected]) にメールで連絡してください。有料の独立コンサルタントとしてどのように支援できるかを一緒に話し合うことができます。 ## 貢献 問題、提案、またはバグを見つけた場合は、遠慮なく GitHub の `issue` を開いてお知らせください。 これはボランティアによって管理されている `オープンソース` プロジェクトであり、プロジェクトを改善できるあらゆることについて話し合うことを歓迎します。 問題の背景や変更したい内容など、すべてを説明して、問題を理解しやすくしてください。 小さなコード変更であれば、直接 `Pull Request` を開くこともできますが、説明にはすべてを記載する必要があります。 `5,000` 行を変更した `refactoring` という名前のプルリクエストを開いても、マージしません...`:D` このプロジェクトのコードは `BSD 3-Clause` ライセンスの下でリリースされており、`商用` 利用にも適しています。 ### ケーススタディを提出する あなたは GoProxy を個人プロジェクトまたは勤務先の会社のプロジェクトに導入・統合しました。 このライブラリで作られた新しい `クリエイティブなソリューション` についてぜひ知りたいので、上記のメンテナにメールで `連絡` して、このプロジェクトがあなたのニーズにどのように役立ったかを説明してください。 会社と `秘密保持契約` を結んでいる場合は、会社の公式ウェブサイトにこのトピックについての `ブログ記事` を書くことを提案できます。そうすれば、その情報は会社の選択によって公開され、ブログ記事の `リンクを共有` していただけます:) ケーススタディの目的は、このプロジェクトの `貢献者` がその支援によってどのように世界を `改善` しているのか、そして人々がそれを使って何を構築しているのかを `コミュニティ` と共有することです。 ### リンター コードベースは、プルリクエストのコードに対して自動 lint チェックを使用します。 プルリクエストを開く前に、ローカルマシンでリンターを実行して変更がリンターに適合しているか確認してください。そうすれば、驚くことはありません。 リンターをインストールするには: ```sh go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest ``` これにより、`$GOPATH/bin` フォルダに実行可能ファイルが作成されます (`$GOPATH` は環境変数で、通常その値は `~/go` に相当します。不明な場合は、お使いのマシンで値を確認してください)。 シェルのパスに bin フォルダを含めて、`golangci-lint run` コマンドを直接使用できるようにしてください。 ## GoProxy を試す `goproxy` を試すために、データを宛先に転送するだけの基本的な HTTP/HTTPS プロキシを紹介します: ```go package main import ( "log" "net/http" "github.com/elazarl/goproxy" ) func main() { proxy := goproxy.NewProxyHttpServer() proxy.Verbose = true log.Fatal(http.ListenAndServe(":8080", proxy)) } ``` ### リクエストハンドラ 次の行は、プロキシを通過するすべてのリクエストに `X-GoProxy: yxorPoG-X` ヘッダーを追加してから、宛先に送信します: ```go proxy.OnRequest().DoFunc( func(r *http.Request,ctx *goproxy.ProxyCtx)(*http.Request,*http.Response) { r.Header.Set("X-GoProxy","yxorPoG-X") return r,nil }) ``` `OnRequest()` の入力が空の場合、`DoFunc` で指定された関数がプロキシへのすべての受信リクエストを処理します。この場合、リクエストにヘッダーを追加して呼び出し元に返します。 プロキシは変更されたリクエストを宛先に送信します。 型に指定されたインターフェースを実装している場合は、`DoFunc` の代わりに `Do` を使用することもできます。 > ⚠️ レスポンスとして nil 値を返したことに注意してください。 > 返されたレスポンスが nil でない場合、goproxy はリクエストを破棄し、指定されたレスポンスをクライアントに送信します。 ### 条件付きリクエストハンドラ サーバーのローカルタイムゾーンで 8 時から 17 時の間、www.reddit.com への接続を拒否します: ```go proxy.OnRequest(goproxy.DstHostIs("www.reddit.com")).DoFunc( func(req *http.Request,ctx *goproxy.ProxyCtx)(*http.Request,*http.Response) { if h,_,_ := time.Now().Clock(); h >= 8 && h <= 17 { resp := goproxy.NewResponse(req, goproxy.ContentTypeText, http.StatusForbidden, "Don't waste your time!") return req, resp } return req, nil }) ``` `DstHostIs` は `ReqCondition` を返します。これは `*http.Request` を受け取り、リクエストが条件を満たすかどうかをチェックする boolean を返す関数です(そして処理されます)。 `DstHostIs("www.reddit.com")` は、リクエストが "www.reddit.com" に向けられたときに true を返す `ReqCondition` を返します。 ホストの等価チェックは DNS リゾルバの動作を反映して `大文字と小文字を区別しません`。そのため、ユーザーが "www.rEdDit.com" と入力しても、比較は条件を満たします。 時刻が 8:00 から 17:59 の間の場合、`DoFunc()` で直接レスポンスを返すため、リモートの宛先はリクエストを受信せず、クライアントは `"Don't waste your time!"` というレスポンスを受信します。 ### 始めましょう ```go import "github.com/elazarl/goproxy" ``` `examples` フォルダには、最も一般的なケースをカバーするプロキシの使用例がいくつかあります。それらを参照して、頑張ってください! ## リクエスト&レスポンスの操作 プロキシの動作を操作するためのハンドラには、次の 3 種類があります: ```go // handler called after receiving HTTP CONNECT from the client, and // before proxy establishes connection with the destination host httpsHandlers []HttpsHandler // handler called before proxy sends HTTP request to destination host reqHandlers []ReqHandler // handler called after proxy receives HTTP Response from destination host, // and before proxy forwards the Response to the client respHandlers []RespHandler ``` 操作したい内容に応じて、上記の各リストにハンドラを追加する方法は次のとおりです: ```go // Add handlers to httpsHandlers proxy.OnRequest(some ReqConditions).HandleConnect(YourHandlerFunc()) // Add handlers to reqHandlers proxy.OnRequest(some ReqConditions).Do(YourReqHandlerFunc()) // Add handlers to respHandlers proxy.OnResponse(some RespConditions).Do(YourRespHandlerFunc()) ``` 例: ```go // This rejects the HTTPS request to *.reddit.com during HTTP CONNECT phase. // Reddit URL check is case-insensitive because of (?i), so the block will work also if the user types something like rEdDit.com. proxy.OnRequest(goproxy.ReqHostMatches(regexp.MustCompile("(?i)reddit.*:443$"))).HandleConnect(goproxy.AlwaysReject) // Be careful about this example! It shows you a common error that you // need to avoid. // This will NOT reject the HTTPS request with URL ending with .gif because, // if the scheme is HTTPS, the proxy will receive only URL.Hostname // and URL.Port during the HTTP CONNECT phase. proxy.OnRequest(goproxy.UrlMatches(regexp.MustCompile(`.*gif$`))).HandleConnect(goproxy.AlwaysReject) // To fix the previous example, here there is the correct way to manipulate // an HTTP request using URL.Path (target path) as a condition. proxy.OnRequest(goproxy.UrlMatches(regexp.MustCompile(`.*gif$`))).Do(YourReqHandlerFunc()) ``` ## エラーハンドリング ### 一般的なエラー プロキシでのリクエスト処理中にエラーが発生した場合、デフォルトではプロキシは HTTP エラー `500`(Internal Server Error)を `エラーメッセージ` を `ボディ` コンテンツとして返します。 この動作を上書きしたい場合は、エラーレスポンスを変更する独自の `RespHandler` を定義できます。 コンテキストパラメータのうち、`ctx.Error` には発生した `エラー` が含まれます。エラーが発生しなかった場合は `nil` 値が含まれます。 必要に応じて、カスタム JSON をボディとして返すなど、自由に処理できます。 エラーハンドラの例: ``` proxy.OnResponse().DoFunc(func(resp *http.Response, ctx *goproxy.ProxyCtx) *http.Response { var dnsError *net.DNSError if errors.As(ctx.Error, &dnsError) { // Do not leak our DNS server's address dnsError.Server = "<server-redacted>" return goproxy.NewResponse(ctx.Req, goproxy.ContentTypeText, http.StatusBadGateway, dnsError.Error()) } return resp }) ``` ### 接続エラー ターゲットのリモートサーバー(またはプロキシクライアント)へのデータ送信中にエラーが発生した場合、`proxy.ConnectionErrHandler` が呼び出されてエラーが処理されます。存在しない場合は `デフォルトハンドラ` が使用されます。 エラーは `関数パラメータ` として渡され、プロキシコンテキスト内ではありません。そのため、このハンドラで ctx.Error フィールドを確認する必要はありません。 このハンドラでは、プロキシクライアントとの生の接続に(`io.Writer` として)アクセスできるため、必要に応じてエラーデータを含む任意の HTTP データをその接続に送信できます。 接続がすでに閉じられていないという保証はないため、`Write()` がエラーを返す可能性があります。 `接続` はエラーハンドラの呼び出し後にプロキシライブラリによって `自動的に閉じられます`。そのため、その点を心配する必要はありません。 ## プロジェクトの状態 このプロジェクトは `10 年前` に作成され、`成熟` した段階に達しています。`本番環境` で安全に使用でき、多くのプロジェクトですでに使用されています。 将来 `破壊的な変更` がある場合は、Go モジュールの `新しいバージョン`(例: v2)がリリースされます。 ## 直接依存関係として信頼されているプロジェクト: <p align="left"> <a href="https://github.com/stripe/goproxy" target="_blank" rel="noreferrer"> <img src="https://assets.kitploit.com/production/public/readmes/50732/64d9d4a11b59a2883beada1d0e2d5e574327f693a7b84f0905510f865248f63e/649c74ea103584e65478fd86f61a32c4651855d53efb8b8d9b9011b42e39c4ee-display-v1.webp" alt="Stripe" title="Stripe" /> </a> <a href="https://github.com/dependabot/goproxy" target="_blank" rel="noreferrer"> <img src="https://assets.kitploit.com/production/public/readmes/50732/537c51643f1d6066d041dba12f4bcae952c41490dcf6e6a1143a2e2b15d82199/ec116e30794b65255c125251a815dc4dd376fbdd76a6919fe1d2decae4c8429d-display-v1.webp" alt="Dependabot" title="Dependabot" /> </a> <a href="https://github.com/go-git/go-git" target="_blank" rel="noreferrer"> <img src="https://assets.kitploit.com/production/public/readmes/50732/141e8059d0f465d80548bbe9af30697989ed963c30581830b97bc57ef15da0d5/fd51665ff118904f4eefb78cfd2774c195fdf100cffaa6c03e4b8467584c42bd-display-v1.webp" alt="Go Git" title="Go Git" /> </a> <a href="https://github.com/google/oss-rebuild" target="_blank" rel="noreferrer"> <img src="https://assets.kitploit.com/production/public/readmes/50732/3cdb183f5b49d7315445abe5fd1e1dac0665db8ad88ef05062eea726ae908031/1957e79f54e85ce7afc6febabb41556f30f81b172a0c63688094ca62515817a1-display-v1.webp" alt="Google" title="Google" /> </a> <a href="https://github.com/grafana/grafana-plugin-sdk-go" target="_blank" rel="noreferrer"> <img src="https://assets.kitploit.com/production/public/readmes/50732/801cf1f9b90012f77d2cdbac224be8b5d7def3b5b97483bedaeca069dad28790/c68471eb91d68e700faf0b225cb7f5eb55b88e520068ede25e660bfcca0f7681-display-v1.webp" alt="Grafana" title="Grafana" /> </a> <a href="https://github.com/superfly/tokenizer" target="_blank" rel="noreferrer"> <img src="https://assets.kitploit.com/production/public/readmes/50732/fc6176b4a42fa9a431e616d58461b2b6d9fcc84ac214f1f1d321527a6445ee12/b10213639c5ce30276ff67a0f4609737b8c6a65b76b2d99d23805892a99e79d6-display-v1.webp" alt="Fly.io" title="Fly.io" /> </a> <a href="https://github.com/kubernetes/minikube" target="_blank" rel="noreferrer"> <img src="https://assets.kitploit.com/production/public/readmes/50732/3ea12262ac6217219b5cffb4fbc2b06d415dcee86a86e9ff620fa3369a64ae36/0ef3dfd53535365fca209291742bdd27099f430199526b20ba59f56c180fcc7e-display-v1.webp" alt="Kubernetes / Minikube" title="Kubernetes / Minikube" /> </a> <a href="https://github.com/newrelic/newrelic-client-go" target="_blank" rel="noreferrer"> <img src="https://assets.kitploit.com/production/public/readmes/50732/e3060fc9e303c90a833c7a6e01c4977d237a503215c5d6da66817881de9298c3/36b33aedf9fdd68f8e3ff5e8e9274cad40fb63d874187000c2dd29edc533d02f-display-v1.webp" alt="New Relic" title="New Relic" /> </a> </p>