ombrac

オンブラック

Ombrac は、クライアントとサーバー間の安全な通信のために設計された、高性能の Rust ベースの TCP トンネリング ソリューションです。

特徴

• オプションでSOCKSを通過します
• 暗号化は QUIC の組み込み TLS レイヤーによって保証されます
• 双方向ストリームによるQUIC多重化を採用し、効率的な伝送を実現

建築

Ombrac は 3 つの主要な箱で構成されています

• ombrac : トンネルプロトコルを実装するコアライブラリ
• ombrac-client : Ombrac クライアントの実装
• ombrac-server : Ombrac サーバーの実装
• ombrac-macros : Ombrac マクロの実装
• ombrac-transport : Ombrac トランスポートの実装

インストール

バイナリリリースから

リリース ページから最新リリースをダウンロードします。

ソースから

cargo build --bin ombrac-client --bin ombrac-server --features binary

注: Linux システムでは、暗号化操作にaws-lc-rs使用されます。これらのシステムでは、インストールのために AC コンパイラと CMake が必要になる場合があります。

クイックスタート

サーバーセットアップ

ombrac-server --listen " [::]:443 " --tls-cert " ./cert.pem " --tls-key " ./key.pem "

提供された TLS 証明書と暗号化通信用のキーを使用して、ポート 443 でリッスンする Ombrac サーバーを起動します。

クライアントセットアップ

ombrac-client --socks " 127.0.0.1:1080 " --server-address " example.com:443 "

SOCKS5 サーバーを 127.0.0.1:1080 にセットアップし、トラフィックを example.com:443 に転送します。

自己署名証明書を使用する場合、クライアントは--server-nameパラメーターと--tls-certパスの両方を明示的に構成する必要があります。

使用法

サーバ

Usage: ombrac-server [OPTIONS] --listen < ADDR > --tls-cert < FILE > --tls-key < FILE >

Options:
  -h, --help     Print help
  -V, --version  Print version

Transport QUIC:
      --listen < ADDR >
          Transport server listening address
      --tls-cert < FILE >
          Path to the TLS certificate file for secure connections
      --tls-key < FILE >
          Path to the TLS private key file for secure connections
      --congestion-initial-window < NUM >
          Initial congestion window in bytes
      --max-idle-timeout < TIME >
          Connection idle timeout in millisecond
      --max-keep-alive-period < TIME >
          Connection keep alive period in millisecond
      --max-open-bidirectional-streams < NUM >
          Connection max open bidirectional streams

Logging:
      --tracing-level < TRACE >  Logging level e.g., INFO, WARN, ERROR [default: WARN]

クライアント

Usage: ombrac-client [OPTIONS] --server-address < ADDR >

Options:
  -h, --help     Print help
  -V, --version  Print version

Endpoint SOCKS:
      --socks < ADDR >  Listening address for the SOCKS server [default: 127.0.0.1:1080]

Transport QUIC:
      --bind < ADDR >
          Bind address
      --server-name < STR >
          Name of the server to connect
      --server-address < ADDR >
          Address of the server to connect
      --tls-cert < FILE >
          Path to the TLS certificate file for secure connections
      --congestion-initial-window < NUM >
          Initial congestion window in bytes
      --max-idle-timeout < TIME >
          Connection idle timeout in millisecond
      --max-keep-alive-period < TIME >
          Connection keep alive period in millisecond
      --max-open-bidirectional-streams < NUM >
          Connection max open bidirectional streams

Logging:
      --tracing-level < TRACE >  Logging level e.g., INFO, WARN, ERROR [default: WARN]

貢献する

貢献は大歓迎です! Ombrac の改善に役立てるために、リポジトリをフォークしたり、問題を送信したり、プル リクエストを送信したりしてください。

ライセンス

このプロジェクトは、Apache-2.0 ライセンスに基づいてライセンスされています。