# 安装 Avenlith CLI

> 在 Linux、macOS 和 Windows 终端中管理服务器、网络与 Shield。

Source: https://docs.avenlith.com/zh/cli  
Category: 快速入门  
Last updated: 2026-09-22

## 安装

CLI 是一个独立的静态二进制文件。安装脚本会校验签名并将其放入 `PATH`：

```bash
# Linux and macOS
curl -fsSL https://get.avenlith.com/cli | sh

# Windows (PowerShell)
irm https://get.avenlith.com/cli.ps1 | iex

avenlith version
```

## 登录

`avenlith auth login` 会打开浏览器进行单点登录，并将短期令牌保存在系统钥匙串中。在没有浏览器的服务器上，请改用 API 令牌：`export AVENLITH_TOKEN=…`。

```bash
avenlith auth login            # opens the browser for single sign-on
avenlith project use production
avenlith server list --output table
```

## 配置档案

配置档案可让您在项目和默认区域之间切换，而无需重复输入参数：

```ini
# ~/.config/avenlith/config.toml
[profile.production]
project = "prj_4k2m9"
region  = "ist1"
output  = "table"
```

使用 `--profile production` 参数或 `AVENLITH_PROFILE` 环境变量选择档案。

## 输出格式

所有命令都支持 `--output table | json | yaml`。JSON 输出格式稳定，可放心在脚本中解析。

> **Note:** > CLI 会自动更新。运行 `avenlith update`，或在 CI 中设置 `AVENLITH_NO_UPDATE=1` 以固定版本。