例如，可以通过以下方式清理一个月前的所有文件

$ asfa clean --older 1month
$ asfa clean --older 1M

可以通过以下方式列出过去五分钟内上传的所有文件

$ asfa list --newer 5min
$ asfa list --newer 5m

重命名已上传文件

可以通过 rename 命令（缩写 mv）在事后重命名上传的文件。远程文件可以通过索引（由 list 返回）或指定要重命名的本地文件来指定。

$ asfa rename -1 foobar
┌┤Renaming:├────────────────────────────────────────────────────────────────────────┐
│ my-very-specific-file-2.txt → https://breitwieser.eu/asfa/6x-SVlgRJn39wpsV/foobar │
└───────────────────────────────────────────────────────────────────────────────────┘

安装

cargo

$ cargo install asfa

AUR

以下AUR软件包提供

• asfa：从源构建的最新稳定版本。
• asfa-bin 针对目标 x86_64-unknown-linux-gnu 的预构建二进制文件。
• asfa-git 当前开发快照，从源代码构建。

或者使用您喜欢的AUR助手或手动安装

$ cd <temporary folder>
$ curl -o PKGBUILD https://aur.archlinux.org/cgit/aur.git/plain/PKGBUILD?h=asfa-git
$ makepkg
[...]
==> Finished making: asfa-git 0.7.2.r16.g763f726-1 (Sun 07 Feb 2021 04:18:12 PM CET)
$ sudo pacman -U asfa-git-0.7.2.r16.g763f726-1-x86_64.pkg.tar.zst

从源代码

$ git clone https://github.com/obreitwi/asfa.git
$ cargo install --path asfa

配置

配置位于 ~/.config/asfa/config.yaml。针对特定主机的配置也可以拆分为位于 ~/.config/asfa/hosts/<别名>.yaml 下的单个文件。

系统范围的配置可以放在 /etc/asfa 中，文件夹结构相同。

示例配置可以在 ./example-config 中找到。在此，我们假设您的服务器可以通过 https://my-domain.eu 访问，并且文件夹 /var/wwww/default/asfa 将在 https://my-domain.eu/asfa 上提供。

asfa 方面

一个完整注释的示例配置可以在 这里 找到。

最小化（单文件）: ~/.config/asfa/hosts/my-remote-site.yaml

hostname: my-hostname.eu  # if not specified, will defaulted from ssh or filename
folder: /var/www/default/asfa
url: https://my-domain.eu/asfa
group: www-data

完整（单文件）: ~/.config/asfa/config.yaml

default_host: my-remote-site
details: true  # optional, acts as if --details is given
prefix_length: 32
verify_via_hash: true
auth:
  interactive: true
  use_agent: true
hosts:
  my-remote-site:
    # note: port is optional, will be inferred form ssh and defaults to 22
    hostname: my-hostname.eu:22
    folder: /var/www/default/asfa
    url: https://my-domain.eu/asfa
    group: www-data
    auth:
      interactive: false
      use_agent: true
      private_key_file: /path/to/private/key/in/pem/format #optional

Web 服务器

无论您使用哪个 Web 服务器，您都必须确保满足以下要求

• 上传文件的用户需要对其配置的 文件夹 具有写权限。
• 您的 Web 服务器需要在 url 上提供 文件夹。
• 如果您不希望上传的数据对所有人可读，请将 group 设置为您的 Web 服务器所在的组。
• 确保您的 Web 服务器不会提供 文件夹 的索引，否则任何访客都可以很容易地看到所有上传的文件。

Apache

您的 Apache 配置可以非常简单

<Directory /var/www/default/asfa>
  Options None
  allow from all
</Directory>

确保 Options 不包含 Indexes，否则任何访客都可以非常容易地访问所有上传的文件！

nginx

location /asfa {
  autoindex off
}

背景

由于我主要通过 ssh 在远程服务器上处理电子邮件（向 neomutt、OfflineIMAP 和 msmtp 致敬），我需要一个快速简单的方法将文件附加到电子邮件中。由于电子邮件附件是不受欢迎的，我不想简单地将文件复制到远程站点以附加它们。此外，我经常需要在我们的小组内部 mattermost 或其他任何基于文本的通信方式上共享生成的文件（如图表或日志文件）。理想情况下，我希望从终端中我正在的文件夹中这样做——而不是从浏览器的“文件打开”菜单中导航回它…

作为编写 rust 的一个小练习（除了 Advent of Code），我将我使用了几年的一个小 python 脚本 移植过来。

出于 安全原因，我将我的 gpg-agent（作为 ssh-agent 行动）设置为在连接到远程服务器时 确认 每次使用，之前的破解需要三个连接（和确认）来完成其任务。asfa 被设置为每次调用只使用一个 ssh 连接。

许可

许可协议为以下之一

• Apache许可证，版本2.0（LICENSE-APACHE或http://www.apache.org/licenses/LICENSE-2.0）
• MIT许可证（《LICENSE-MIT》或http://opensource.org/licenses/MIT）

由您选择。