部署Flask + uWSGI + Nginx

2016-07-23 [2568] technology python server flask uwsgi logging

文章目录

2017-01-06 更新： 增加 Flask 502 错误解决
2017-04-12 更新 增加 uWSGI HTTPS 支持
2017-08-10 更新 增加详细的 uWSGI 配置说明
2017-11-24 更新 增加在 Python+uWSGI 中使用缓存
2017-11-28 更新 增加 Flask+uWSGI 的 Logging 支持
2020-01-27 更新 增加 Flask+uWSGI Logging rotate：重要补充
2020-08-15 更新 增加 pyzog：uWSGI logging rotate 的终极方案，修改关于 supervisor 版本的说明

作为一个选择综合症+洁癖患者，在部署 Flask app 的时候着实有点纠结。互联网上能找到的教程都不怎么靠谱，要么太老，要么太乱连话都说不通顺，更别提那些转了无数手的资料了。 uwsgi 的参数别名众多，各种旧版本的配置也不尽相同，让急着把自己的 Flask 站点搭建到正式服务器上的新手们无所适从。

我把自己的部署过程写出来，所有资源参考官方文档，我也尽量给出选择的原因。这教程适用于各个 linux 发行版。若有疑问，请留言。

组件选择

Flask 开发使用 python3.5 ;
python 虚拟环境，使用 python3.3 开始自带的 venv；
启动器使用 supervisor v3，uwsgi 使用 v2；
uwsgi 和 supervisor 均使用 pip 安装，而不使用 linux 自带的版本。

因为 ubuntu 自带 uwsgi，我曾经纠结过使用系统自带版本还是使用 pip 版本。使用自带的版本的好处，就是安装后可以直接使用 /etc/init.d/uwsgi start 来启动，不需要自己写启动脚本，但我仍然选择了使用 pip 版本。下面是原因。

uwsgi 的版本在 Ubuntu 12.04 上比较老了(1.03)，这让人心生不快。supervisor 的优势摆在那里，而且也是 python 写成，这激发了我的“纯正血统情怀”。还有一个优势就是 uwsgi 可以安装在 venv 之下，这样不必影响系统包的稳定性（不过我并没有用上这个优势，后面会讲到原因）。

supervisor 也有系统自带版本，版本号很老了(3.0a8-1.1)。supervisor 文档中贴心地提供了全套 initscripts ，在各个发行版上启动都不是问题。

项目文件夹结构

待部署的项目名称为 EM ，文件夹结构如下，部署在服务器的 /srv/www/em 文件夹下：

 1├── README.md
 2├── app
 3│   ├── __init__.py
 4│   ├── main
 5│   ├── models.py
 6│   ├── static
 7│   └── templates
 8├── config.py
 9├── manage.py
10├── migrations
11├── requirements.txt
12├── tests
13├── venv
14└── uwsgi.ini

安装 supervisor

~~supervisor 不支持 python3 ，这在官方文档中就已经说明：~~

~~Supervisor is known to work with Python 2.4 or later but will not work under any version of Python 3.~~

2020-08-15 更新： Supervisor 3.x 版本已经支持 Python 3，请自行参考官方文档升级： Upgrading Supervisor 2 to 3。本文内容基于 Supervisor 2.x，且不再更新，仅供参考。

好在服务器上都有自带的 python2 。但我的服务器上的 python2 中并没有 pip，因此需要先安装 pip。

标准的 pip 安装方法是：

1wget https://bootstrap.pypa.io/get-pip.py
2python get-pip.py

安装和下载过程中的全部内容都是国外的服务器导致速度堪忧，下面提供一个简单的方法。

1. 访问豆瓣的 pypi 源，在该页面中搜索 6.1.0.tar.gz ，下载搜索到的那个链接，例如我的下载链接为：

1http://pypi.doubanio.com/packages/6c/84/432eb60bbcb414b9cdfcb135d5f4925e253c74e7d6916ada79990d6cc1a0/pip-6.1.0.tar.gz#md5=d0c349765bbc23743cec42b37bd8a281

更多的源请参见：常用开源镜像站整理

2. pip 的安装依赖 setuptools ，搜索 20.1.tar.gz ，下载搜索到的那个链接。

3. 将下载到的两个压缩包解压，然后安装：

1python setuptools-20.1/setup.py build
2python setuptools-20.1/setup.py install
3python pip-6.1.0/setup.py build
4python pip-6.1.0/setup.py install

上面的版本号不一定要和我的一致，但一定要选择 tar.gz 的压缩包，这样的压缩包还是使用 egg 格式发布的，可以使用 setup.py 安装。新版本的 pip 和 setuptools 都使用 wheel 格式发布了，解压后无法使用 setup.py 安装。想了解 egg 和 wheel 的区别，可参考 Python 包管理工具解惑。

安装了 pip 之后，就可以使用 pip install supervisor 了。注意，不应该将 supervisor 安装在虚拟环境中，作为一个通用组件，它应该是一个系统级别的存在。

这里还有一个小插曲。我使用常用开源镜像站整理中提到的方法把 pypi 的源设置成了豆瓣 HTTPS 源，但更新 pip 的时候报错：

 1# pip install -U pip
 2/usr/local/lib/python2.7/dist-packages/pip-6.1.0-py2.7.egg/pip/_vendor/requests/packages/urllib3/util/ssl_.py:79: InsecurePlatformWarning: A true SSLContext object is not available. This prevents urllib3 from configuring SSL appropriately and may cause certain SSL connections to fail. For more information, see https://urllib3.readthedocs.org/en/latest/security.html#insecureplatformwarning.
 3  InsecurePlatformWarning
 4DEPRECATION: Failed to find 'pip' at https://pypi.doubanio.com/simple/pip/. It is suggested to upgrade your index to support normalized names as the name in /simple/{name}.
 5/usr/local/lib/python2.7/dist-packages/pip-6.1.0-py2.7.egg/pip/_vendor/requests/packages/urllib3/util/ssl_.py:79: InsecurePlatformWarning: A true SSLContext object is not available. This prevents urllib3 from configuring SSL appropriately and may cause certain SSL connections to fail. For more information, see https://urllib3.readthedocs.org/en/latest/security.html#insecureplatformwarning.
 6  InsecurePlatformWarning
 7Cannot fetch index base URL https://pypi.doubanio.com/simple/
 8/usr/local/lib/python2.7/dist-packages/pip-6.1.0-py2.7.egg/pip/_vendor/requests/packages/urllib3/util/ssl_.py:79: InsecurePlatformWarning: A true SSLContext object is not available. This prevents urllib3 from configuring SSL appropriately and may cause certain SSL connections to fail. For more information, see https://urllib3.readthedocs.org/en/latest/security.html#insecureplatformwarning.
 9  InsecurePlatformWarning
10Requirement already up-to-date: pip in /usr/local/lib/python2.7/dist-packages/pip-6.1.0-py2.7.egg

看反馈的信息可能是 urllib3 自带的 ssl 加密问题。pip 升级到 8.1.2 也有相同的问题。

因此，我把 pypi 源换成了没有 https 加密的地址（见下方），安装成功。

1# pip install supervisor
2Collecting supervisor
3  Downloading http://pypi.zenlogic.net/packages/44/80/d28047d120bfcc8158b4e41127706731ee6a3419c661e0a858fb0e7c4b2d/supervisor-3.3.0.tar.gz (416kB)
4    100% 419kB 3.3MB/s
5Collecting meld3>=0.6.5 (from supervisor)
6  Downloading http://pypi.zenlogic.net/packages/py2.py3/m/meld3/meld3-1.0.2-py2.py3-none-any.whl
7Installing collected packages: meld3, supervisor
8  Running setup.py install for supervisor ... done
9Successfully installed meld3-1.0.2 supervisor-3.3.0

配置 supervisor

下面以 ubuntu 为例进行配置。

1. 在initscripts 下载 ubuntu 的启动脚本，复制到 /etc/init.d/supervisor ；

2. 修改启动脚本中的路径，使其与安装路径相匹配。如果使用 pip 安装，supervisord 一般位于 /usr/local/bin/ 而非默认的 /usr/bin/ ;

3. 执行 echo_supervisord_conf > /etc/supervisor/supervisord.conf 创建一个默认的配置文件；

4. 调整 /etc/supervisor/supervisord.conf 中的几个路径相关的参数，使其与 /etc/init.d/supervisor 中的路径参数完全一致：

1; (the path to the socket file)
2file=/var/run/supervisor.sock
3; (main log file;default $CWD/supervisord.log)
4logfile=/var/log/supervisord.log
5; (supervisord pidfile;default supervisord.pid)
6pidfile=/var/run/supervisord.pid
7; use a unix:// URL for a unix socket
8serverurl=unix:///var/run/supervisor.sock

上面的三个参数默认的值位于 /tmp 中，这样可能会导致执行 /etc/init.d/supervisor start 的时候由于找不到 pid 文件导致误判。

5. 调整 /etc/supervisor/supervisord.conf 中的 [includes] section 为如下所示（注意要使用绝对路径）：

1[include]
2files = /etc/supervisor/conf.d/*.conf

这样，加入程序的时候就不必修改主配置文件，只需要在 /etc/supervisor/conf.d 文件夹下面增加一个 .conf 配置文件即可。

来看看成果吧！

1# service supervisor start
2Starting supervisor: supervisord.
3# service supervisor status
4supervisord is  not running.

安装 uwsgi

在服务器上 clone 了 flask 项目，然后安装 uwsgi ，但碰到如下错误：

 1# pip3 install uwsgi
 2......
 3d -ldl -lutil -lrt -lm /usr/local/lib/python3.5/config-3.5m/libpython3.5m.a -lutil -lcrypt
 4    /usr/local/lib/python3.5/config-3.5m/libpython3.5m.a(pytime.o): In function `pygettimeofday':
 5    /root/software/Python-3.5.1/Python/pytime.c:494: undefined reference to `clock_gettime'
 6    /usr/local/lib/python3.5/config-3.5m/libpython3.5m.a(pytime.o): In function `pymonotonic':
 7    /root/software/Python-3.5.1/Python/pytime.c:633: undefined reference to `clock_gettime'
 8    /usr/local/lib/python3.5/config-3.5m/libpython3.5m.a(pytime.o): In function `pygettimeofday':
 9    /root/software/Python-3.5.1/Python/pytime.c:494: undefined reference to `clock_gettime'
10    /root/software/Python-3.5.1/Python/pytime.c:508: undefined reference to `clock_getres'
11    /usr/local/lib/python3.5/config-3.5m/libpython3.5m.a(pytime.o): In function `pymonotonic':
12    /root/software/Python-3.5.1/Python/pytime.c:633: undefined reference to `clock_gettime'
13    /root/software/Python-3.5.1/Python/pytime.c:646: undefined reference to `clock_getres'
14    /usr/local/lib/python3.5/config-3.5m/libpython3.5m.a(timemodule.o): In function `py_process_time':
15    /root/software/Python-3.5.1/./Modules/timemodule.c:977: undefined reference to `clock_gettime'
16    /root/software/Python-3.5.1/./Modules/timemodule.c:983: undefined reference to `clock_getres'
17    /usr/local/lib/python3.5/config-3.5m/libpython3.5m.a(timemodule.o): In function `time_clock_getres':
18    /root/software/Python-3.5.1/./Modules/timemodule.c:205: undefined reference to `clock_getres'
19    /usr/local/lib/python3.5/config-3.5m/libpython3.5m.a(timemodule.o): In function `time_clock_gettime':
20    /root/software/Python-3.5.1/./Modules/timemodule.c:151: undefined reference to `clock_gettime'
21    /usr/local/lib/python3.5/config-3.5m/libpython3.5m.a(timemodule.o): In function `time_clock_settime':
22    /root/software/Python-3.5.1/./Modules/timemodule.c:182: undefined reference to `clock_settime'
23    collect2: ld returned 1 exit status
24    *** error linking uWSGI ***
25
26    ----------------------------------------
27Command "/urr/local/bin/python3.5 -u -c "import setuptools, tokenize;__file__='/tmp/pip-build-vz6gni75/uwsgi/setup.py';exec(compile(getattr(tokenize, 'open', open)(__file__).read().replace('\r\n', '\n'), __file__, 'exec'))" install --record /tmp/pip-klu1fasz-record/install-record.txt --single-version-externally-managed --compile --install-headers /url/local/lib/site/python3.5/uwsgi" failed with error code 1 in /tmp/pip-build-vz6gni75/uwsgi/

我的服务器中的 python3.5 是自行编译安装的。因为服务器发行版是 Ubuntu12.04，官方源中并没有 python3.5。自行编译安装的 python 缺少了 python3.5-dev 这个包，导致 uwsgi 安装的时候无法编译通过。我碰到的问题和这里描述的一致。

我采用了一种比较简单的解决方案，就是删除编译安装的 python3.5 ，加入 PPA 源，再安装 PPA 源中的 python3.5 。

但是，python3.5 的源码包并没有提供 make uninstall 命令，因此删除已经编译安装的 python3.5 成了一个问题。有两个方法解决这个问题。

1. 使用 checkinstall 基于当时编译用的源码创建一个 deb 包，然后安装它，再删除它。 via

1# 安装 checkinstall
2sudo apt-get install checkinstall
3cd /home/rzeng/Python_3.5.1
4# 创建一个 deb 包。注意在这里提供一个特定的包名。例如 python351，如果使用默认的 python，则可能和发行版自带的 python2 冲突。
5sudo checkinstall -D --fstrans=no make install
6# 基于创建的 deb 包重新安装 python
7sudo dpkg -i python_3.5.1-1.amd64.deb
8# 移除刚才安装的包
9sudo dpkg -r python351

2. 直接删除已经安装的文件。 via

使用 whereis 获取到编译安装的 python 的安装路径，然后逐一删除即可。

1# whereis python3
2python3: /usr/bin/python3.5m-config /usr/bin/python3.5m /usr/bin/python3.5-config /usr/bin/python3.5 /etc/python3.5 /usr/lib/python3 /usr/lib/python3.5 /usr/local/lib/python3.5 /usr/include/python3.5m /usr/include/python3.5

如果怕 whereis 删不干净，也可以重新编译安装一遍，记录所有的安装日志：make install &> |tee make.log ，然后在日志里分析所有文件的安装路径，再逐个删除。

下面是加入 ppa 源并安装 python3.5 就简单多了：

1sudo add-apt-repository ppa:fkrull/deadsnakes
2sudo apt-get update
3sudo apt-get install python3.5 python3.5-dev

现在安装 uwsgi ，一次成功。注意，和 supervisor 一样，不应该将 uwsgi 安装在虚拟环境中。

1# python3.5 -m pip install uwsgi
2Collecting uwsgi
3  Downloading http://pypi.zenlogic.net/packages/83/22/47b6ff871a5f01b9f660121cf61ba1eccbf7886b5cbe24caacccd0d00d07/uwsgi-2.0.13.1.tar.gz (784kB)
4    100% 788kB 3.0MB/s
5Installing collected packages: uwsgi
6  Running setup.py install for uwsgi ... done
7Successfully installed uwsgi-2.0.13.1

配置 uwsgi

uwsgi 支持使用 ini/xml/json/yaml 格式作为配置文件（关于配置文件，可参考常用配置文件格式简析）。我建议使用 ini 格式，这样最为简单。下面是个最简单的配置文件(uwsgi.ini)：

 1[uwsgi]
 2; 当设定了 max-request 的时候，到达值后 worker 会重启
 3; http://uwsgi-docs-cn.readthedocs.io/zh_CN/latest/Options.html?highlight=max-requests
 4; 如果没有 master，重启将不会实现
 5; http://stackoverflow.com/a/5430522/1542345
 6master = true
 7max-requests = 6000
 8
 9; Simple math like processes = 2 * cpucores will not be enough.
10processes = 2
11
12; 如果你想维持 Python 的线程支持同时应用又不启动多个线程，只需要加上 --enable-threads 选项 (或者 enable-threads = true 在 ini 风格配置文件中)。
13; http://uwsgi-docs-cn.readthedocs.io/zh_CN/latest/WSGIquickstart.html#python
14; enable-threads = true
15
16; http://uwsgi-docs.readthedocs.io/en/latest/ThingsToKnow.html
17; 启用了多线程模式后，但自动开启线程支持，因此上面的  enabled-threads 不用设置
18threads = 2
19
20; 惊群效应
21; http://uwsgi-docs-zh.readthedocs.io/zh_CN/latest/articles/SerializingAccept.html
22thunder-lock = true
23
24chmod-socket = 664
25
26; 参见 https://blog.zengrong.net/post/2614.htm
27buffer-size = 32768
28
29; 执行的启动文件
30wsgi-file = manage.py
31; 对应 manage.py 的同名全局变量，是一个 Flask app
32callable = app
33
34; 在 ubuntu 下，使用 www-data 权限来执行，其他发行版请自行修改
35uid = www-data
36gid = www-data
37
38; 虚拟环境的文件夹
39venv = /srv/www/em/venv
40; 可以使用魔术变量, %d 代表 uwsgi 工作目录
41; venv = %dvenv
42
43; 启动 http 监听，注意不要写成了 socket
44http = 0.0.0.0:5000
45
46; 使用 pidfile，方便用 --stop 或者 --reload
47pidfile = %d%n.pid
48
49; 除了 pidfile 也同时使用 Master Fifo 来管理进程
50; http://uwsgi-docs-zh.readthedocs.io/zh_CN/latest/MasterFIFO.html
51; 如果使用 supervisor 管理进程，是否使用 master-fifo 则可以自行选择，这是对 uwsgi 进行高级管理的好办法
52master-fifo = %d%n.fifo

在 uwsgi 的配置中，有许多配置是有多个别名的。例如设置虚拟环境的这个配置 venv，就有如下几个别名：

venv
virtualenv
home
pyhome

wsgi-file 的别名是 file 。

所以，在网上搜索到的教程使用各种别名的都有，让人感觉很混乱。查一下官方文档就很清楚了。由于 home 这个名称有欺骗性，我偏爱于使用 venv 这个名称。

接下来启动 uwsgi 进程，显示如下：

 1#uwsgi uwsgi.ini
 2[uWSGI] getting INI configuration from uwsgi.ini
 3*** Starting uWSGI 2.0.13.1 (64bit) on [Wed Jul 27 20:29:52 2016] ***
 4compiled with version: 4.6.3 on 27 July 2016 09:59:07
 5os: Linux-3.2.0-60-generic #91-Ubuntu SMP Wed Feb 19 03:54:44 UTC 2014
 6nodename: aliyun
 7machine: x86_64
 8clock source: unix
 9pcre jit disabled
10detected number of CPU cores: 1
11current working directory: /srv/www/em
12detected binary path: /usr/local/bin/uwsgi
13setgid() to 33
14setuid() to 33
15*** WARNING: you are running uWSGI without its master process manager ***
16your processes number limit is 7815
17your memory page size is 4096 bytes
18detected max file descriptor number: 1024
19lock engine: pthread robust mutexes
20thunder lock: disabled (you can enable it with --thunder-lock)
21uWSGI http bound on 0.0.0.0:5000 fd 4
22spawned uWSGI http 1 (pid: 25209)
23uwsgi socket 0 bound to TCP address 127.0.0.1:41177 (port auto-assigned) fd 3
24Python version: 3.5.2 (default, Jul 17 2016, 17:43:04)  [GCC 4.6.3]
25PEP 405 virtualenv detected: /srv/www/em/venv
26Set PythonHome to /srv/www/em/venv
27*** Python threads support is disabled. You can enable it with --enable-threads ***
28Python main interpreter initialized at 0x18f2ba0
29your server socket listen backlog is limited to 100 connections
30your mercy for graceful operations on workers is 60 seconds
31mapped 72768 bytes (71 KB) for 1 cores
32*** Operational MODE: single process ***
33WSGI app 0 (mountpoint='') ready in 1 seconds on interpreter 0x18f2ba0 pid: 25208 (default app)
34*** uWSGI is running in multiple interpreter mode ***
35spawned uWSGI worker 1 (and the only) (pid: 25208, cores: 1)

访问服务器，可以看到 uwsgi 收到的 get 请求：

1[pid: 25208|app: 0|req: 1/1] 119.97.214.98 () {36 vars in 913 bytes} [Wed Jul 27 20:31:56 2016] GET / => generated 1349 bytes in 68 msecs (HTTP/1.1 200) 2 headers in 81 bytes (1 switches on core 0)

最后，可以把标准输出记录到 log 中，在 uwsgi.ini 中加入（记得要把 logs 文件夹的写权限给 www-data 账户）：

1[uwsgi]
2; .....
3logto = /srv/www/em/logs/uwsgi.log

这样，再次启动 uwsgi 的时候，显示如下：

1#uwsgi uwsgi.ini
2[uWSGI] getting INI configuration from uwsgi.ini

所有其他的输出都被记录到日志文件中去了。

配置 supervisor + uwsgi

增加一个 supervisor 配置文件： /etc/supervisor/conf.d/em.conf ，内容如下：

 1[program:em]
 2
 3; 启动命令行。uwsgi 已经在系统 PATH 中，因此直接调用，参数使用了绝对路径。
 4command=uwsgi /srv/www/em/uwsgi.ini
 5
 6; 启动文件夹。这里使用 Flask 项目所在文件夹，也就是 uwsgi.ini 所在文件夹。
 7directory=/srv/www/em
 8
 9; 启动帐号。和 uwsgi 的配置相同
10user=www-data
11
12; 分别保存标准输出和标准错误日志，如果 uwsgi 启动出错，可以去日志里面找原因。
13stdout_logfile=/srv/www/em/logs/supervisor_uwsgi_stdout.log
14stderr_logfile=/srv/www/em/logs/supervisor_uwsgi_stderr.log

接着进入 supervisorctl 来启动 em 这个程序：

1supervisor> start em
2em: started
3supervisor> status em           RUNNING   pid 26267, uptime 0:00:29

可以使用 help 命令查看 supervisorctl 提示符支持的子命令。

此时可以访问 http://your-domain:5000 来查看 Flask 站点了。

配置 Nginx + uwsgi

最后一步，需要把 Flask 站点置于 Nginx 之后。因为我的服务器上还有 php 程序，要共用 80 端口，就需要 Nginx 来做转发。我使用的是 Nginx 的修改版 OpenResty，它的配置和 Nginx 完全相同。如果你要安装 OpenResty，可以参考这篇：从 Lighttpd 到 OpenResty 。

我的 OpenResty 配置文件夹为 /usr/local/openresty/nginx/conf ，所有的虚拟主机放在 vhost 子文件夹之下。ubuntu 和 centos 的配置文件夹路径可能不同，请自行判断。

下面是 /usr/local/openresty/nginx/conf/vhost/em.conf 的内容：

 1server {
 2    listen 80;
 3    server_name your-domain;
 4	access_log logs/access-em.log;
 5	error_log logs/error-em.log;
 6
 7    location / { try_files $uri @em; }
 8    location @em {
 9		root    /srv/www/em/app;
10		include uwsgi_params;
11		uwsgi_pass 127.0.0.1:5000;
12    }
13}

这部分的配置在 Flask 官方文档 Configuring nginx 中有提及，uwsgi 的官方文档 Virtual Hosting 中也有说明。这些文档写的简洁清晰，比乱七八糟夹缠不清的各种转载文档是要好多了。

重启 Nginx 看效果。此时访问 http://your-domain ，你很可能会碰到 502 错误：

1502 Bad Gateway
2openresty/1.9.3.1

这是因为 uwsgi 配置文件中，我们使用的是 http 方式，直接把 uwsgi 作为 HTTP 服务器使用。我们需要修改 uwsgi 配置：

1[uwsgi]
2; ...
3; 启动 http 监听，注意不要写成了 socket
4; http = 0.0.0.0:5000
5; 启动 socket 监听
6socket = 0.0.0.0:5000

然后使用 supervisorctl 重启 em 程序:

1# supervisorctl                             
2em                               RUNNING   pid 32073, uptime 0:04:25
3supervisor> restart em
4em: stopped
5em: started

再次访问 http://your-domain 。成功！

在这里我多次碰到一个很诡异的问题，也记录一下，或许有用。

当 root 配置位于 location 块之外的时候，Safari 访问程序的子页面正常，但访问主页 http://your-domain 或者 http://your-domain/ 的时候会被跳转到默认主页（就好像虚拟主机没有配置成功），必须使用这样的链接访问 http://your-domain// （多个斜杠）才能成功访问主页。

有趣的是，Firefox 和 Chrome 都没有这个问题。例如使用下面的配置，Safari 访问会有问题。

 1server {
 2    ...
 3    server_name your-domain;
 4	access_log logs/access-em.log;
 5	error_log logs/error-em.log;
 6
 7    root    /srv/www/em/app;
 8    location / { try_files $uri @em; }
 9    location @em {
10		include uwsgi_params;
11		uwsgi_pass 127.0.0.1:5000;
12    }
13}

当把 root 放在 location 之内，就没有这个问题了。Safari 和其他浏览器都正常。

使用子目录提供 Flask app 服务

有时候我们脑袋中会冒出一些 BT 的需求，例如，使用 /em 这个 URL 来提供对 EM 项目的服务，使用 /sexyzone 这个 URL 提供另一个毫不相干的项目的服务。就像这样：

1http://your-domain/em
2http://your-domain/sexyzone

那么，使用 http://your-domain/em 这个路径来提供 EM 这个项目的服务，应该如何做？

首先，需要在注册 Blueprint 的时候提供 url_prefix 参数。

1app = Flask(__name__)
2app.register_blueprint(main_blueprint, url_prefix='/em')

这样处理之后，在使用 url_for() 命令的时候，url 会自动加上 /em 前缀。

例如之前的源码为：

1<ul class="nav navbar-nav">
2    <li><a href="/">Home</a></li>
3    <li><a href="/persons/">Persons</a></li>
4    <li><a href="/teams/">Teams</a></li>
5</ul>

修改之后会变为：

1<ul class="nav navbar-nav">
2    <li><a href="/em/">Home</a></li>
3    <li><a href="/em/persons/">Persons</a></li>
4    <li><a href="/em/teams/">Teams</a></li>
5</ul>

其次，需要考虑 static 文件的路径，并没有跟随 Blueprint 的变化而变化，现在 static 内容依然没有前缀：

1<script src="/static/bootstrap/jquery.min.js?bootstrap=3.3.6.0"></script>
2<script src="/static/bootstrap/js/bootstrap.min.js?bootstrap=3.3.6.0"></script>

要解决这个问题，需要另一个参数，在创建 Flask 实例的时候增加 static_url_path 参数即可。

1app = Flask(__name__, static_url_path='/em/static')

错误解决

Flask 502 错误解决：upstream sent too big header and invalid request block size

uWSGI + Nginx 的 HTTPS 支持

全文完

文章ID：2568
原文作者：zrong
原文链接：https://blog.zengrong.net/post/deploy-flask-uwsgi-nginx/
版权声明：本作品采用署名-非商业性使用-相同方式共享 4.0 国际 (CC BY-NC-SA 4.0) 进行许可，非商业转载请注明出处（原文作者，原文链接），商业转载请联系作者获得授权。