---
title: "How to use Django with Uvicorn"
version: 3.0
locale: zh-hans
source: https://docs.djangoproject.com/zh-hans/3.0/howto/deployment/asgi/uvicorn/
canonical: https://djangodocs.dev/zh-hans/3.0/howto/deployment/asgi/uvicorn/
---
# How to use Django with Uvicorn

[Uvicorn](https://www.uvicorn.org/) is an ASGI server based on `uvloop` and `httptools`, with an
emphasis on speed.

## Installing Uvicorn

You can install Uvicorn with `pip`:

```bash
python -m pip install uvicorn
```

## Running Django in Uvicorn

When Uvicorn is installed, a `uvicorn` command is available which runs ASGI
applications. Uvicorn needs to be called with the location of a module
containing a ASGI application object, followed by what the application is
called (separated by a colon).

For a typical Django project, invoking Uvicorn would look like:

```bash
uvicorn myproject.asgi:application
```

它将开启一个进程，监听 `127.0.0.1:8000`。这需要你的项目位于 Python path 上。为了确保这点，你应该在与 `manage.py` 文件相同的路径中运行这个命令。

For more advanced usage, please read the [Uvicorn documentation](https://www.uvicorn.org/).