
# 在 Linux 上面安装

你需要 Swift 5.9 或更高版本来使用 Vapor。你可以使用 Swift Server Workgroup 提供的 CLI 工具 [Swiftly](https://swiftlang.github.io/swiftly/) 来安装（推荐），也可以通过 [Swift.org](https://swift.org/download/) 上面的工具链来安装。

## 支持的发行版和版本

Vapor 支持的发行版的版本与 Swift 5.9 或更新版本支持的 Linux 发行版的版本相同。请参阅[官方支持页面](https://www.swift.org/platform-support/)查找有关官方支持的操作系统的最新信息。

不受官方支持的 Linux 发行版也可以通过编译源代码来运行 Swift，但是 Vapor 不能保证其稳定性。可以在 [Swift repo](https://github.com/apple/swift#getting-started) 学习更多关于编译 Swift 的信息。

## 安装 Swift

### 使用 Swiftly CLI 工具自动安装(推荐)

访问 [Swifty 网站](https://swiftlang.github.io/swiftly/)获取在Linux上安装 Swiftly 和 Swift 的说明。之后，使用以下命令安装 Swift:

#### 基本使用

```sh
$ swiftly install latest

Fetching the latest stable Swift release...
Installing Swift 5.9.1
Downloaded 488.5 MiB of 488.5 MiB
Extracting toolchain...
Swift 5.9.1 installed successfully!

$ swift --version

Swift version 5.9.1 (swift-5.9.1-RELEASE)
Target: x86_64-unknown-linux-gnu
```

### 使用 toolchain 手动安装

访问 Swift.org 的 [Using Downloads](https://swift.org/download/#using-downloads) 手册来学习如何在 Linux 安装 Swift。

### Fedora

Fedora 用户可以简单的通过下面的命令来安装 Swift：

```sh
sudo dnf install swift-lang
```

如果你正在使用 Fedora 35，你需要添加添加 EPEL 8 来获取 Swift 5.9 或更新的版本。


## Docker

你也可以使用预装了编译器的 Swift 官方 Docker 镜像，可以在 [Swift's Docker Hub](https://hub.docker.com/_/swift) 了解更多。

## 安装工具箱(Install Toolbox)

现在你已经安装了 Swift，让我们安装 [Vapor Toolbox](https://github.com/vapor/toolbox)。使用 Vapor 不是必须要使用此 CLI 工具，但它包含有用的实用程序。

在 Linux 系统上，你需要通过源码来编译 toolbox，在 Github 上查看 toolbox 的 <a href="https://github.com/vapor/toolbox/releases" target="_blank">releases</a> 来获取最新版本。

```sh
git clone https://github.com/vapor/toolbox.git
cd toolbox
git checkout <desired version>
make install
```

通过打印信息来再次确认是否已经安装成功。

```sh
vapor --help
```

你应该能看见可用命令的列表。

## 下一步

在你安装完 Swift 之后，通过 [开始 → 你好，世界](../getting-started/hello-world.md) 来学习创建你的第一个应用。
