{"id":1939,"date":"2024-04-29T09:15:28","date_gmt":"2024-04-29T01:15:28","guid":{"rendered":"http:\/\/blog.xtaa.cn\/?p=1939"},"modified":"2024-04-29T09:15:28","modified_gmt":"2024-04-29T01:15:28","slug":"%e8%bd%bb%e9%87%8f%e5%bf%ab%e9%80%9f%e7%9a%84-python-asgi-%e6%a1%86%e6%9e%b6-uvicorn","status":"publish","type":"post","link":"http:\/\/blog.xtaa.cn\/index.php\/2024\/04\/29\/%e8%bd%bb%e9%87%8f%e5%bf%ab%e9%80%9f%e7%9a%84-python-asgi-%e6%a1%86%e6%9e%b6-uvicorn\/","title":{"rendered":"\u8f7b\u91cf\u5feb\u901f\u7684 Python ASGI \u6846\u67b6 uvicorn"},"content":{"rendered":"\n

\u4ec0\u4e48\u662f Uvicorn \uff1f<\/h3>\n\n\n\n
\n

\u7b54\uff1aUvicorn \u662f\u57fa\u4e8e uvloop \u548c httptools \u6784\u5efa\u7684\u975e\u5e38\u5feb\u901f\u7684 ASGI \u670d\u52a1\u5668\u3002<\/strong><\/p>\n<\/blockquote>\n\n\n\n

\u4ec0\u4e48\u662f uvloop \u548c httptools \uff1f<\/h3>\n\n\n\n
\n

\u7b54\uff1a uvloop \u7528\u4e8e\u66ff\u6362\u6807\u51c6\u5e93 asyncio \u4e2d\u7684\u4e8b\u4ef6\u5faa\u73af\uff0c\u4f7f\u7528 Cython \u5b9e\u73b0\uff0c\u5b83\u975e\u5e38\u5feb\uff0c\u53ef\u4ee5\u4f7f asyncio \u7684\u901f\u5ea6\u63d0\u9ad8 2-4 \u500d\u3002asyncio \u4e0d\u7528\u6211\u4ecb\u7ecd\u5427\uff0c\u5199\u5f02\u6b65\u4ee3\u7801\u79bb\u4e0d\u5f00\u5b83\u3002<\/strong><\/p>\n<\/blockquote>\n\n\n\n

\n

httptools \u662f nodejs HTTP \u89e3\u6790\u5668\u7684 Python \u5b9e\u73b0\u3002<\/strong><\/p>\n<\/blockquote>\n\n\n\n

\u4ec0\u4e48\u662f ASGI \u670d\u52a1\u5668\uff1f<\/h3>\n\n\n\n
\n

\u7b54\uff1a \u5f02\u6b65\u7f51\u5173\u534f\u8bae\u63a5\u53e3\uff0c\u4e00\u4e2a\u4ecb\u4e8e\u7f51\u7edc\u534f\u8bae\u670d\u52a1\u548c Python \u5e94\u7528\u4e4b\u95f4\u7684\u6807\u51c6\u63a5\u53e3\uff0c\u80fd\u591f\u5904\u7406\u591a\u79cd\u901a\u7528\u7684\u534f\u8bae\u7c7b\u578b\uff0c\u5305\u62ec HTTP\uff0cHTTP2 \u548c WebSocket\u3002<\/strong><\/p>\n<\/blockquote>\n\n\n\n

\u8bf7\u7b80\u5355\u4ecb\u7ecd\u4e0b Uvicorn<\/h3>\n\n\n\n
\n

\u7b54\uff1a\u76ee\u524d\uff0cPython \u4ecd\u7f3a\u4e4f\u5f02\u6b65\u7684\u7f51\u5173\u534f\u8bae\u63a5\u53e3\uff0cASGI \u7684\u51fa\u73b0\u586b\u8865\u4e86\u8fd9\u4e00\u7a7a\u767d\uff0c\u73b0\u5728\u5f00\u59cb\uff0c\u6211\u4eec\u80fd\u591f\u4f7f\u7528\u5171\u540c\u7684\u6807\u51c6\u4e3a\u6240\u6709\u7684\u5f02\u6b65\u6846\u67b6\u6765\u5b9e\u73b0\u4e00\u4e9b\u5de5\u5177\uff0cASGI \u5e2e\u52a9 Python \u5728 Web \u6846\u67b6\u4e0a\u548c Node.JS \u53ca Golang \u76f8\u7adf\u4e89\uff0c\u76ee\u6807\u662f\u83b7\u5f97\u9ad8\u6027\u80fd\u7684 IO \u5bc6\u96c6\u578b\u4efb\u52a1\uff0cASGI \u652f\u6301 HTTP2 \u548c WebSockets\uff0cWSGI \u662f\u4e0d\u652f\u6301\u7684\u3002<\/strong><\/p>\n<\/blockquote>\n\n\n\n

\n

Uvicorn \u76ee\u524d\u652f\u6301 HTTP1.1 \u548c WebSocket\uff0c\u8ba1\u5212\u652f\u6301 HTTP2\u3002<\/strong><\/p>\n<\/blockquote>\n\n\n\n

\u4f7f\u7528\u65b9\u6cd5\uff1a<\/h2>\n\n\n\n

<\/p>\n\n\n\n

$ pip install uvicorn\n<\/code><\/pre>\n\n\n\n
\u521b\u5efa\u4e00\u4e2a\u6587\u4ef6 example.py<\/h5>\n\n\n\n
<\/p>\n\n\n\n
async def app(scope, receive, send):\n    assert scope['type'] == 'http'\n    await send({\n        'type': 'http.response.start',\n        'status': 200,\n        'headers': [\n            [b'content-type', b'text\/plain'],\n        ]\n    })\n    await send({\n        'type': 'http.response.body',\n        'body': b'Hello, world!',\n    })\n<\/code><\/pre>\n\n\n\n
\u542f\u52a8 Uvicorn<\/h5>\n\n\n\n
<\/p>\n\n\n\n
$ uvicorn example:app\n<\/code><\/pre>\n\n\n\n
\u4f60\u4e5f\u53ef\u4ee5\u4e0d\u4f7f\u7528\u547d\u4ee4\u884c\uff0c\u76f4\u63a5\u8fd0\u884c\u4f60\u7684\u811a\u672c\u4e5f\u662f\u53ef\u4ee5\u7684\uff0c\u5982\u4e0b\uff1a<\/h5>\n\n\n\n
<\/p>\n\n\n\n
import uvicorn\n\nasync def app(scope, receive, send):\n    ...\n\nif __name__ == \"__main__\":\n    uvicorn.run(\"example:app\", host=\"127.0.0.1\", port=5000, log_level=\"info\")\n<\/code><\/pre>\n\n\n\n
\n\n\n\n
\n\n\n\n
\n\n\n\n
FastAPI\u4f7f\u7528uvicorn<\/h2>\n\n\n\n
<\/p>\n\n\n\n
import uvicorn\nfrom fastapi import FastAPI\n \napp = FastAPI()\n \n@app.get(\"\/\")\nasync def root():\n    return {\"message\": \"Hello World\"}\n \nif __name__ == '__main__':\n    uvicorn.run(app=app)\n<\/code><\/pre>\n\n\n\n
\u6df1\u5165\u5230uvicorn.run()<\/code>\u65b9\u6cd5\u91cc\u9762\uff0c\u770b\u5230\u4e00\u4e2a\uff1a<\/h5>\n\n\n\n
<\/p>\n\n\n\n
def run(app, **kwargs):\n    config = Config(app, **kwargs)\n    server = Server(config=config)\n \n    if (config.reload or config.workers > 1) and not isinstance(app, str):\n        logger = logging.getLogger(\"uvicorn.error\")\n        logger.warn(\n            \"You must pass the application as an import string to enable 'reload' or 'workers'.\"\n        )\n        sys.exit(1)\n \n    if config.should_reload:\n        sock = config.bind_socket()\n        supervisor = StatReload(config, target=server.run, sockets=[sock])\n        supervisor.run()\n    elif config.workers > 1:\n        sock = config.bind_socket()\n        supervisor = Multiprocess(config, target=server.run, sockets=[sock])\n        supervisor.run()\n    else:\n        server.run()\n<\/code><\/pre>\n\n\n\n
\u518d\u6df1\u5165\u5230 config = Config(app, **kwargs)\u91cc\u9762\uff0c\u5c31\u770b\u5230\u4e00\u4e9b\u5f88\u591a\u7684\u76f8\u5173\u7684\u914d\u7f6e\u4fe1\u606f\u9879\uff1a<\/h5>\n\n\n\n
<\/p>\n\n\n\n
class Config:\n    def __init__(\n        self,\n        app,\n        host=\"127.0.0.1\",\n        port=8000,\n        uds=None,\n        fd=None,\n        loop=\"auto\",\n        http=\"auto\",\n        ws=\"auto\",\n        lifespan=\"auto\",\n        env_file=None,\n        log_config=LOGGING_CONFIG,\n        log_level=None,\n        access_log=True,\n        use_colors=None,\n        interface=\"auto\",\n        debug=False,\n        reload=False,\n        reload_dirs=None,\n        workers=None,\n        proxy_headers=True,\n        forwarded_allow_ips=None,\n        root_path=\"\",\n        limit_concurrency=None,\n        limit_max_requests=None,\n        backlog=2048,\n        timeout_keep_alive=5,\n        timeout_notify=30,\n        callback_notify=None,\n        ssl_keyfile=None,\n        ssl_certfile=None,\n        ssl_version=SSL_PROTOCOL_VERSION,\n        ssl_cert_reqs=ssl.CERT_NONE,\n        ssl_ca_certs=None,\n        ssl_ciphers=\"TLSv1\",\n        headers=None,\n    ):\n....\n<\/code><\/pre>\n\n\n\n
\u6240\u4ee5\u8fd8\u53ef\u4ee5\u6dfb\u52a0\u7684\u53c2\u6570\u53ef\u4ee5\u770b\u4e0a\u9762\u7684\u51e0\u4e2a\u914d\u7f6e\u7684\u9009\u9879\u7684\u4fe1\u606f\u6765\u586b\uff1a<\/h5>\n\n\n\n
\u4e8e\u662f\u4e4e\u8fd8\u53ef\u4ee5\u4fee\u6539\u4e3a\uff1a<\/h5>\n\n\n\n
<\/p>\n\n\n\n
uvicorn.run(app=app, host=\"127.0.0.1\", port=8000, reload=True, debug=True)\n<\/code><\/pre>\n\n\n\n
\u53d1\u73b0\u672c\u6765\u60f3\u70ed\u66f4\u65b0\u4ee3\u7801\uff0c\u7ed3\u679c\u5450\uff1f\u6709\u544a\u8b66\u4fe1\u606f\u63d0\u793a\uff1a<\/h5>\n\n\n\n
<\/p>\n\n\n\n
WARNING:  You must pass the application as an import string to enable 'reload' or 'workers'.\n<\/code><\/pre>\n\n\n\n
\u7ffb\u8bd1\u8fc7\u6765\u5c31\u662f\u8bf4\uff1a \u8b66\u544a\uff1a\u5fc5\u987b\u5c06\u5e94\u7528\u7a0b\u5e8f\u4f5c\u4e3a\u5bfc\u5165\u5b57\u7b26\u4e32\u4f20\u9012\uff0c\u624d\u80fd\u542f\u7528\u201c\u91cd\u65b0\u52a0\u8f7d\u201d \u7136\u540e\u5462\uff1a \u6211\u4fee\u6539\u4e3a\uff1a<\/h5>\n\n\n\n
<\/p>\n\n\n\n
  uvicorn.run(app='app', host=\"127.0.0.1\", port=8000, reload=True, debug=True)\n<\/code><\/pre>\n\n\n\n
\u53c8\u63d0\u793a\uff1a<\/h5>\n\n\n\n
<\/p>\n\n\n\n
ERROR:    Error loading ASGI app. Import string \"app\" must be in format \"<module>:<attribute>\".\n<\/code><\/pre>\n\n\n\n
\u597d\u5427\uff0c\u6211\u518d\u770b\u770b\u5b98\u65b9\u6587\u6863\u8bf4\u662f\uff1a<\/h5>\n\n\n\n
\u5728\u547d\u4ee4\u884c\u4e0b\u662f\u9700\u8981\uff1a\u6a21\u5757\u52a0app\u540d\u79f0\uff1a\u521a\u597d\u4e0a\u9762\u7684\u9519\u8bef\u63d0\u793a\u4e5f\u662f\u8bf4\u9700\u8981:<\/h5>\n\n\n\n
<\/p>\n\n\n\n
    uvicorn.run(app='main:app', host=\"127.0.0.1\", port=8000, reload=True, debug=True)\n<\/code><\/pre>\n\n\n\n
\u8fd9\u6837\u4e4b\u540e\u5c31\u53ef\u4ee5\u542f\u52a8\u70ed\u66f4\u65b0\u91cd\u542f\u670d\u52a1\u4e86\uff01<\/h5>\n\n\n\n
\u4f7f\u7528\u547d\u4ee4\u884c\u65f6\uff0c\u4f60\u53ef\u4ee5\u4f7f\u7528 uvicorn –help \u6765\u83b7\u53d6\u5e2e\u52a9\u3002<\/h2>\n\n\n\n
<\/p>\n\n\n\n
Usage: uvicorn [OPTIONS] APP\n\nOptions:\n  --host TEXT                     Bind socket to this host.  [default:\n                                  127.0.0.1]\n  --port INTEGER                  Bind socket to this port.  [default: 8000]\n  --uds TEXT                      Bind to a UNIX domain socket.\n  --fd INTEGER                    Bind to socket from this file descriptor.\n  --reload                        Enable auto-reload.\n  --reload-dir TEXT               Set reload directories explicitly, instead\n                                  of using the current working directory.\n  --workers INTEGER               Number of worker processes. Defaults to the\n                                  $WEB_CONCURRENCY environment variable if\n                                  available. Not valid with --reload.\n  --loop [auto|asyncio|uvloop|iocp]\n                                  Event loop implementation.  [default: auto]\n  --http [auto|h11|httptools]     HTTP protocol implementation.  [default:\n                                  auto]\n  --ws [auto|none|websockets|wsproto]\n                                  WebSocket protocol implementation.\n                                  [default: auto]\n  --lifespan [auto|on|off]        Lifespan implementation.  [default: auto]\n  --interface [auto|asgi3|asgi2|wsgi]\n                                  Select ASGI3, ASGI2, or WSGI as the\n                                  application interface.  [default: auto]\n  --env-file PATH                 Environment configuration file.\n  --log-config PATH               Logging configuration file.\n  --log-level [critical|error|warning|info|debug|trace]\n                                  Log level. [default: info]\n  --access-log \/ --no-access-log  Enable\/Disable access log.\n  --use-colors \/ --no-use-colors  Enable\/Disable colorized logging.\n  --proxy-headers \/ --no-proxy-headers\n                                  Enable\/Disable X-Forwarded-Proto,\n                                  X-Forwarded-For, X-Forwarded-Port to\n                                  populate remote address info.\n  --forwarded-allow-ips TEXT      Comma separated list of IPs to trust with\n                                  proxy headers. Defaults to the\n                                  $FORWARDED_ALLOW_IPS environment variable if\n                                  available, or '127.0.0.1'.\n  --root-path TEXT                Set the ASGI 'root_path' for applications\n                                  submounted below a given URL path.\n  --limit-concurrency INTEGER     Maximum number of concurrent connections or\n                                  tasks to allow, before issuing HTTP 503\n                                  responses.\n  --backlog INTEGER               Maximum number of connections to hold in\n                                  backlog\n  --limit-max-requests INTEGER    Maximum number of requests to service before\n                                  terminating the process.\n  --timeout-keep-alive INTEGER    Close Keep-Alive connections if no new data\n                                  is received within this timeout.  [default:\n                                  5]\n  --ssl-keyfile TEXT              SSL key file\n  --ssl-certfile TEXT             SSL certificate file\n  --ssl-version INTEGER           SSL version to use (see stdlib ssl module's)\n                                  [default: 2]\n  --ssl-cert-reqs INTEGER         Whether client certificate is required (see\n                                  stdlib ssl module's)  [default: 0]\n  --ssl-ca-certs TEXT             CA certificates file\n  --ssl-ciphers TEXT              Ciphers to use (see stdlib ssl module's)\n                                  [default: TLSv1]\n  --header TEXT                   Specify custom default HTTP response headers\n                                  as a Name:Value pair\n  --help                          Show this message and exit.\n<\/code><\/pre>\n\n\n\n
\u4f7f\u7528\u8fdb\u7a0b\u7ba1\u7406\u5668<\/h2>\n\n\n\n
\u4f7f\u7528\u8fdb\u7a0b\u7ba1\u7406\u5668\u786e\u4fdd\u4f60\u4ee5\u5f39\u6027\u65b9\u5f0f\u8fd0\u884c\u8fd0\u884c\u591a\u4e2a\u8fdb\u7a0b\uff0c\u4f60\u53ef\u4ee5\u6267\u884c\u670d\u52a1\u5668\u5347\u7ea7\u800c\u4e0d\u4f1a\u4e22\u5f03\u5ba2\u6237\u7aef\u7684\u8bf7\u6c42\u3002<\/strong><\/p>\n\n\n\n
\u4e00\u4e2a\u8fdb\u7a0b\u7ba1\u7406\u5668\u5c06\u4f1a\u5904\u7406\u5957\u63a5\u5b57\u8bbe\u7f6e\uff0c\u542f\u52a8\u591a\u4e2a\u670d\u52a1\u5668\u8fdb\u7a0b\uff0c\u76d1\u63a7\u8fdb\u7a0b\u6d3b\u52a8\uff0c\u76d1\u542c\u8fdb\u7a0b\u91cd\u542f\u3001\u5173\u95ed\u7b49\u4fe1\u53f7\u3002<\/strong><\/p>\n\n\n\n
Uvicorn \u63d0\u4f9b\u4e00\u4e2a\u8f7b\u91cf\u7ea7\u7684\u65b9\u6cd5\u6765\u8fd0\u884c\u591a\u4e2a\u5de5\u4f5c\u8fdb\u7a0b\uff0c\u6bd4\u5982 --workers 4<\/code>\uff0c\u4f46\u5e76\u6ca1\u6709\u63d0\u4f9b\u8fdb\u884c\u7684\u76d1\u63a7\u3002<\/strong><\/p>\n\n\n\n
\u4f7f\u7528 Gunicorn<\/h3>\n\n\n\n
Gunicorn \u662f\u6210\u719f\u7684\uff0c\u529f\u80fd\u9f50\u5168\u7684\u670d\u52a1\u5668\uff0cUvicorn \u5185\u90e8\u5305\u542b\u6709 Guicorn \u7684 workers \u7c7b\uff0c\u5141\u8bb8\u4f60\u8fd0\u884c ASGI \u5e94\u7528\u7a0b\u5e8f\uff0c\u8fd9\u4e9b workers \u7ee7\u627f\u4e86\u6240\u6709 Uvicorn \u9ad8\u6027\u80fd\u7684\u7279\u70b9\uff0c\u5e76\u4e14\u7ed9\u4f60\u4f7f\u7528 Guicorn \u6765\u8fdb\u884c\u8fdb\u7a0b\u7ba1\u7406\u3002<\/strong><\/p>\n\n\n\n
\u8fd9\u6837\u7684\u8bdd\uff0c\u4f60\u53ef\u80fd\u52a8\u6001\u589e\u52a0\u6216\u51cf\u5c11\u8fdb\u7a0b\u6570\u91cf\uff0c\u5e73\u6ed1\u5730\u91cd\u542f\u5de5\u4f5c\u8fdb\u7a0b\uff0c\u6216\u8005\u5347\u7ea7\u670d\u52a1\u5668\u800c\u65e0\u9700\u505c\u673a\u3002<\/strong><\/p>\n\n\n\n
\u5728\u751f\u4ea7\u73af\u5883\u4e2d\uff0cGuicorn \u5927\u6982\u662f\u6700\u7b80\u5355\u7684\u65b9\u5f0f\u6765\u7ba1\u7406 Uvicorn \u4e86\uff0c\u751f\u4ea7\u73af\u5883\u90e8\u7f72\u6211\u4eec\u63a8\u8350\u4f7f\u7528 Guicorn \u548c Uvicorn \u7684 worker \u7c7b\uff1a<\/strong><\/em><\/p>\n\n\n\n
gunicorn example:app -w 4 -k uvicorn.workers.UvicornWorker\n<\/code><\/pre>\n\n\n\n
\u6267\u884c\u4e0a\u8ff0\u547d\u4ee4\u5c06\u5f00\u6237 4 \u4e2a\u5de5\u4f5c\u8fdb\u7a0b\uff0c\u5176\u4e2d UvicornWorker \u7684\u5b9e\u73b0\u4f7f\u7528 uvloop \u548chttptools \u5b9e\u73b0\u3002\u5728 PyPy \u4e0b\u8fd0\u884c\uff0c\u4f60\u53ef\u4ee5\u4f7f\u7528\u7eaf Python \u5b9e\u73b0\uff0c\u53ef\u4ee5\u901a\u8fc7\u4f7f\u7528UvicornH11Worker \u7c7b\u6765\u505a\u5230\u8fd9\u4e00\u70b9\u3002<\/strong><\/em><\/p>\n\n\n\n
gunicorn -w 4 -k uvicorn.workers.UvicornH11Worker\n<\/code><\/pre>\n\n\n\n
Gunicorn \u4e3a Uvicorn \u63d0\u4f9b\u4e86\u4e0d\u540c\u7684\u914d\u7f6e\u9009\u9879\u96c6\uff0c\u4f46\u662f\u4e00\u4e9b\u914d\u7f6e\u6682\u4e0d\u652f\u6301\uff0c\u5982–limit-concurrency \u3002<\/strong><\/p>\n\n\n\n
\u4f7f\u7528 Supervisor<\/h2>\n\n\n\n
\u8981supervisor\u7528\u4f5c\u6d41\u7a0b\u7ba1\u7406\u5668\uff0c\u60a8\u5e94\u8be5\uff1a<\/strong><\/p>\n\n\n\n
\n
\u4f7f\u7528\u5176\u6587\u4ef6\u63cf\u8ff0\u7b26\u5c06\u5957\u63a5\u5b57\u79fb\u4ea4\u7ed9uvicorn\uff0csupervisor\u59cb\u7ec8\u5c06\u5176\u7528\u4f5c0\uff0c\u5e76\u4e14\u5fc5\u987b\u5728\u672cfcgi-program\u8282\u4e2d\u8fdb\u884c\u8bbe\u7f6e\u3002<\/strong><\/p>\n<\/blockquote>\n\n\n\n
\n
\u6216\u4e3a\u6bcf\u4e2auvicorn\u8fdb\u7a0b\u4f7f\u7528UNIX\u57df\u5957\u63a5\u5b57\u3002<\/strong><\/p>\n<\/blockquote>\n\n\n\n
\u4e00\u4e2a\u7b80\u5355\u7684\u4e3b\u7ba1\u914d\u7f6e\u53ef\u80fd\u770b\u8d77\u6765\u50cf\u8fd9\u6837\uff1a administratord.conf\uff1a<\/strong><\/em><\/p>\n\n\n\n
[supervisord]\n\n[fcgi-program:uvicorn]\nsocket=tcp:\/\/localhost:8000\ncommand=venv\/bin\/uvicorn --fd 0 example:App\nnumprocs=4\nprocess_name=uvicorn-%(process_num)d\nstdout_logfile=\/dev\/stdout\nstdout_logfile_maxbytes=0\n<\/code><\/pre>\n\n\n\n
\u7136\u540e\u8fd0\u884csupervisord -n<\/code>\u3002<\/h5>\n\n\n\n
\u4f7f\u7528 Circus<\/h2>\n\n\n\n
\u8981circus\u7528\u4f5c\u6d41\u7a0b\u7ba1\u7406\u5668\uff0c\u60a8\u5e94\u8be5\uff1a<\/strong><\/p>\n\n\n\n
\n
\u4f7f\u7528\u5176\u6587\u4ef6\u63cf\u8ff0\u7b26\u5c06\u5957\u63a5\u5b57\u79fb\u4ea4\u7ed9uvicorn\uff0c\u9a6c\u620f\u56e2\u53ef\u5c06\u5176\u7528\u4f5c$(circus.sockets.web)\u3002<\/strong>
\u6216\u4e3a\u6bcf\u4e2auvicorn\u8fdb\u7a0b\u4f7f\u7528UNIX\u57df\u5957\u63a5\u5b57\u3002<\/strong><\/p>\n<\/blockquote>\n\n\n\n
\u4f7f\u7528 Circus \u4e0e Supervisor \u5f88\u7c7b\u4f3c\u3002\u914d\u7f6e\u6587\u4ef6 circus.ini \u5982\u4e0b\uff1a<\/strong><\/em><\/p>\n\n\n\n
[watcher:web]\ncmd = venv\/bin\/uvicorn --fd $(circus.sockets.web) example:App\nuse_sockets = True\nnumprocesses = 4\n\n[socket:web]\nhost = 0.0.0.0\nport = 8000\n<\/code><\/pre>\n\n\n\n
\u7136\u540e\u8fd0\u884ccircusd circus.ini<\/code>\u3002<\/strong><\/p>\n\n\n\n
\u4e0e Nginx \u90e8\u7f72<\/h2>\n\n\n\n
Nginx \u4f5c\u4e3a Uvicorn \u8fdb\u7a0b\u7684\u4ee3\u7406\u5e76\u4e0d\u662f\u5fc5\u987b\u7684\uff0c\u4f60\u53ef\u4ee5\u4f7f\u7528 Nginx \u505a\u4e3a\u8d1f\u8f7d\u5747\u8861\u3002\u63a8\u8350\u4f7f\u7528 Nginx \u65f6\u914d\u7f6e\u8bf7\u6c42\u5934\uff0c\u5982 X-Forwarded-For,X-Forwarded-Proto\uff0c\u4ee5\u4fbf Uvicorn \u8bc6\u522b\u51fa\u771f\u6b63\u7684\u5ba2\u6237\u7aef\u4fe1\u606f\uff0c\u5982 IP \u5730\u5740\uff0cscheme \u7b49\u3002\u8fd9\u91cc\u6709\u4e00\u4e2a\u914d\u7f6e\u6587\u4ef6\u7684\u6837\u4f8b\uff1a<\/strong><\/em><\/p>\n\n\n\n
http {\n  server {\n    listen 80;\n    client_max_body_size 4G;\n\n    server_name example.com;\n\n    location \/ {\n      proxy_set_header Host $http_host;\n      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n      proxy_set_header X-Forwarded-Proto $scheme;\n      proxy_redirect off;\n      proxy_buffering off;\n      proxy_pass http:\/\/uvicorn;\n    }\n\n    location \/static {\n      # path for static files\n      root \/path\/to\/app\/static;\n    }\n  }\n\n  upstream uvicorn {\n    server unix:\/tmp\/uvicorn.sock;\n  }\n\n}\n<\/code><\/pre>\n\n\n\n
\u4f7f\u7528 HTTPS<\/h2>\n\n\n\n
\u8981\u4f7f\u7528https\u8fd0\u884cuvicorn\uff0c\u9700\u8981\u8bc1\u4e66\u548c\u79c1\u94a5\u3002\u63a8\u8350\u7684\u83b7\u53d6\u65b9\u6cd5\u662f\u4f7f\u7528Let’s Encrypt<\/a>\u3002<\/strong><\/p>\n\n\n\n
\u5bf9\u4e8e\u4f7f\u7528https\u8fdb\u884c\u672c\u5730\u5f00\u53d1\uff0c\u53ef\u4ee5\u4f7f\u7528mkcert<\/a> \u751f\u6210\u6709\u6548\u7684\u8bc1\u4e66\u548c\u79c1\u94a5\u3002<\/strong><\/em><\/p>\n\n\n\n
$ uvicorn example:app --port 5000 --ssl-keyfile=.\/key.pem --ssl-certfile=.\/cert.pem\n<\/code><\/pre>\n\n\n\n
\u4f7f\u7528 Gunicorn \u4e5f\u53ef\u4ee5\u76f4\u63a5\u4f7f\u7528\u8bc1\u4e66\u3002<\/h2>\n\n\n\n
\u4e5f\u53ef\u4ee5\u4e0euvicorn\u7684\u5de5\u4eba\u4e00\u8d77\u4f7f\u7528\u8bc1\u4e66\u6765\u83b7\u53d6gunicorn<\/strong><\/em><\/p>\n\n\n\n
$ gunicorn --keyfile=.\/key.pem --certfile=.\/cert.pem -k uvicorn.workers.UvicornWorker example:ap<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"
\u4ec0\u4e48\u662f Uvicorn \uff1f \u7b54\uff1aUvicorn \u662f\u57fa\u4e8e uvloop \u548c httptools \u6784\u5efa\u7684\u975e\u5e38\u5feb\u901f\u7684 […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[10],"tags":[],"class_list":["post-1939","post","type-post","status-publish","format-standard","hentry","category-10"],"_links":{"self":[{"href":"http:\/\/blog.xtaa.cn\/index.php\/wp-json\/wp\/v2\/posts\/1939","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/blog.xtaa.cn\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/blog.xtaa.cn\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/blog.xtaa.cn\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/blog.xtaa.cn\/index.php\/wp-json\/wp\/v2\/comments?post=1939"}],"version-history":[{"count":1,"href":"http:\/\/blog.xtaa.cn\/index.php\/wp-json\/wp\/v2\/posts\/1939\/revisions"}],"predecessor-version":[{"id":1940,"href":"http:\/\/blog.xtaa.cn\/index.php\/wp-json\/wp\/v2\/posts\/1939\/revisions\/1940"}],"wp:attachment":[{"href":"http:\/\/blog.xtaa.cn\/index.php\/wp-json\/wp\/v2\/media?parent=1939"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/blog.xtaa.cn\/index.php\/wp-json\/wp\/v2\/categories?post=1939"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/blog.xtaa.cn\/index.php\/wp-json\/wp\/v2\/tags?post=1939"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}