注意：默认的 Send 主机由 @timvisee (信息) 提供。请考虑 捐赠 并帮助其运行。

ffsend

通过命令行轻松安全地共享文件和目录。一个 Send 客户端。

通过一个简单的命令，通过一个安全、私人和加密的链接在命令行中轻松安全地共享文件和目录。文件使用 Send 服务共享，大小可达 1GB。其他人可以使用此工具或通过他们的网络浏览器下载这些文件。

这里没有可见的演示？在 asciinema 上查看。

所有文件始终在客户端加密，机密信息永远不会与远程主机共享。可以指定一个可选的密码，默认文件有效期为 1（最多 20）次下载或 24 小时，以确保您的文件不会永远保留在线。这提供了一个安全平台来共享您的文件。有关安全性的更多信息，请 在此处 查找。

• 功能
• 用法
• 需求
• 安装 （Linux，macOS，Windows，FreeBSD，Android，其他操作系统/架构）
• 构建
• 配置和环境
• 安全
• 帮助
• 特别感谢
• 许可证

默认使用的公共 Send 服务由 @timvisee (信息) 提供。
此应用程序与 Firefox 或 Mozilla 没有任何关联。

注意：此工具目前处于测试阶段，因为一些额外期望的功能尚未实现

功能

• 功能齐全且友好的命令行工具
• 安全地上传和下载文件和目录，始终在客户端加密
• 额外的密码保护、生成和可配置的下载限制
• 文件和目录的归档和解压
• 内置的URL缩短器和二维码生成器
• 支持Send v3（当前）和v2
• 历史跟踪您的文件以方便管理
• 能够使用自己的Send主机
• 检查或删除共享文件
• 精确的错误报告
• 流加密和上传/下载，内存占用非常低
• 适用于无需交互的脚本

有关即将推出的功能和想法列表，请查看GitLab上的当前开放问题。

用法

轻松上传和下载

# Simple upload
$ ffsend upload my-file.txt
https://send.vis.ee/#sample-share-url

# Advanced upload
# - Specify a download limit of 1
# - Specify upload expiry time of 5 minutes
# - Enter a password to encrypt the file
# - Archive the file before uploading
# - Copy the shareable link to your clipboard
# - Open the shareable link in your browser
$ ffsend upload --downloads 1 --expiry-time 5m --password --archive --copy --open my-file.txt
Password: ******
https://send.vis.ee/#sample-share-url

# Upload to your own host
$ ffsend u -h https://example.com/ my-file.txt
https://example.com/#sample-share-url

# Simple download
$ ffsend download https://send.vis.ee/#sample-share-url

检查远程文件

# Check if a file exists
$ ffsend exists https://send.vis.ee/#sample-share-url
Exists: yes

# Fetch remote file info
$ ffsend info https://send.vis.ee/#sample-share-url
ID:         b087066715
Name:       my-file.txt
Size:       12 KiB
MIME:       text/plain
Downloads:  0 of 10
Expiry:     18h2m (64928s)

其他命令包括

# View your file history
$ ffsend history
#  LINK                                        EXPIRE
1  https://send.vis.ee/#sample-share-url  23h57m
2  https://send.vis.ee/#other-sample-url  17h38m
3  https://example.com/#sample-share-url       37m30s

# Change the password after uploading
$ ffsend password https://send.vis.ee/#sample-share-url
Password: ******

# Delete a file
$ ffsend delete https://send.vis.ee/#sample-share-url

使用--help标志，help子命令，或查看帮助部分以获取所有可用子命令。

需求

• Linux、macOS、Windows、FreeBSD、Android（其他BSD可能也适用）
• 终端 😎
• 互联网连接
• Linux
  • OpenSSL & CA证书
    • Ubuntu、Debian及其衍生版：apt install openssl ca-certificates
  • 可选：使用剪贴板支持的xclip或xsel
    • Ubuntu、Debian及其衍生版：apt install xclip
    • CentOS/Red Hat/openSUSE/Fedora：yum install xclip
    • Arch：pacman -S xclip
• Windows特定
  • 可选OpenSSL带有crypto-openssl功能：[安装程序](https://u.visee.me/dl/openssl/Win64OpenSSL_Light-1_1_0j.exe)（v1.1.0j或更高版本）
• macOS特定
  • 可选OpenSSL带有crypto-openssl功能：brew install [email protected]
• FreeBSD特定
  • OpenSSL：pkg install openssl
  • CA证书：pkg install ca_root_nss
  • 可选xclip & xsel用于剪贴板支持：pkg install xclip xsel-conrad
• Android特定
  • Termux：» Termux

安装

由于ffsend仍处于早期阶段，目前只有有限的安装选项。请随意贡献额外的包。

请确保您满足并安装要求。

请参阅以下特定操作系统的说明

• Linux
• macOS
• Windows
• FreeBSD
• Android
• 其他操作系统或架构

Linux（所有发行版）

如果支持，建议使用snap包。
或者您也可以使用预构建的二进制文件手动安装。

只提供64位（x86_64）包和二进制文件。对于其他架构和配置，您可以从源代码编译。

将很快提供更多包选项。

Linux：snap包

注意：ffsend的snap包是隔离的，并且只能访问您的家目录中的文件。如果您不想有这种限制，请选择不同的安装选项。

注意：由于默认配置的 snap，您可能无法在不进行手动修改的情况下，在某些环境中使用此包，例如通过SSH。如果您遇到问题，请参考其他安装方法，例如预编译的二进制文件，或打开一个问题。

» ffsend

snap install ffsend
ffsend --help

Linux: Arch AUR软件包

» ffsend-bin（预编译的二进制文件，最新版本，推荐使用）
» ffsend（从源码编译，最新版本）
» ffsend-git（从源码编译，最新master提交）

yay -S ffsend
# or
aurto add ffsend-bin
sudo pacman -S ffsend-bin
# or using any other AUR helper

ffsend --help

Linux: Nix软件包

注意：Nix软件包目前无法自动更新，可能稍显过时。

» ffsend

nix-channel --update
nix-env --install ffsend

ffsend --help

Linux: Fedora软件包

注意：Fedora软件包由贡献者维护，可能稍显过时。

» ffsend

sudo dnf install ffsend

ffsend --help

Linux: Alpine软件包

注意：Alpine软件包由贡献者维护，可能过时。如果缺少重要更新，请选择其他安装方法。

» ffsend

apk add ffsend --repository=http://dl-cdn.alpinelinux.org/alpine/edge/testing

ffsend --help

Linux: 预编译的二进制文件

查看Linux二进制文件的最新发布资源。
使用ffsend-v*-linux-x64-static二进制文件，以最大程度地减少问题发生的可能性。如果它尚未提供，您可以使用旧版本中的工件，直到它可用。

在继续之前，请确保满足并安装要求。

您必须使二进制文件可执行，并可能希望将其移动到/usr/bin以使其易于执行

# Rename binary to ffsend
mv ./ffsend-* ./ffsend

# Mark binary as executable
chmod a+x ./ffsend

# Move binary into path, to make it easily usable
sudo mv ./ffsend /usr/local/bin/

ffsend --help

macOS

建议使用homebrew软件包。
或者，您可以通过MacPorts安装它，或者手动使用预编译的二进制文件。

macOS: homebrew软件包

确保您已安装homebrew，并运行

brew install ffsend
ffsend --help

macOS: MacPorts

注意：MacPorts中的ffsend目前无法自动更新，可能稍显过时。

一旦您安装了MacPorts，您可以运行

sudo port selfupdate
sudo port install ffsend

macOS: Nix软件包

注意：Nix软件包目前无法自动更新，可能稍显过时。

nix-channel --update
nix-env --install ffsend

ffsend --help

macOS: 预编译的二进制文件

查看macOS二进制文件的最新发布资源。如果它尚未提供，您可以使用旧版本中的工件，直到它可用。

然后，将下载的二进制文件标记为可执行文件。然后，您可能希望将其移动到/usr/local/bin/，以便全局可用ffsend命令

# Rename file to ffsend
mv ./ffsend-* ./ffsend

# Mark binary as executable
chmod a+x ./ffsend

# Move binary into path, to make it easily usable
sudo mv ./ffsend /usr/local/bin/

ffsend

Windows

建议使用scoop软件包。
或者，您可以通过预编译的二进制文件手动安装它。

如果您正在使用Windows子系统中的Linux，强烈建议您安装预编译的Linux二进制文件。

仅提供64位（x86_64）的二进制文件。对于其他架构和配置，您可以从源代码编译。

将很快提供chocolatey软件包和.msi安装程序。

Windows: scoop软件包

请确保您已经安装了scoop，然后运行

scoop install ffsend
ffsend --help

Windows: 预编译的二进制文件

请查看最新版本的Windows二进制文件资源。使用ffsend-v*-windows-x64-static二进制文件，以最大程度地减少问题的可能性。如果它尚未提供，您可以使用之前的版本的工件，直到它可用。

您可以在同一目录下使用ffsend命令行。

.\ffsend.exe --help

要将它作为ffsend全局调用，您必须将二进制文件放入您的系统PATH中。最简单的解决方案是将它移动到System32

move .\ffsend.exe C:\Windows\System32\ffsend.exe

FreeBSD

» ffsend

注意：目前由FreeBSD贡献者维护FreeBSD软件包，可能略微过时。

# Precompiled binary.
pkg install ffsend

# Compiles and installs from source.
cd /usr/ports/www/ffsend && make install

Android

ffsend可以通过Termux在Android上使用，首先安装它：» Termux

注意：目前由Termux贡献者维护Android软件包，可能略微过时。

# Install package.
pkg install ffsend

ffsend help

其他操作系统或架构

如果您的系统运行Docker，您可以使用docker镜像。目前没有其他二进制文件或软件包可用。

您可以选择从源代码构建项目。

Docker镜像

有一个Docker镜像可用于在容器中运行ffsend。将目录挂载到/data，以便容器中的ffsend可以访问，并像通常一样使用命令。

» timvisee/ffsend

# Invoke without arguments
docker run --rm -it -v $(pwd):/data timvisee/ffsend

# Upload my-file.txt
docker run --rm -it -v $(pwd):/data timvisee/ffsend upload my-file.txt

# Download from specified link
docker run --rm -it -v $(pwd):/data timvisee/ffsend download https://send.vis.ee/#sample-share-url

# Show help
docker run --rm -it -v $(pwd):/data timvisee/ffsend help

# To update the used image
docker pull timvisee/ffsend

在Linux或macOS上，您可以在您的shell配置中定义别名，以便可以将其作为ffsend调用

alias ffsend='docker run --rm -it -v "$(pwd):/data" timvisee/ffsend'

注意：此实现仅限于通过指定的挂载访问您提供的路径。

构建

在继续之前，您必须满足以下要求来构建和安装ffsend

构建要求

• 运行时要求
• git
• rust v1.40或更高版本（使用rustup安装）
• OpenSSL或LibreSSL库/头文件
  • Linux
    • Ubuntu，Debian及其衍生品：apt install build-essential cmake pkg-config libssl-dev
    • CentOS/Red Hat/openSUSE：yum install gcc gcc-c++ make cmake openssl-devel
    • Arch：pacman -S openssl base-devel
    • Gentoo：emerge -a dev-util/pkgconfig dev-util/cmake dev-libs/openssl
    • Fedora：dnf install gcc gcc-c++ make cmake openssl-devel
    • 或查看这里的说明
  • Windows
    • 可选使用 crypto-openssl 功能：请参考以下说明 这里
  • macOS
    • 可选使用 crypto-openssl 功能：运行以下命令 brew install cmake pkg-config openssl 或查看说明 这里
  • FreeBSD
    • pkg install rust gmake pkgconf python36 libxcb xclip ca_root_nss xsel-conrad
    • 建议使用并修改现有的 ffsend 端口，它会为您管理依赖项。

# Defaults set of features with no-color, one of
cargo install --features no-color
cargo build --release --features no-color

# No default features, except required
cargo install --no-default-features --features send3,crypto-ring

# With history and clipboard support
cargo install --no-default--features --features send3,crypto-ring,history,clipboard

ffput my-file.txt
ffget https://send.vis.ee/#sample-share-url

ln -s $(which ffsend) ./ffput
ln -s $(which ffsend) ./ffget

# Stop on error
set -e

# Upload a file
# -I: no interaction
# -y: assume yes
# -q: quiet output, just return the share link
URL=$(ffsend -Iy upload -q my-file.txt)

# Render file information
# -I: no interaction
# -f: force, just show the info
ffsend -If info $URL

# Set a password for the uploaded file
ffsend -I password $URL --password="secret"

# Use the following flags automatically from now on
# -I: no interaction
# -f: force
# -y: yes
export FFSEND_NO_INTERACT=1 FFSEND_FORCE=1 FFSEND_YES=1

# Download the uploaded file, overwriting the local variant due to variables
ffsend download $URL --password="secret"

$ ffsend help

ffsend 0.2.72
Tim Visee <3[email protected]>
Easily and securely share files from the command line.
A fully featured Send client.

The default public Send host is provided by Tim Visee, @timvisee.
Please consider to donate and help keep it running: https://vis.ee/donate

USAGE:
    ffsend [FLAGS] [OPTIONS] [SUBCOMMAND]

FLAGS:
    -f, --force          Force the action, ignore warnings
    -h, --help           Prints help information
    -i, --incognito      Don't update local history for actions
    -I, --no-interact    Not interactive, do not prompt
    -q, --quiet          Produce output suitable for logging and automation
    -V, --version        Prints version information
    -v, --verbose        Enable verbose information and logging
    -y, --yes            Assume yes for prompts

OPTIONS:
    -A, --api <VERSION>                 Server API version to use, '-' to lookup [env: FFSEND_API]
        --basic-auth <USER:PASSWORD>    Protected proxy HTTP basic authentication credentials (not FxA) [env: FFSEND_BASIC_AUTH]
    -H, --history <FILE>                Use the specified history file [env: FFSEND_HISTORY]
    -t, --timeout <SECONDS>             Request timeout (0 to disable) [env: FFSEND_TIMEOUT]
    -T, --transfer-timeout <SECONDS>    Transfer timeout (0 to disable) [env: FFSEND_TRANSFER_TIMEOUT]

SUBCOMMANDS:
    upload        Upload files [aliases: u, up]
    download      Download files [aliases: d, down]
    debug         View debug information [aliases: dbg]
    delete        Delete a shared file [aliases: del, rm]
    exists        Check whether a remote file exists [aliases: e]
    generate      Generate assets [aliases: gen]
    help          Prints this message or the help of the given subcommand(s)
    history       View file history [aliases: h]
    info          Fetch info about a shared file [aliases: i]
    parameters    Change parameters of a shared file [aliases: params]
    password      Change the password of a shared file [aliases: pass, p]
    version       Determine the Send server version [aliases: v]

This application is not affiliated with Firefox or Mozilla.