Chisel

Chiselは、HTTP上で転送され、SSHで保護される高速なTCP/UDPトンネルです。クライアントとサーバーの両方を含む単一の実行ファイルです。Go（golang）で書かれています。Chiselは主にファイアウォールを通過するのに役立ちますが、ネットワークへの安全なエンドポイントを提供するためにも使用できます。

目次

• 特徴
• インストール
• デモ
• 使用方法
• 貢献
• 変更履歴
• ライセンス

特徴

• 使いやすい
• 高性能*
• SSHプロトコル（crypto/ssh経由）を使用した暗号化接続
• 認証接続; ユーザー設定ファイルによる認証済みクライアント接続、フィンガープリントマッチングによる認証済みサーバー接続。
• クライアントは指数バックオフで自動再接続します（--min/max-retry-intervalで調整可能）; キープアライブpingはタイムアウトするため、静かに切断された接続（スリープ/ウェイク、NATタイムアウト、サーバー再起動）が検出され、再確立されます
• クライアントは1つのTCP接続上に複数のトンネルエンドポイントを作成できます
• クライアントはオプションでSOCKSまたはHTTP CONNECTプロキシを通過できます
• リバースポートフォワーディング（接続はサーバーを通過してクライアントから出ます）
• サーバーはオプションでリバースプロキシとしても機能します
• サーバーはオプションでSOCKS5接続を許可します（以下のガイドを参照）
• クライアントはオプションでリバースポートフォワードからのSOCKS5接続を許可します
• ssh -o ProxyCommandをサポートするstdio上のクライアント接続。HTTP上でSSHを提供します

インストール

バイナリ

最新リリースを参照するか、curl https://i.jpillora.com/chisel! | bashで今すぐダウンロードしてインストールしてください。

バイナリは最新のGoリリースでビルドされており、最小OSバージョンは次のとおりです: Windows 10 / Server 2016、macOS 12、Linuxカーネル3.2、FreeBSD 12.2。古いシステム（例: Windows 7）の場合は、リリースv1.8.1以前を使用してください。

Docker

```sh docker run --rm -it jpillora/chisel --help

イメージはマルチアーキテクチャ対応で、Docker Hub（`jpillora/chisel`）とGitHub Container Registry（`ghcr.io/jpillora/chisel`）の両方に公開されています。

### Fedora

このパッケージはFedoraコミュニティによってメンテナンスされています。RPMの使用に関連する問題が発生した場合は、この[issueトラッカー](https://bugzilla.redhat.com/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&classification=Fedora&component=chisel&list_id=11614537&product=Fedora&product=Fedora%20EPEL)を使用してください。```sh
sudo dnf -y install chisel

ソース```sh

$ go install github.com/jpillora/chisel@latest

## デモ

数分で独自のデモサーバーを実行できます（旧HerokuデモはHerokuの無料枠の廃止に伴い終了しました）。[`example/fly.toml`](https://github.com/jpillora/chisel/blob/master/example/fly.toml) は、この `chisel server` を [fly.io](https://fly.io) の無料枠にデプロイします：```sh
$ chisel server --port $PORT --backend http://example.com
# listens on $PORT, proxies normal web requests to http://example.com

Deploy it with fly launch --copy-config from the example/ directory, then tunnel to any service running beside the server, e.g.:```sh $ chisel client https://.fly.dev 3000

connects to your chisel server,

tunnels your localhost:3000 to the server's localhost:3000

ブラウザでアプリのURLにアクセスすると、サーバーのデフォルトのバックエンドプロキシに到達し、[example.com](http://example.com) のコピーが表示されます。

## 使用方法

<!-- これらのヘルプテキストは手動でレンダリングするか、
  https://github.com/jpillora/md-tmpl を使用してください
    $ md-tmpl -w README.md で実行します -->

<!--tmpl,code=plain:echo "$ chisel --help" && go run main.go --help | sed 's#0.0.0-src (go1\..*)#X.Y.Z#' -->``` plain 
$ chisel --help

  Usage: chisel [command] [--help]

  Version: X.Y.Z

  Commands:
    server - runs chisel in server mode
    client - runs chisel in client mode

  Read more:
    https://github.com/jpillora/chisel

``` plain

$ chisel server --help

Usage: chisel server [options]

Options:

--host, Defines the HTTP listening host – the network interface
(defaults the environment variable HOST and falls back to 0.0.0.0).

--port, -p, Defines the HTTP listening port (defaults to the environment
variable PORT and falls back to port 8080).

--key, (deprecated use --keygen and --keyfile instead)
An optional string to seed the generation of a ECDSA public
and private key pair. All communications will be secured using this
key pair. Share the subsequent fingerprint with clients to enable detection
of man-in-the-middle attacks (defaults to the CHISEL_KEY environment
variable, otherwise a new key is generate each run).

--keygen, A path to write a newly generated PEM-encoded SSH private key file.
If users depend on your --key fingerprint, you may also include your --key to
output your existing key. Use - (dash) to output the generated key to stdout.

--keyfile, An optional path to a PEM-encoded SSH private key. When
this flag is set, the --key option is ignored, and the provided private key
is used to secure all communications. (defaults to the CHISEL_KEY_FILE
environment variable). Since ECDSA keys are short, you may also set keyfile
to the inline key string itself, exactly as printed by --keygen (a base64
string with a "ck-" prefix); no extra base64 encoding is needed.

--authfile, An optional path to a users.json file. This file should
be an object with users defined like:
  {
    "<user:pass>": ["<addr-regex>","<addr-regex>"]
  }
when <user> connects, their <pass> will be verified and then
each of the remote addresses will be compared against the list
of address regular expressions for a match. Patterns are NOT
anchored by default: "10.0.0.1:80" also matches
"210.0.0.1:8080", and "." matches any character. Anchor your
patterns, e.g. "^10\.0\.0\.1:80$". The empty string ""
matches every address. Addresses will
always come in the form "<remote-host>:<remote-port>" for normal remotes,
"R:<local-interface>:<local-port>" for reverse port forwarding
remotes, and "socks" for SOCKS5 proxy access. Note that SOCKS5
access previously bypassed this list; existing authfiles which
should allow SOCKS5 must add an entry matching "socks" (the
empty wildcard "" matches everything, including "socks"). This
file will be automatically reloaded on change. Reloads apply
to new connections and to new tunnels of connected clients;
established tunnels are not interrupted.

--auth, An optional string representing a single user with full
access, in the form of <user:pass>. It is equivalent to creating an
authfile with {"<user:pass>": [""]}. If unset, it will use the
environment variable AUTH.

--keepalive, An optional keepalive interval. Since the underlying
transport is HTTP, in many instances we'll be traversing through
proxies, often these proxies will close idle connections. You must
specify a time with a unit, for example '5s' or '2m'. Defaults
to '25s' (set to 0s to disable).

--backend, Specifies another HTTP server to proxy requests to when
chisel receives a normal HTTP request. Useful for hiding chisel in
plain sight. --proxy is accepted as an alias for this flag.

--socks5, Allow clients to access the internal SOCKS5 proxy. See
chisel client --help for more information.

--reverse, Allow clients to specify reverse port forwarding remotes
in addition to normal remotes.