Flask中的SERVER_NAME主要做兩件事：

• 協(xié)助Flask在活動(dòng)的請(qǐng)求（request）之外生成絕對(duì)URL（比如郵件中嵌入網(wǎng)站URL）
• 用于子域名支持

很多人誤以為它可以做這兩件事之外的其它事情。

一、第一件事：絕對(duì)URL
我們知道，url_for默認(rèn)情況下是生成相對(duì)URL，它有個(gè)參數(shù)_external，如果設(shè)置為真，則會(huì)生成一個(gè)絕對(duì)URL（就是HTTP開(kāi)頭帶域名等信息的）。若不指定SERVER_NAME，默認(rèn)使用當(dāng)前活動(dòng)的請(qǐng)求（request）來(lái)生成URL。

下面舉個(gè)例子演示一下：

# filename myapp.py
from flask import Flask, url_for

app = Flask(__name__)

@app.route('/')
def index():
 return 'hello flask'

@app.route('/test')
def test():
 return url_for('index', _external=True)

if __name__ == '__main__':
 app.run(debug=True)

1.【情景1】通過(guò)瀏覽器訪問(wèn)

app運(yùn)行之后，在本地5000端口監(jiān)聽(tīng)。

(env) F:\tmp>python myapp.py
 * Running on http://127.0.0.1:5000/
 * Restarting with reloader

若我們通過(guò)瀏覽器訪問(wèn)http://127.0.0.1:5000/test，則返回的內(nèi)容是：http://127.0.0.1:5000/。

若我們通過(guò)瀏覽器訪問(wèn)http://localhost:5000/test，則返回的內(nèi)容是：http://localhost:5000/。

可以看出，在未設(shè)置SERVER_NAME的情況下，url_for生成的絕對(duì)URL是依賴(lài)于請(qǐng)求的URL的。下面我們來(lái)看看不通過(guò)瀏覽器訪問(wèn)的情況。

2.【情景2】非瀏覽器訪問(wèn)

這個(gè)情景是指不存在request請(qǐng)求的情況。

我們通過(guò)Python Shell來(lái)模擬：

>>> from myapp import app
>>> with app.app_context():
... print url_for('index', _external=True)
...

Traceback (most recent call last):
 File "<stdin>", line 2, in <module>
 File "F:\tmp\env\lib\site-packages\flask\helpers.py", line 287, in url_for
 raise RuntimeError('Application was not able to create a URL '
RuntimeError: Application was not able to create a URL adapter for request indep
endent URL generation. You might be able to fix this by setting the SERVER_NAME
config variable.

上面的意思是說(shuō)應(yīng)用程序不能創(chuàng)建一個(gè)用于與request不相關(guān)的URL生成的URL適配器，可以通過(guò)設(shè)置SERVER_NAME來(lái)解決這個(gè)問(wèn)題。

好，下面我們?yōu)镾ERVER_NAME設(shè)置一個(gè)值之后再試試：

>>> app.config['SERVER_NAME'] = 'example.com'
>>> with app.app_context():
... print url_for('index', _external=True)
...

http://example.com/

PS: 一般SERVER_NAME設(shè)置為網(wǎng)站的域名。

在Flask-Mail相關(guān)的文章中有這么一段話：

許多Flask的擴(kuò)展都是假定自己運(yùn)行在一個(gè)活動(dòng)的應(yīng)用和請(qǐng)求上下文中，F(xiàn)lask-Mail的send函數(shù)使用到current_app這個(gè)上下文了，所以當(dāng)mail.send()函數(shù)在一個(gè)線程中執(zhí)行的時(shí)候需要人為的創(chuàng)建一個(gè)上下文，所有在send_async_email中使用了app.app_context()來(lái)創(chuàng)建一個(gè)上下文。

因此，若要生成不依賴(lài)于request的絕對(duì)URL（比如異步發(fā)送郵件時(shí)在郵件中生成網(wǎng)站某個(gè)頁(yè)面的URL），就必須要設(shè)置SERVER_NAME。

二、第二件事：子域名支持
SERVER_NAME鍵是用于子域名支持。因?yàn)?Flask 在得知現(xiàn)有服務(wù)器名之前不能猜測(cè)出子域名部分，所以如果你想使用子域名，這個(gè)選項(xiàng)必要的，并且也用于會(huì)話cookie。

請(qǐng)牢記不只有 Flask 存在不知道子域名的問(wèn)題，你的瀏覽器同樣存在這樣的問(wèn)題。 大多數(shù)現(xiàn)代 web 瀏覽器不允許服務(wù)器名不含有點(diǎn)的跨子域名 cookie。因此如果你的服務(wù)器的 名稱(chēng)為 localhost，你將不能為 localhost 和所有它的子域名設(shè)置一個(gè) cookie。 請(qǐng)選擇一個(gè)合適的服務(wù)器名，像 'myapplication.local'， 并添加你想要的服務(wù)器名 + 子域名 到你的 host 配置或設(shè)置一個(gè)本地 bind。
Examples

   -------->http://book.muxistudio.com
   ||
http://muxistudio.com-------->http://blog.muxistudio.com
   ||
   -------->http://share.muxistudio.com

1.本地測(cè)試

修改 /etc/hosts 文件

注意:僅在本地測(cè)試中有效！

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

127.0.0.1 flask.dev  localhost # 域名
127.0.0.1 test.flask.dev localhost # 子域名
127.0.0.1 othertest.flask.dev localhost # 子域名

在Flask應(yīng)用的配置文件中添加'SERVER_NAME'

在應(yīng)用配置中將'SERVER_NAME'設(shè)置為指定的域名及默認(rèn)監(jiān)聽(tīng)的端口，例:

#...
app = Flask(__name__)
app.config['SERVER_NAME'] = 'flask.dev:5000'
#...

2.配置藍(lán)圖

藍(lán)圖中的subdomain為hosts文件中所添加的子域名

#...
# Blueprint declaration
bp = Blueprint('subdomain', __name__, subdomain="<user>")

#...

# Register the blueprint into the application
app.register_blueprint(bp)
#...

3.服務(wù)器端配置

講Flask應(yīng)用設(shè)置中的'SERVER_NAME'修改為生產(chǎn)環(huán)境中注冊(cè)的域名

flask.dev:5000 ----> muxistudio.com

4.Nginx配置

配置監(jiān)聽(tīng)端口，下面的例子中使用正則表達(dá)式獲取用戶訪問(wèn)的子域名，對(duì)于www，應(yīng)該在正則表達(dá)式獲取時(shí)將其過(guò)濾，在用戶訪問(wèn)時(shí)對(duì)其進(jìn)行重定向至www.yourdomain.com頁(yè)面，否則www將會(huì)被視為子域名。

配置實(shí)例：

 server {
 listen 80;
 listen 443 ssl;

 ssl_certificate /usr/local/nginx/ssl/nginx.crt;
 ssl_certificate_key /usr/local/nginx/ssl/nginx.key;

 server_name ~^www\.(?<user>.+\.)?markdownblog\.com$;
 return 301 "$scheme://${user}markdownblog.com$request_uri";
 }

 server {
 listen 80;
 listen 443 ssl;

 ssl_certificate /usr/local/nginx/ssl/nginx.crt;
 ssl_certificate_key /usr/local/nginx/ssl/nginx.key;

 server_name ~^.+\.markdownblog\.com$ markdownblog.com;

 location / {
  proxy_set_header Host $http_host;
  proxy_set_header X-Real-IP $remote_addr;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  proxy_pass http://127.0.0.1:8085;
 }
}

最新評(píng)論