# 使用 Homebrew, Nix, winget 安装 filen-cli

查看 filen-cli 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:filen-cli
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install filen-cli
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#filen-cli
```

  证据: nixpkgs package indexes: pkgs/by-name/fi/filen-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

### Windows

- winget (92%):

```sh
winget install --id FilenCloud.Filen-cli -e
```

  证据: Windows Package Manager source index: FilenCloud.Filen-cli from https://cdn.winget.microsoft.com/cache/source.msix

## 软件包事实

- **软件包键:** brew:filen-cli
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/filen-cli>
- **版本:** 0.0.34
- **来源摘要:** Interface with Filen, an end-to-end encrypted cloud storage service
- **主页:** <https://filen.io>
- **仓库:** <https://github.com/FilenCloudDienste/filen-cli>
- **上游文档:** <https://docs.filen.io/docs/cli>
- **许可证:** AGPL-3.0-or-later
- **源码归档:** <https://registry.npmjs.org/@filen/cli/-/cli-0.0.34.tgz>
- **最后更新:** 2026-06-15T10:20:16-04:00
- **已生成:** 2026-07-08T07:18:31+00:00

## 可执行文件

- filen (cli)
- filen (别名)

## 依赖

- node

## 构建依赖

- pkgconf

## 安装行为

- post-install 钩子: 未定义
- Bottle: 可用 于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, sonoma, ventura, x86_64_linux

## 版本和新鲜度

- 页面生成时间: 2026-07-08
- 管理器版本: 0.0.34
- 管理器更新时间: 2026-06-15
- 本地数据: OK
- 上游仓库: https://filen.io
- 信息: Release/tag comparison is only available for GitHub repositories.
## 项目历史与用法

Filen CLI is the command-line companion for Filen's end-to-end encrypted cloud storage service, covering drive access, sync, WebDAV, S3 mirroring, and headless workflows.

For package users, it is the bridge between a consumer-facing encrypted storage service and scriptable Unix-style automation.

### 项目历史

The public Filen CLI repository was created in 2024 for Windows, macOS, and Linux. Its README describes a toolset for interacting with Filen Drive in stateless or interactive mode, syncing locations, mounting a network drive, and running WebDAV or S3 mirror servers.

The first public GitHub release, v0.0.1, was published in May 2024. Subsequent 0.0.x releases through 2024 iterated quickly on the CLI distribution.

The README now warns that this CLI is being sunset so the team can focus on a Rust rewrite in the filen-rs repository, citing startup performance, download size, and simpler future development as the reasons.

### 采用历史

Filen CLI's adoption is tied to Filen users who need automation beyond the desktop and web apps: headless servers, scripted sync jobs, container deployments, and protocol gateways.

Its distribution channels include official GitHub release binaries, a Linux/macOS install script, Docker images, npm, Homebrew, Nix, and winget, giving it a package-manager footprint beyond the Filen app itself.

The sunset notice makes the package historically transitional: useful and packaged, but expected to give way to the Rust CLI once that rewrite becomes the maintained path.

### 使用方式

Typical usage starts with authentication, producing local credential/auth files, then running commands for sync, drive access, WebDAV, S3, or update management.

Because Filen is encrypted cloud storage, the CLI is especially useful where users want private storage in automated jobs without using a graphical client.

The package exposes a `filen` executable, and the README points users to built-in help with `filen --help <cmd or topic>` plus official hosted CLI documentation.

### 为什么软件包爱好者会关心

Filen CLI is interesting to package maintainers because it packages a cloud-storage service client as a cross-platform CLI with release binaries, npm distribution, Docker images, and native package-manager entries.

It also shows a common lifecycle wrinkle: the packaged implementation can be official and useful while upstream already signals the next implementation line, in this case a Rust rewrite.

### 时间线

- 2024-04: Public filen-cli repository created.
- 2024-05: v0.0.1 GitHub release published.
- 2024-11: v0.0.20 tag committed in the early release line.
- 2025: Repository activity continues while README points users toward v0.0.36 as a supported CLI release.
- 2025: README announces sunsetting of this CLI in favor of a Rust rewrite under filen-rs.

### Related projects

- Filen CLI belongs to the Filen encrypted storage ecosystem and is related to Filen Drive, Filen desktop/mobile clients, WebDAV/S3 gateway workflows, Docker images, and the filen-rs Rust rewrite.
- It occupies a similar operational niche to cloud-storage CLIs such as rclone, but its scope is official access to Filen-specific encrypted storage.

### 来源

- <https://github.com/FilenCloudDienste/filen-cli>
- <https://github.com/FilenCloudDienste/filen-cli/releases>
- <https://github.com/FilenCloudDienste/filen-rs/tree/main/filen-cli>
- <https://docs.filen.io/docs/cli>
- <https://docs.filen.io/docs/cli/authenticating>
- <https://docs.filen.io/docs/cli/access-filen-drive>


## 安全说明

broad file, network, media, or database tool signal. infrastructure mutation or orchestration signal.

- **Geiger 风险:** orange / 中
- broad file, network, media, or database tool signal
- infrastructure mutation or orchestration signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Credential files

- Unix: ./.filen-cli-credentials, ./.filen-cli-auth-config
## 源数据库详情

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** filen-cli
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## 其他软件包管理器记录

- Nix - filen-cli: normalized package name match | nixpkgs package indexes: pkgs/by-name/fi/filen-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- winget - FilenCloud.Filen-cli: normalized package name match | Windows Package Manager source index: FilenCloud.Filen-cli from https://cdn.winget.microsoft.com/cache/source.msix


## 相关链接

- [Cloud CLI packages](https://www.automicvault.com/zh-hans/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family.
- [Secret-risk packages](https://www.automicvault.com/zh-hans/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/zh-hans/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/zh-hans/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [node](https://www.automicvault.com/zh-hans/pkg/brew/node/) - Runtime dependency declared by Homebrew.
- [pkgconf](https://www.automicvault.com/zh-hans/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [s4cmd](https://www.automicvault.com/zh-hans/pkg/brew/s4cmd/) - Shares av.db curated category or tags: cli, cloud-infrastructure, cloud-storage, s3, storage.
- [s5cmd](https://www.automicvault.com/zh-hans/pkg/brew/s5cmd/) - Shares av.db curated category or tags: cli, cloud-infrastructure, cloud-storage, s3, storage.
- [juicefs](https://www.automicvault.com/zh-hans/pkg/brew/juicefs/) - Shares av.db curated category or tags: cli, cloud-infrastructure, cloud-storage, s3, storage.
- [s3cmd](https://www.automicvault.com/zh-hans/pkg/brew/s3cmd/) - Shares av.db curated category or tags: cli, cloud-infrastructure, s3, storage, sync.
- [garage](https://www.automicvault.com/zh-hans/pkg/brew/garage/) - Shares av.db curated category or tags: cli, cloud-infrastructure, s3, storage.
- [gcsfuse](https://www.automicvault.com/zh-hans/pkg/brew/gcsfuse/) - Shares av.db curated category or tags: cli, cloud-infrastructure, cloud-storage, storage.
- [s3-backer](https://www.automicvault.com/zh-hans/pkg/brew/s3-backer/) - Shares av.db curated category or tags: cli, cloud-infrastructure, s3, storage.
- [s3fs](https://www.automicvault.com/zh-hans/pkg/brew/s3fs/) - Shares av.db curated category or tags: cli, cloud-infrastructure, s3, storage.

## Combined YAML source

View the package source record on GitHub. [combined/filen-cli.yml](https://github.com/automic-vault/db/blob/main/combined/filen-cli.yml)


## 来源

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph