传送器

传送器是一个类似于 netcat 的小型实用工具，用于快速从点A发送文件到点B。它比 netcat 更方便，因为您不需要为要传输的每个文件运行单独的命令来进行文件重定向。

传送器允许您传递目标地址和要发送的文件列表，并在接收端创建具有正确文件名的文件。每个传送器二进制文件都可以作为客户端或服务器使用，因此无需移动多个软件包。

传送器可以递归地复制、覆盖、重命名并保留目标文件的备份。

传送器现在使用 xxHash3 哈希算法进行增量文件传输，对于要覆盖的文件，不仅对整个文件进行哈希，还将文件分成多个较小的块。

传送器实现以传输文件为目的的协议称为 Teleport，并在 PROTOCOL.md 中定义。

使用方法

接收文件

要启动传送器作为服务器（接收）模式，只需运行

teleporter listen

传送器默认监听 0.0.0.0:9001 以接收连接。

以下是一些接收文件的附加选项

Usage: teleporter listen [OPTIONS]

Options:
      --allow-dangerous-filepath  Allow absolute and relative file paths for transfers (server only)
                                  [WARNING: potentially dangerous option, use at your own risk!]
  -m, --must-encrypt              Require encryption for incoming connections to the server
  -p, --port <PORT>               Port to listen on [default: 9001]
  -h, --help                      Print help

发送文件

要启动传送器作为客户端（发送）模式，运行

teleporter send [-d <destination>] -i <file> [[file2] [file3] ...]

以下是一些发送文件的附加参数

Usage: teleporter send [OPTIONS]

Options:
  -i, --input [<INPUT>...]  List of filepaths to files that will be teleported
  -d, --dest <DEST>         Destination teleporter host [default: localhost]
  -p, --port <PORT>         Destination teleporter port [default: 9001]
  -o, --overwrite           Overwrite remote file
  -r, --recursive           Recurse into directories on send
  -e, --encrypt             Encrypt the file transfer using ECDH key-exchange and random keys
  -n, --no-delta            Disable delta transfer (overwrite will transfer entire file)
  -k, --keep-path           Keep path info (recreate directory path on remote server)
  -b, --backup              Backup the destination file to a ".bak" extension if it exists 
                            and is being overwritten (consecutive runs will replace the *.bak file)
  -f, --filename-append     If the destination file exists, append a ".1"(or next available number)
                            to the filename instead of overwriting
  -h, --help                Print help

传送器将传输包含名称信息和文件权限的文件。除非启用-k选项，否则所有文件路径信息都将丢失。所有接收到的文件都将写入CWD（服务器启动的目录）中，除非服务器是用--allow-dangerous-filepath选项启动的。当使用-o选项覆盖文件时，可以使用额外的修饰符，例如-b来备份原始文件，或-n来禁用增量文件传输并始终覆盖整个文件。

扫描传送器实例

要使传送器扫描本地网络中任何可到达的传送器实例，请运行

teleporter scan

这将遍历所有网络设备（除了环回设备！）并尝试定位任何监听特定端口的传送器服务器。如果有服务器被发现，它将报告它们的版本。此功能仅在传送器v0.10.7及以上版本中可用。

以下是扫描的附加参数

Scan all network devices for any reachable Teleport listeners

Usage: teleporter scan [OPTIONS]

Options:
  -p, --port <PORT>  Port to scan for [default: 9001]
  -h, --help         Print help

重命名/复制到

传送器现在可以通过:运算符设置远程文件位置或文件重命名。类似于Docker如何允许快速挂载目录位置，传送器将首先尝试通过完整路径打开文件，如果该文件不存在，它将检查文件名中是否有任何冒号（:）。如果有，它将分割文件路径并尝试打开名称的第一部分。如果成功，传送器假设这是一个重命名/复制到操作。传送器还需要-k选项，以保留文件路径信息。否则，只有文件名将更改。

例如，给定以下命令

./teleporter -i ~/Downloads/ubuntu-20.04.3-live-server-arm64.iso:/tmp/ubuntu.iso -k

（假设服务器是用--allow-dangerous-filepath启动的），传送器将首先尝试打开~/Downloads/ubuntu-20.04.3-live-server-arm64.iso:/tmp/ubuntu.iso，如果失败，它将尝试在:处分割路径并打开~/Downloads/ubuntu-20.04.3-live-server-arm64.iso。如果成功，那么它知道这是一个重命名/复制到操作，并将目标文件路径设置为字符串的第二部分：/tmp/ubuntu.iso。在服务器上，它只会接收/tmp/ubuntu.iso的文件。如果省略了-k参数，服务器只会收到重命名为ubuntu.iso的原始文件。

安装

如果您已安装Rust和Cargo，可以通过运行以下命令快速编译和安装传送器

cargo install --locked teleporter

这将安装传送器到~/.cargo/bin/teleporter，可能需要将其添加到shell的PATH变量中。

示例输出

服务器（从2个不同的客户端接收）

$ teleporter
Teleporter Server 0.6.0 listening for connections on 0.0.0.0:9001
Receiving: ["archlinux-2021.11.01-x86_64.iso", "ubuntu-20.04.3-live-server-arm64.iso"] => Received file: "archlinux-2021.11.01-x86_64.iso" (from: 127.0.0.1:54708 v[0, 6, 0]) (17.67s @ 398.270 Mbps)
Receiving: ["ubuntu-20.04.3-live-server-arm64.iso", "ArchLinuxARM-aarch64-latest.tar"] => Received file: "ubuntu-20.04.3-live-server-arm64.iso" (from: 127.0.0.1:54709 v[0, 6, 0]) (24.55s @ 390.689 Mbps)
Receiving: ["ArchLinuxARM-aarch64-latest.tar", "laughing_man_by_geno.jpg"] => Received file: "laughing_man_by_geno.jpg" (from: 127.0.0.1:54713 v[0, 6, 0]) (952.46µs @ inf Mbps)
Receiving: ["ArchLinuxARM-aarch64-latest.tar", "unnamed.jpg"] => Received file: "unnamed.jpg" (from: 127.0.0.1:54714 v[0, 6, 0]) (832.04µs @ inf Mbps)
Receiving: ["ArchLinuxARM-aarch64-latest.tar"] => Received file: "ArchLinuxARM-aarch64-latest.tar" (from: 127.0.0.1:54712 v[0, 6, 0]) (27.57s @ 388.182 Mbps)
Receiving: []

客户端（发送）

$ teleporter -i ~/Downloads/*iso ~/Downloads/ArchLinuxARM-aarch64-latest.tar ~/Downloads/*jpg
Teleporter Client 0.6.0
Sending file 1/5: archlinux-2021.11.01-x86_64.iso
 =>  846.324M of  846.324M (100.00%) done! Time: 17.63s Speed: 398.270 Mbps
Sending file 2/5: ubuntu-20.04.3-live-server-arm64.iso
 =>    1.145G of    1.145G (100.00%) done! Time: 24.51s Speed: 390.689 Mbps
Sending file 3/5: ArchLinuxARM-aarch64-latest.tar
 =>    1.279G of    1.279G (100.00%) done! Time: 27.54s Speed: 388.182 Mbps
Sending file 4/5: laughing_man_by_geno.jpg
 =>   19.230K of   19.230K (100.00%) done! Time: 1.15ms Speed: inf Mbps
Sending file 5/5: unnamed.jpg
 =>   16.374K of   16.374K (100.00%) done! Time: 834.29µs Speed: inf Mbps