Step 0: 准备工作
- 安装并配置 Nginx,可以参考这篇教程;
- 在 DNS 配置里加入一条 A 记录,将你的域名指向你的 IP,适用于子域名配置;
Step 1: 安装 Pip 包管理器
| $ sudo apt update $ sudo apt install python3-pip python3-dev build-essential libssl-dev libffi-dev python3-setuptools |
Setp 2: 创建 Python 虚拟环境
Python 虚拟环境有助于将不同的应用之间的 python 环境隔离;用于创建和管理虚拟环境的模块为 venv
| $ sudo apt install python3-venv |
创建项目目录并为其创建虚拟化环境
| $ mkdir ~/flask_demo $ cd ~/flask_demo $ python -m venv flaskenv |
激活上面创建的虚拟化环境
| $ source flaskenv/bin/activate |
Step 3: 创建 Flask 应用
安装 wheel 包,以支持 wheel(.whl) 打包格式
| (flaskenv) $ pip install wheel |
然后,再安装 Flask 和 uWSGI
| (flaskenv) $ pip install uwsgi flask |
创建 Flask Demo 应用
| # ~/flask_demo/app.py from flask import Flask app = Flask(__name__) @app.route("/") def hello(): return "<h1 style='color:blue'>Hello There!</h1>" if __name__ == "__main__": app.run(host='0.0.0.0') |
测试新创建的 Flask 应用
| (flaskenv) $ python app.py * Serving Flask app "app" (lazy loading) * Environment: production WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead. * Debug mode: off * Running on http://0.0.0.0:5000/ (Press CTRL+C to quit) |
通过浏览器访问 http://server-domain-or-ip:5000 将会看到页面
在控制台 CTRL-C 可以结束上面的 Server
创建 WSGI 网关
| # ~/flask_demo/wsgi.py from app import app if __name__ == "__main__": app.run() |
Step 4: 配置 uWSGI
直接使用 python app.py 运行服务的方式只适合本地开发,线上运行时要保证更高的性能和稳定性,需要使用 uwsgi 进行部署。
使用 uwsgi 部署 Flask 只需要换一种命令来启动服务即可
| (flaskenv) $ uwsgi --socket 0.0.0.0:5000 --protocol=http -w wsgi:app |
- –socket 0.0.0.0:5000:指定暴露端口号为 5000
- –protocol=http:使用 http 协议
- -w wsgi:app:-w 指明了要启动的模块,wsgi 就是项目启动文件 wsgi.py 去掉扩展名,app 是 wsgi.py 文件中的变量 app,即 Flask 实例
启动完成后,在任意网络连通的机器上打开浏览器,并访问 http://server-domain-or-ip:5000 将再次看到同样结果
关掉控制台,并退出虚拟环境
创建 uWSGI配置文件
| # ~/flask_demo/app.ini [uwsgi] module = wsgi:app master = true processes = 5 socket = app.sock chmod-socket = 660 vacuum = true die-on-term = true |
Step 5: 创建 Systemd Service 配置文件
| # vim /etc/systemd/system/flask_demo.service [Unit] Description=uWSGI instance to serve flask_demo After=network.target [Service] User=joy Group=www-data WorkingDirectory=/home/joy/falsk_demo Environment="PATH=/home/joy/flask_demo/flaskenv/bin" ExecStart=/home/joy/flask_demo/flaskenv/bin/uwsgi --ini app.ini [Install] WantedBy=multi-user.target |
启动上面 uWSGI 服务,并让其开机自动启动
| $ sudo systemctl start flask_demo.service $ sudo systemctl enable flask_demo.service |
Step 6: 配置 Nginx,反向代理 uWSGI 请求
| $ sudo vim /etc/nginx/sites-available/flask_demo |
新创建一个 nginx server 配置项,通过 uwsgi_pass 将请求传递给我们在 app.ini 中配置文件指定创建的 socket
| server { listen 80; server_name your_domain www.your_domain; location / { include uwsgi_params; uwsgi_pass unix:/home/joy/flask_demo/app.sock; } } |
要启用该 server 配置,只要需要将其符号连接到 sites-enabled 目录:
| $ sudo ln -s /etc/nginx/sites-available/flask_demo /etc/nginx/sites-enabled |
检查新加的 nginx 配置文件是否有语法错误
重启 nginx 服务项
| $ sudo systemctl restart nginx |
重启完成后,由于 Nginx 本身监听的端口是 80 端口,因此我们可以直接访问域名或者机器 IP 进行访问。
参考文章
How To Serve Flask Applications with uWSGI and Nginx on Ubuntu 18.04