Python的Flask框架中SERVER_NAME域名项的配置教程

flask中的server_name主要做两件事：

• 协助flask在活动的请求（request）之外生成绝对url（比如邮件中嵌入网站url）
• 用于子域名支持

很多人误以为它可以做这两件事之外的其它事情。

一、第一件事：绝对url
我们知道，url_for默认情况下是生成相对url，它有个参数_external，如果设置为真，则会生成一个绝对url（就是http开头带域名等信息的）。若不指定server_name，默认使用当前活动的请求（request）来生成url。

下面举个例子演示一下：

1.【情景1】通过浏览器访问

app运行之后，在本地5000端口监听。

若我们通过浏览器访问http://127.0.0.1:5000/test，则返回的内容是：http://127.0.0.1:5000/。

若我们通过浏览器访问http://localhost:5000/test，则返回的内容是：http://localhost:5000/。

可以看出，在未设置server_name的情况下，url_for生成的绝对url是依赖于请求的url的。下面我们来看看不通过浏览器访问的情况。

2.【情景2】非浏览器访问

这个情景是指不存在request请求的情况。

我们通过python shell来模拟：

上面的意思是说应用程序不能创建一个用于与request不相关的url生成的url适配器，可以通过设置server_name来解决这个问题。

好，下面我们为server_name设置一个值之后再试试：

ps: 一般server_name设置为网站的域名。

在flask-mail相关的文章中有这么一段话：

许多flask的扩展都是假定自己运行在一个活动的应用和请求上下文中，flask-mail的send函数使用到current_app这个上下文了，所以当mail.send()函数在一个线程中执行的时候需要人为的创建一个上下文，所有在send_async_email中使用了app.app_context()来创建一个上下文。

因此，若要生成不依赖于request的绝对url（比如异步发送邮件时在邮件中生成网站某个页面的url），就必须要设置server_name。

二、第二件事：子域名支持
server_name键是用于子域名支持。因为 flask 在得知现有服务器名之前不能猜测出子域名部分，所以如果你想使用子域名，这个选项必要的，并且也用于会话cookie。

请牢记不只有 flask 存在不知道子域名的问题，你的浏览器同样存在这样的问题。 大多数现代 web 浏览器不允许服务器名不含有点的跨子域名 cookie。因此如果你的服务器的 名称为 localhost，你将不能为 localhost 和所有它的子域名设置一个 cookie。 请选择一个合适的服务器名，像 'myapplication.local'， 并添加你想要的服务器名 + 子域名 到你的 host 配置或设置一个本地 bind。
examples

1.本地测试

修改 /etc/hosts 文件

注意:仅在本地测试中有效！

将所有需要使用的子域名添加到其中，例:

在flask应用的配置文件中添加'server_name'

在应用配置中将'server_name'设置为指定的域名及默认监听的端口，例:

2.配置蓝图

蓝图中的subdomain为hosts文件中所添加的子域名

3.服务器端配置

讲flask应用设置中的'server_name'修改为生产环境中注册的域名

4.nginx配置

配置监听端口，下面的例子中使用正则表达式获取用户访问的子域名，对于www，应该在正则表达式获取时将其过滤，在用户访问时对其进行重定向至www.yourdomain.com页面，否则www将会被视为子域名。

配置实例：