# Proxyman の Automatic Setup

> Proxyman の Automatic Setup で事前設定済みのターミナルをワンクリックで開き、NodeJS、Python、Ruby、Golang、cURL からの HTTP/HTTPS 通信をキャプチャできます。

## 1. 問題点 {#1-problems}

次のような環境では、Proxyman で HTTP/HTTPS 通信を**キャプチャできません**：

* **NodeJS**：Axios、got、superagent、fetch、node-fetch
* **Python**：http、https、aiohttp、requests
* **Ruby**：http、net/http、net/https、faraday、httparty、fastlane
* Golang：net/http、fasthttp、resty、gorequest、req、grequests
* ElectronJS
* cURL

これは既知の問題です。ターミナルアプリから実行した NodeJS、Python、Ruby、cURL は、システムの HTTP プロキシを使いません。そのため、Proxyman には通信が表示されません。

各ライブラリのドキュメントを読んで、次の設定を手動で行う必要があります：

* HTTP プロキシ
* 自己署名証明書の信頼設定

\=> 手間がかかり、設定ミスも起きやすい ❌

## 2. 解決策：Automatic Setup {#2-solution-automatic-setup}

### メリット {#benefit}

* ✅ **ワンクリック**で、さまざまな開発環境の **HTTP プロキシと証明書を自動設定**
* NodeJS、Python、Ruby、Golang、ターミナル、Web ブラウザなどからの HTTP(S) 通信をキャプチャ
* 安全です。現在のセッションでのみ動作するため、OS には影響しません

### 使い方 {#how-to-use}

1. Proxyman を開き、**Setup** メニュー → **Automatic Setup…** を選択します
2. **Open New Terminal…** をクリックします。その横のメニューから Apple Terminal、iTerm2、Ghostty を選べます
3. 必要に応じて、AppleScript の権限を求めるプロンプトで許可します
4. 新しいターミナルのウィンドウが開いたら、バックエンドサーバーを起動するか、スクリプトを実行します → Proxyman がすべての通信を自動的にキャプチャします
5. 完了です ✅

![Apple Terminal と Open New Terminal のほか、Web Browsers と ElectronJS App のセクションが表示されている Proxyman Automatic Setup ウィンドウ](https://proxyman.com/docs/assets/proxyman-automatic-setup-window.jpg)

_事前設定済みのターミナルアプリを起動_

![Proxyman Automatic Setup のスクリプトに関するメッセージが表示され、バックエンドサーバーを起動できる状態のターミナルウィンドウ](https://proxyman.com/docs/assets/CleanShot%202023-04-26%20at%2015.53.00%402x.jpg)

_新しいターミナルアプリが起動_

### 注意事項 {#notes}

* Automatic Setup では、Apple Terminal、iTerm2、Ghostty を開けます。Hyper など別のターミナルアプリを使う場合は、同じメニューで **My own Terminal…** を選ぶか、[Manual Setup](https://proxyman.com/docs/ja/automatic-setup/manual-setup) を使ってください。
* 現在のセッションでのみ実行されるため安全です。システムの設定は変更されません。

#### ElectronJS {#electronjs}

1. Automatic Setup から新しいターミナルを開きます
2. 次のコマンドラインを使用します：

```
open ~/Applications/your_electron_app.app
```

Automatic Setup ウィンドウで **Select ElectronJS App…** をクリックしても同じことができます。詳しくは [ElectronJS](https://proxyman.com/docs/ja/debug-devices/electronjs) をご覧ください。

### 対応ライブラリ {#support-libraries}

Proxyman（Automatic Setup 使用時）は、次のネットワークライブラリにそのまま対応しています。

* NodeJS：[axios](https://www.npmjs.com/package/axios)、[fetch](https://nodejs.org/dist/latest-v18.x/docs/api/globals.html#fetch)（v18 以降）、[node-fetch](https://www.npmjs.com/package/node-fetch)、[got](https://www.npmjs.com/package/got)、[https](https://nodejs.org/api/https.html)、[superagent](https://www.npmjs.com/package/superagent)
* Ruby：[http](https://ruby-doc.org/stdlib-3.0.2/libdoc/net/http/rdoc/Net/HTTP.html)、[net/http](https://ruby-doc.org/stdlib-2.7.0/libdoc/net/http/rdoc/Net/HTTP.html)、[net/https](https://ruby-doc.org/stdlib-2.7.0/libdoc/net/http/rdoc/Net/HTTP.html)、[httparty](https://github.com/jnunemaker/httparty)、[faraday](https://github.com/lostisland/faraday)、fastlane
* Python：[requests](https://pypi.org/project/requests/)、[aiohttp](https://docs.aiohttp.org/en/stable/)、http.client、urllib3、httpx
* Golang：net/http、fasthttp、resty、gorequest、req、grequests
* ElectronJS アプリ
* `--proxy` フラグを指定しない cURL

> **ヒント:** 変更は現在のターミナルセッションにのみ適用されるため、**安全**です。**bash\_profile** や **zshrc** ファイルは変更されません。

## 3. 詳細：仕組み {#3-advanced-how-does-it-work}

**Open New Terminal…** をクリックすると、Proxyman は次の処理を行います：

1. AppleScript を使って、ターミナルアプリを起動します
2. 新しいターミナルのウィンドウで、次のコマンドラインを実行します：

```bash
set -a && source "$HOME/.proxyman/proxyman_env_automatic_setup.sh" && set +a
```

3. proxyman\_env\_automatic\_setup.sh は、Proxyman に必要な環境変数を設定する bash スクリプトです

たとえば、次の環境変数などを設定します：

* HTTP\_PROXY と HTTPS\_PROXY の環境変数
* PATH
* RUBYLIB
* PYTHONPATH
* NODE\_OPTIONS
* GLOBAL\_AGENT\_HTTP\_PROXY

**NodeJS**：

1. Proxyman は、新しい Node ディレクトリを $PATH 環境変数の先頭に追加します
2. Proxyman は [global-agent](https://www.npmjs.com/package/global-agent) パッケージを使って Node をモンキーパッチし、axios と fetch で HTTP プロキシを使えるようにします

**Ruby**：

1. $RUBYLIB を上書きし、Proxyman アプリを指すようにします
2. http、net/http、net/https などの一般的なライブラリにパッチを適用 → HTTP プロキシを設定し、Proxyman の自己署名証明書を信頼するようにします

**Python**：

1. $PYTHONPATH を上書きし、Proxyman アプリを指すようにします
2. aiohttp、httplib、http.client などの一般的なライブラリにパッチを適用 → HTTP プロキシを設定し、Proxyman の自己署名証明書を信頼するようにします

**Go**：

1. HTTP\_PROXY と HTTPS\_PROXY の環境変数を上書きします
2. 自己署名証明書を信頼するように、Go の環境変数を一部上書きします

## 4. トラブルシューティング {#4-troubleshooting}

[トラブルシューティング](https://proxyman.com/docs/ja/automatic-setup/troubleshooting) ページをご覧ください。

## 関連情報 {#learn-more}

* [axios（NodeJS）から HTTP/HTTPS リクエストをキャプチャする](https://proxyman.com/posts/2023-05-14-Capture-HTTP-HTTPS-Request-From-Axios-NodeJS)
* [Ruby（net::http や http gem）のスクリプトから HTTP/HTTPS リクエストをキャプチャする](https://proxyman.com/posts/2023-05-09-Capture-HTTP-HTTPS-Request-Response-From-Ruby-Net-HTTP-library)
* [Python の requests や httpx ライブラリから HTTPS 通信をキャプチャする方法](https://proxyman.com/posts/2025-01-29-How-To-Capture-HTTPS-Traffic-From-Python-Requests-httpx)
