はじめに
数分でProxerをインストールし、ローカルHTTPサービスを公開します。
- HTTP/WebSocketトラフィックを受けられる公開マシン
- 公開したいローカルHTTPサービス
- npmでインストールする場合はNode.js 24以降
インストール
Section titled “インストール”GitHub ReleasesからWindows用の単体実行ファイルをダウンロードします。
proxer.exe --versionbrew install tinyrack-net/tap/proxernpmはすべてのプラットフォームで使えるクロスプラットフォームなインストール方法です。
npm install -g @tinyrack/proxerdocker run --rm tinyrack/proxer --version新しく始める
Section titled “新しく始める”初めてProxerを使う場合は、次の手順で公開サーバーを1つ起動し、ローカルサービスを1つ公開します。
-
公開サーバーを起動する
公開トラフィックを受けるマシンでProxerを実行します。
proxer server --listen 0.0.0.0:8080 --domain your-server.example.com --token dev-tokenこのサーバーは同じポートで公開リクエストとトンネル制御接続を処理します。
-
ローカルアプリを起動する
クライアントマシンでHTTPサービスを起動します。次の例ではPythonの組み込みサーバーを使います。
python3 -m http.server 3000 --bind 127.0.0.1 -
ルートドメインのトンネルを接続する
--subdomainを省略すると、ルートドメインの経路として登録されます。proxer http 3000 \--server ws://your-server.example.com:8080 \--token dev-token -
ルート経路をテストする
curl -H 'Host: your-server.example.com' http://your-server.example.com:8080/ -
サブドメイン経路を使う
名前付きの経路が必要な場合は
--subdomainを指定します。proxer http 3000 \--server ws://your-server.example.com:8080 \--subdomain demo \--token dev-tokencurl -H 'Host: demo.your-server.example.com' http://your-server.example.com:8080/
次に読むもの
Section titled “次に読むもの”トンネルが動いたら、次のガイドを見てみましょう。
- 仕組み — 制御接続とリクエストの流れを理解する
- ルーティングと信頼済みプロキシ — ルートドメイン、サブドメイン、reverse proxyを設定する
- Docker — OCIイメージで公開サーバーを実行する
- proxer server — サーバーコマンドのリファレンス
- proxer http — トンネルクライアントのリファレンス