📖Flask实战的经验总结📖
📱有问题随时与我联系,一起学习交流📱
❤️喜欢的话点个三连吧❤️
1.前言
本人最近用flask开发一个web项目,要部署到单位内网中,内网服务器是window server 2016,本文讲了部署的基本流程和一些爬坑过程。
环境:Windows server 2016 + Python 3.6.6 + Apache2.4
2.简单理解Flask框架,web服务器(Apache)和WSGI的关系
Web框架层。Web框架的作用主要是方便我们开发 web应用程序,HTTP请求的动态数据就是由 web框架层来提供的。比如:Django、Flask等。我选用Python的轻量级web开发框架Flask进行项目开发,Flask提供了轻量级的Web服务,方便进行开发和调试,但是在实际部署的时候,却不能直接用Flask发布应用,这在我们开发过程中有提示:WARNING:This is a development server. Do not use it in a production deployment. falsk WSGI,因此还需要Web服务和WSGI(web服务网关接口)。
web服务器层。Web服务器的主要作用就是接收请求 、处理请求、返回响应。比如:Nginx,Apache,IIS等。本次选用的是Apache。
WSGI层。WSGI不是服务器,也不是用于与程序交互的API,只是一种接口,它只适用于 Python 语言,其全称为 Web Server Gateway Interface,定义了 web服务器和 web应用之间的接口规范。也就是说,只要 web服务器和 web应用都遵守WSGI协议,那么 web服务器和 web应用就可以随意的组合。
3.准备一些安装包
- Python
- Apache
- mod_wsgi
- flask项目的依赖包
- ⚠️三个软件的版本一定要匹配
3.1下载Python
本次下载的Python 3.6.6 64位。下载链接
3.2下载Apache
本次下载的Apache 2.4。下载链接
版本选择一定要注意,首先我们打开Python终端,可以看到如下信息(我写文章的电脑是3.6.1版本,实际要参照安装部署环境的Python版本):
Python 3.6.1 (v3.6.1:69c0db5, Mar 21 2017, 18:41:36) [MSC v.1900 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
找到[MSC v.1900 64 bit (AMD64)]
对照下表,可知 MSC_VER=1900
对应 Visual C++ 2015
(14.0):
Visual C++ 2005 (8.0) MSC_VER=1400
Visual C++ 2008 (9.0) MSC_VER=1500
Visual C++ 2010 (10.0) MSC_VER=1600
Visual C++ 2012 (11.0) MSC_VER=1700
Visual C++ 2013 (12.0) MSC_VER=1800
Visual C++ 2015 (14.0) MSC_VER=1900
Visual C++ 2017 (15.0) MSC_VER=1910
在Apache下载链接中找到VC2015、64位的版本下载。
3.3下载mod_wsgi
进入下载页面
选择cp36对应Python3.6版本,amd64对应64位操作系统。
3.4准备Flask项目离线安装包
由于内网与互联网不通,因此需要提前准备好Flask项目离线安装包。
具体步骤参照Python虚拟环境中的依赖包迁移到断网环境。
安装文章步骤操作后,这里我们将所有的依赖包会存放在whls文件夹
,并形成一个requirement.txt
文档。
4.进行安装
将上述安装包httpd-2.4.53-o111n-x64-vc15.zip
、python3.6.6.rar
、mod_wsgi-4.7.1-cp36-cp36m-win_amd64.whl
,whls文件夹
和requirement.txt
拷贝到内网环境中进行安装。
4.1安装Python
这里不详细介绍,参照Windows下Python3的环境搭建。
4.2安装Apache
- 将
httpd-2.4.53-o111n-x64-vc15.zip
解压到任意位置,这里我解压到D盘。 - 使用命令行界面(以管理员身份运行)进入到对应目录。
>CD D:\Apache24\bin
- 将Apache服务加入到Windows服务中,并尝试启动测试,报错,这是因为监听端口被占用。
D:\Apache24\bin>httpd -k install -n "Apache2.4"
Installing the 'Apache2.4' service
The 'Apache2.4' service is successfully installed.
Testing httpd.conf....
Errors reported here must be corrected before the service can be started.
(OS 10013)以一种访问权限不允许的方式做了一个访问套接字的尝试。 : AH00072: make_sock: could not bind to address [::]:80
(OS 10013)以一种访问权限不允许的方式做了一个访问套接字的尝试。 : AH00072: make_sock: could not bind to address 0.0.0.0:80
AH00451: no listening sockets available, shutting down
AH00015: Unable to open logs
我们进入到D:\Apache24\conf
,打开httpd.conf
文件,找到如下信息:
#Listen 12.34.56.78:80
Listen 80
将监听端口80端口修改,如8080。
通过运行栏,输入services.msc
进入服务管理窗口,启动刚才安装的Apache2.4服务,进入浏览器,输入http://127.0.0.1:8063/
,如果显示如下页面,说明服务启动成功。
4.3安装flask项目依赖包,并测试flask项目
参照Python虚拟环境中的依赖包迁移到断网环境,与这篇教程不同的是,在内网环境中,我并没有使用虚拟环境,直接将相关依赖包安装到了全局环境下。
此时可以测试下项目在flask提供的web服务下是否能正常运行(note:虚拟环境部署项目还是有些小问题,日后解决了再分享,以实际需求为主,内网环境只部署一个项目,所以不需要虚拟环境也可以。)
4.4安装mod_wsgi
使用命令行界面(以管理员身份运行)进入到mod_wsgi-4.7.1-cp36-cp36m-win_amd64.whl
对应目录,直接安装。
>pip install mod_wsgi-4.7.1-cp36-cp36m-win_amd64.whl
Installing collected packages: mod-wsgi
Successfully installed mod-wsgi-4.7.1
安装成功后,切换到python的安装目录的\scripts文件夹下运行如下命令:
c:\Python36\Scripts>mod_wsgi-express module-config
LoadFile "c:/users/***/anaconda3/python36.dll"
LoadModule wsgi_module "c:/users/***/anaconda3/lib/site-packages/mod_wsgi/server/mod_wsgi.cp36-win_amd64.pyd"
WSGIPythonHome "c:/users/chengyikang/anaconda3"
保存上述3行信息用于下步配置。
5.配置
到了最后一步配置了,坚持住!
5.1wsgi文件配置
进入到项目根目录,新建app.wsgi文件,进行如下设置:
import sys
sys.path.insert(0,"C:\Users\***\PycharmProjects\bulletin_board")
from bulletin_board import app as application
5.2httpd.conf文件配置
再次进入到D:\Apache24\conf
,打开httpd.conf
文件,进行配置修改。
- 找到
Define SRVROOT "/Apache24"
修改成自己的安装路径,如”D:/Apache24″ - 将上面4.4节中的3行信息复制到最下方。
LoadFile "c:/users/***/anaconda3/python36.dll"
LoadModule wsgi_module "c:/users/***/anaconda3/lib/site-packages/mod_wsgi/server/mod_wsgi.cp36-win_amd64.pyd"
WSGIPythonHome "c:/users/chengyikang/anaconda3"
- 再添加如下内容,
C:\Users\***\PycharmProjects\bulletin_board
是我的项目所在目录,大家根据自己的项目进行调整:
WSGIPythonPath "C:\Users\***\PycharmProjects\bulletin_board"
<VirtualHost *:8063>
ServerName example.com
WSGIScriptAlias / C:\Users\***\PycharmProjects\bulletin_board\app.wsgi
<Directory C:\Users\***\PycharmProjects\bulletin_board>
Require all granted
</Directory>
</VirtualHost>
这块的知识我没有掌握,没法给大家讲清每一行的意义,可以参考官方文档和官方文档2进行学习。
5.3尝试运行
运行服务的方式有多种:
- 进入
C:\Apache24\bin
目录,打开ApacheMonitor.exe
,进行可视化操作:start
,stop
,restart
。
- 在
C:\Apache24\bin
目录下CMD打开命令行,输入httpd -k start
,停止服务器就输入httpd -k stop
,重启服务器输入httpd -k restart
。 - 通过运行栏,输入
services.msc
进入服务管理窗口,启动/停止/重启
刚才安装的Apache2.4服务。
6.一些问题
6.1 输入localhost:8063响应码500
有时候会访问服务器,浏览器会提示:500 Internal Server Error
,我们进入C:\Apache24\logs
打开error.log
错误日志分析原因,看不懂的百度下一般都可以解决。
[Tue Apr 26 23:12:34.887245 2022] [wsgi:error] [pid 14068:tid 1780] [client 127.0.0.1:14933] mod_wsgi (pid=14068): Failed to exec Python script file 'C:/Users/Chengyikang/PycharmProjects/bulletin_board/app.wsgi'.
[Tue Apr 26 23:12:34.887245 2022] [wsgi:error] [pid 14068:tid 1780] [client 127.0.0.1:14933] mod_wsgi (pid=14068): Exception occurred processing WSGI script 'C:/Users/Chengyikang/PycharmProjects/bulletin_board/app.wsgi'.
[Tue Apr 26 23:12:34.887245 2022] [wsgi:error] [pid 14068:tid 1780] [client 127.0.0.1:14933] File "C:/Users/Chengyikang/PycharmProjects/bulletin_board/app.wsgi", line 2\r
[Tue Apr 26 23:12:34.887245 2022] [wsgi:error] [pid 14068:tid 1780] [client 127.0.0.1:14933] sys.path.insert(0,"C:\\Users\\Chengyikang\\PycharmProjects\\bulletin_board")\r
[Tue Apr 26 23:12:34.887245 2022] [wsgi:error] [pid 14068:tid 1780] [client 127.0.0.1:14933] ^\r
[Tue Apr 26 23:12:34.887245 2022] [wsgi:error] [pid 14068:tid 1780] [client 127.0.0.1:14933] SyntaxError: (unicode error) 'unicodeescape' codec can't decode bytes in position 2-3: truncated \\UXXXXXXXX escape\r
我的报错是因为路径中\
转义符的问题,在字符串前面加上r
。
restart重启,查看问题是否修复。
6.2 RuntimeError: cryptography is required错误
如果项目中有“输入密码”选项,并用到了数据库保存密码,可能会报“RuntimeError: cryptography is required for sha256_password or caching_sha2_password”这个错误,这时候直接pip install cryptography
安装这个模块就可以了。
如果是离线安装,参照Python虚拟环境中的依赖包迁移到断网环境,但要注意安装的顺序:
pip install pycparser-2.21-py2.py3-none-any.whl
pip install cffi-1.15.0-cp36-cp36m-win_amd64.whl
pip install cryptography-36.0.2-cp36-abi3-win_amd64.whl
在安装cryptography-36.0.2-cp36-abi3-win_amd64.whl
时,会报错,因为文件名不支持,将abi3
改为none
即可。
原因分析参考Python使用pip安装报错:is not a supported wheel on this platform的解决方法。
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。
文章由极客之音整理,本文链接:https://www.bmabk.com/index.php/post/63034.html