手动运行服务器¶

使用 `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 使用一个名为 ASGI 的标准来构建 Python Web 框架和服务器。FastAPI 是一个 ASGI Web 框架。

在远程服务器机器上运行 FastAPI 应用程序（或任何其他 ASGI 应用程序）所需的主要组件是 ASGI 服务器程序，例如 Uvicorn，这是 fastapi 命令默认包含的。

有几种替代方案，包括：

Uvicorn：一个高性能的 ASGI 服务器。
Hypercorn：一个兼容 HTTP/2 和 Trio 等功能的 ASGI 服务器。
Daphne：为 Django Channels 构建的 ASGI 服务器。
Granian：一个用于 Python 应用程序的 Rust HTTP 服务器。
NGINX Unit：NGINX Unit 是一个轻量级且多功能的 Web 应用程序运行时。

服务器机器和服务器程序¶

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

“服务器”这个词通常用来指代远程/云计算机（物理或虚拟机器）以及在该机器上运行的程序（例如 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
启动时运行
重启
复制（运行的进程数量）
内存
启动前的准备步骤

在接下来的章节中，我将更详细地介绍每个概念，如何思考它们，以及一些具体的示例和处理策略。🚀