インストール

バージョン0.10.0の破壊的変更:

非watch実行オプションが削除されました。動的な設定リロードがデフォルトで有効になりました。
ログディレクトリの場所を指定する新しいlog-dirオプションが追加されました。
ログファイルがアクセスログとエラーログに分離されました。

ソースからのビルド

Gitリポジトリをクローンして、実行可能バイナリを自分でビルドできます。

# Gitリポジトリのクローン
% git clone https://github.com/junkurihara/rust-rpxy
% cd rust-rpxy

# サブモジュールの更新
% git submodule update --init

# ビルド
% cargo build --release

ビルド後、rust-rpxy/target/release/rpxyに実行可能バイナリが生成されます。

デフォルトではquinnを使用してQUICとHTTP/3が有効になっています。s2n-quicを使用したい場合は、以下のようにビルドしてください。追加の依存関係が必要になる場合があります。

% cargo build --no-default-features --features http3-s2n --release

Linux向けパッケージインストール (RPM/DEB)

rpxyのJenkins CI/CDビルドスクリプトは./.buildディレクトリにあります。

Linux RPMおよびDEBのビルド済みパッケージは、@Gamerboy59が提供するhttps://rpxy.gamerboy59.devで入手できます。

ビルド済みバイナリ

amd64 (x86_64) と arm64 (aarch64) 向けのビルド済みバイナリはGitHub Releasesで入手できます。ビルド済みバイナリの命名規則は以下の通りです。

rpxy-${ARCH}-unknown-linux-${TARGET}-${BUILD_OPT}.tar.gz

変数	説明
`${ARCH}`	`x86_64`または`aarch64`
`${TARGET}`	`gnu`または`musl`
`${BUILD_OPT}`	`s2n`: QUICライブラリとして`s2n-quic`を使用。
	`webpki-roots`: バックエンドアプリケーションとの接続用ルート証明書バンドルとして`WebPKI`を使用。

バックエンドアプリケーションに自己署名証明書を使用している場合は、webpki-roots以外のバイナリを選択する必要があります。

動的設定: バージョン0.10.0以降、rpxyは設定ファイルの変更を監視し、再起動なしで自動的に設定をリロードします。これがデフォルトの動作です。

一部の依存関係がまだ公開されていないため、現時点ではcrates.io経由のインストール（cargo install）オプションはありません。代替として、amd64環境では最も簡単な方法としてDockerイメージを使用できます（コンテナセクションを参照）。

はじめにコマンドラインオプション