手动运行服务器¶

使用 `fastapi run` 命令¶

简而言之，使用 fastapi run 来运行你的 FastAPI 应用。

$ <font color="#4E9A06">fastapi</font> run <u style="text-decoration-style:solid">main.py</u>

  <span style="background-color:#009485"><font color="#D3D7CF"> FastAPI </font></span>  Starting production server 🚀

             Searching for package file structure from directories
             with <font color="#3465A4">__init__.py</font> files
             Importing from <font color="#75507B">/home/user/code/</font><font color="#AD7FA8">awesomeapp</font>

   <span style="background-color:#007166"><font color="#D3D7CF"> module </font></span>  🐍 main.py

     <span style="background-color:#007166"><font color="#D3D7CF"> code </font></span>  Importing the FastAPI app object from the module with
             the following code:

             <u style="text-decoration-style:solid">from </u><u style="text-decoration-style:solid"><b>main</b></u><u style="text-decoration-style:solid"> import </u><u style="text-decoration-style:solid"><b>app</b></u>

      <span style="background-color:#007166"><font color="#D3D7CF"> app </font></span>  Using import string: <font color="#3465A4">main:app</font>

   <span style="background-color:#007166"><font color="#D3D7CF"> server </font></span>  Server started at <font color="#729FCF"><u style="text-decoration-style:solid">http://0.0.0.0:8000</u></font>
   <span style="background-color:#007166"><font color="#D3D7CF"> server </font></span>  Documentation at <font color="#729FCF"><u style="text-decoration-style:solid">http://0.0.0.0:8000/docs</u></font>

             Logs:

     <span style="background-color:#007166"><font color="#D3D7CF"> INFO </font></span>  Started server process <b>[</b><font color="#34E2E2"><b>2306215</b></font><b>]</b>
     <span style="background-color:#007166"><font color="#D3D7CF"> INFO </font></span>  Waiting for application startup.
     <span style="background-color:#007166"><font color="#D3D7CF"> INFO </font></span>  Application startup complete.
     <span style="background-color:#007166"><font color="#D3D7CF"> INFO </font></span>  Uvicorn running on <font color="#729FCF"><u style="text-decoration-style:solid">http://0.0.0.0:8000</u></font> <b>(</b>Press CTRL+C
             to quit<b>)</b>

这在大多数情况下都适用。😎

例如，你可以使用该命令在容器、服务器等环境中启动你的 FastAPI 应用。

ASGI 服务器¶

让我们深入了解一下细节。

FastAPI 使用一种用于构建 Python Web 框架和服务器的标准，称为 ASGI。FastAPI 是一个 ASGI Web 框架。

要在远程服务器机器上运行 FastAPI 应用（或任何其他 ASGI 应用），你主要需要一个像 Uvicorn 这样的 ASGI 服务器程序，这也是 fastapi 命令默认使用的程序。

此外还有几种替代方案，包括：

Uvicorn：一个高性能的 ASGI 服务器。
Hypercorn：一个支持 HTTP/2、Trio 等功能的 ASGI 服务器。
Daphne：专为 Django Channels 构建的 ASGI 服务器。
Granian：一个用于 Python 应用的 Rust HTTP 服务器。
NGINX Unit：NGINX Unit 是一个轻量级且通用的 Web 应用运行时。

服务器机器与服务器程序¶

关于名称有一个小细节需要注意。💡

“服务器”（server）一词通常既指远程/云端计算机（物理机或虚拟机），也指在该机器上运行的程序（例如 Uvicorn）。

请记住，当你通读“服务器”一词时，它可能指代上述两种事物中的任意一种。

当指代远程机器时，通常称其为 服务器，也可以称为机器、VM（虚拟机）或节点。这些都指的是某种类型的远程机器，通常运行 Linux，用于运行你的程序。

安装服务器程序¶

当你安装 FastAPI 时，它附带了一个生产级服务器 Uvicorn，你可以使用 fastapi run 命令启动它。

但你也可以手动安装 ASGI 服务器。

确保你创建了一个虚拟环境，激活它，然后就可以安装服务器应用程序。

例如，安装 Uvicorn：

$ pip install "uvicorn[standard]"

---> 100%

类似的过程也适用于任何其他 ASGI 服务器程序。

提示

通过添加 standard，Uvicorn 将安装并使用一些推荐的额外依赖项。

其中包括 uvloop，这是 asyncio 的高性能直接替代品，它能提供显著的并发性能提升。

当你使用 pip install "fastapi[standard]" 安装 FastAPI 时，你也会得到 uvicorn[standard]。

运行服务器程序¶

如果你手动安装了 ASGI 服务器，通常需要以特定格式传递导入字符串，以便它能导入你的 FastAPI 应用。

$ uvicorn main:app --host 0.0.0.0 --port 80

<span style="color: green;">INFO</span>:     Uvicorn running on http://0.0.0.0:80 (Press CTRL+C to quit)

注意

命令 uvicorn main:app 指的是：

main：文件 main.py（Python “模块”）。
app：在 main.py 内部通过 app = FastAPI() 创建的对象。

这等同于：

from main import app

每个其他的 ASGI 服务器程序都有类似的命令，你可以在它们各自的文档中阅读更多内容。

警告

Uvicorn 和其他服务器支持一个 --reload 选项，这在开发过程中很有用。

--reload 选项会消耗更多的资源，且更不稳定等。

它在开发过程中非常有帮助，但你 不应该 在 生产环境 中使用它。

部署概念¶

这些示例运行服务器程序（例如 Uvicorn），启动 单个进程，监听所有 IP（0.0.0.0）上的预定义端口（例如 80）。

这是基本概念。但你可能还需要处理其他一些事项，例如：

安全性 - HTTPS
启动时运行
重启
复制（运行的进程数量）
内存
启动前的准备步骤

我将在接下来的章节中告诉你关于这些概念的更多信息、如何思考它们，以及处理它们的一些具体策略示例。🚀