增加 rust 与 bore 笔记

2025-12-15 18:27:48 +08:00 · 2022-04-21 18:57:43 +08:00
parent 5968189cd3
commit 1448da0af1
3 changed files with 114 additions and 0 deletions
--- a/rust/bore.md
+++ b/rust/bore.md
@@ -0,0 +1,73 @@
+---
+tags: #rust #network #bore
+---
+
+# [bore](https://github.com/ekzhang/bore)
+`Rust` 中的一个现代、简单的 `TCP` 隧道，它将本地端口暴露给远程服务器，绕过标准 `NAT` 。这就是它所做的一切：不多也不少。
+
+## 安装
+> 需要有rust环境，rust环境安装参照 [[install-rust]] 。
+```bash
+cargo install bore-cli
+```
+*安装的时候会从 `github` 拉 `crates.io-index` ，要上 `github` 啊，可恶，根本上不去。*
+
+
+## 服务端使用
+先在云服务器把防火墙打开想要开放的端口，以及开放 `bore` 的对外端口 `7835`。
+
+客户端是通过连接 `7835` 来进行握手，然后才从其它端口建立连接。
+
+然后直接运行 `bore server` 就可以开始监听了。
+```
+$ bore server
+2022-04-21T07:08:49.256539Z  INFO bore_cli::server: server listening addr=0.0.0.0:7835
+```
+
+
+## 客户端使用
+确认要映射的端口，服务端地址
+```
+$ bore local 22 --to hostname
+```
+直接这样连的话，端口是随机分配的，要指定端口需要使用 `--port <port>` 命令行参数。
+```
+$ bore local 22 --to jie65535.top --port 9022
+2022-04-21T09:11:39.835236Z  INFO bore_cli::client: connected to server remote_port=9022                              
+2022-04-21T09:11:39.835322Z  INFO bore_cli::client: listening at jie65535.top:9022
+```
+
+## 服务端帮助
+```
+bore-server 0.3.0
+Runs the remote proxy server
+
+USAGE:
+    bore server [OPTIONS]
+
+OPTIONS:
+    -h, --help                   Print help information
+        --min-port <MIN_PORT>    Minimum TCP port number to accept [default: 1024]
+    -s, --secret <SECRET>        Optional secret for authentication [env: BORE_SECRET]
+    -V, --version                Print version information
+```
+
+## 客户端帮助
+```
+bore-local 0.3.0
+Starts a local proxy to the remote server
+
+USAGE:
+    bore local [OPTIONS] --to <TO> <LOCAL_PORT>
+
+ARGS:
+    <LOCAL_PORT>    The local port to expose
+
+OPTIONS:
+    -h, --help                 Print help information
+    -l, --local-host <HOST>    The local host to expose [default: localhost]
+    -p, --port <PORT>          Optional port on the remote server to select [default: 0]
+    -s, --secret <SECRET>      Optional secret for authentication [env: BORE_SECRET]
+    -t, --to <TO>              Address of the remote server to expose local ports to
+    -V, --version              Print version information
+```