轉自:
https://github.com/nginx/unit/pull/18/
感謝:
https://www.v2ex.com/t/389528php
NGINX Unit 是一個動態的網絡應用服務器,它的設計初衷就是可運行多種編程語言的。經過API能夠輕巧,多面化的動態配置Unit。當工程師或操做者有須要時,能夠輕鬆重構服務器已適配特殊的應用參數。python
NGINX Unit 如今是beta版本。你如今雖然可使用它,但建議僅用於測試環境,不建議用於生產環境。linux
本項目的源代碼及分發均使用Apache 2.0 license。nginx
NGINX Unit 已被測試經過在如下系統上運行:git
系統架構:github
NGINX Unit 支持不一樣的編程語言,你能夠選擇下面列出的版本:golang
你能夠在一個系統上運行不一樣版本的相同編程語言。apache
你能夠在CentOS 7.0 和 Ubuntu 16.04 LTS。上直接安裝 NGINX Next編程
[unit] name=unit repo baseurl=http://nginx.org/packages/mainline/centos/7/$basearch/ gpgcheck=0 enabled=1
# yum install unit
下載key key 用於簽名NGINX, Inc. 的源和包。
添加祕鑰到 apt
程序裏。程序將會認證NGINX源的簽名,這樣將會消除警告。
# sudo apt-key add nginx_signing.key
deb http://nginx.org/packages/mainline/ubuntu/ xenial nginx deb-src http://nginx.org/packages/mainline/ubuntu/ xenial nginx
# apt-get update # apt-get install unit
本章將會完整的解釋如何經過源代碼安裝NIGIX Unit。
你能夠經過三種方法得到NGINX Unit的源代碼: 從 NGINX, Inc.
的Mercurial源,Github,或從tarball得到源代碼。
不管從那種方式得到源代碼,你都可以在 unit 子目錄中,找到咱們的源代碼。
# apt-get install mercurial
# hg clone http://hg.nginx.org/unit
若是你沒有Git,請先移步Github幫助你安裝Git
GitHub 幫助文檔。
下載NGINX Unit源:
# git clone https://github.com/nginx/unit
NGINX Unit源代碼請在如下連接得到
http://unit.nginx.org/download/
在配置和安裝 NGINX Unit 以前,你必須現安裝依賴文件和必要的工具。以及你但願運行的編程語言。如 Go,PHP,和 Python。
# apt-get install build-essential
golang
包。# apt-get install golang
php-dev
和 libphp-embed
包。# apt-get install php-dev # apt-get install libphp-embed
python-dev
包。# apt-get install python-dev
# yum install gcc make
golang
包。# yum install golang
php-devel
和 libphp-embedded
包。# yum install php-devel php-embedded
python-devel
包。# yum install python-devel
使用NGINX Unit,你能夠同時運行不一樣版本的編程語言。(Go,PHP,或者Python)。你須要配置一個separate(分區)。
NGINX Unit有不一樣的模塊。下面的命令會給不一樣的模塊建立分區。 Makefile
NGINX Unit 會提供Go的依賴包,供你方便配置NGINX Unit內的Go使用環境。
GOPATH
的環境變量。# export GOPATH=/home/user/go_apps
# ./configure go configuring Go package checking for Go ... found + go version go1.6.2 linux/amd64 + Go package path: "/home/user/go_apps"
定義Go的源文件,以適應NGINX Unit。
a. 在 import
區域,在尾行添加 "unit"
。
import { "fmt" "net/http" "unit" }
b. 在 main()
功能中, 註釋 http.ListenandServe
功能並添加 unit.ListenAndServe
功能。
func main() { http.HandleFunc("/", handler) //http.ListenAndServe(":8080", nil) unit.ListenAndServe(":8080", nil)
創建 GO應用。
# go build
若是你直接運行Go應用,Go將會自動使用http.ListenandServe。若是使用NGINX Unit,啓動Go程序,將會自動執行unit.ListenandServe。程序將會與Unit的路由進行交互。
配置PHP模塊。( php.unit.so) 運行下面的命令進行自動配置PHP:
# ./configure php
如須要配置不一樣版本的PHP,請使用下面的命令:
# ./configure php --module=<prefix> --config=<script-name> --lib-path=<pathname>
當
--module
設置文件名的前綴。Unit被設置爲特定的版本。( <prefix>.unit.so)。
--config
欽定的文件名, php-config 特定版本的PHP。
--lib-path
PHP的路徑。
實例:下面這個命令將會生成一個模塊 php70.unit.so 已適配PHP7.0
PHP 7.0:
# ./configure php --module=php70 \ --config=/usr/lib64/php7.0/php-config \ --lib-path=/usr/lib64/php7.0/lib64 configuring PHP module checking for PHP ... found + PHP version: 7.0.22-0ubuntu0.16.04.1 + PHP SAPI: [apache2handler embed cgi cli fpm] checking for PHP embed SAPI ... found + PHP module: php70.unit.so
配置特定的Python模塊,已適配NGINX Unit。 (叫 python.unit.so) 。
在操做系統的根目錄能夠找到configure,使用下面的命令。
# ./configure python
若是須要配置其餘的Python版本,請使用下面的命令。
# ./configure python --module=<prefix> --config=<script-name>
當
--module
會生成一個模塊,設置文件名的前綴。Unit被設置爲特定的版本, (就這麼簡單,將會生成一個
<prefix>.unit.so).
--config
欽定的文件名 python-config 將會生成特定版本的模塊。
示例:下面的命令將會生成一個名爲 py33.unit.so 已適配
Python 3.3:
# ./configure php --module=py33 \ --config=python-config-3.3 configuring Python module checking for Python ... found checking for Python version ... 3.3 + Python module: py33.unit.so
當完成NGINX Unit的PHP, Python模塊編譯後, 運行下面的命令:
# make all
編譯適用於Go語言的NGINX Unit:
GOPATH
環境變量已被正確設置。# go env GOPATH # export GOPATH=<path>
# make go-install
若是須要安裝完整的全面模塊和Go包,運行下面的命令:
# make install
默認狀況下,Control Socket內包含的的API來控制NGINX Unit
unit.control.sock.
每一個單獨的應用,你均可以在NGINX Unit的配置文件中,使用JSON語法來定義一個
applications
。使用JSON語法來定義裏面的內容,如使用的編程語言,須要的工做數,文件的本地路徑,以及其餘參數。
這個示例配置了一個PHP網站,名爲 blogs 而這個網站的本地路徑爲。 /www/blogs/scripts。默認頁面爲 index.php。
{ ... "applications": { "blogs": { "type": "php", "workers": 20, "root": "/www/blogs/scripts", "index": "index.php" } } }
當應用被經過HTTP訪問時,你必須定義至少一個監聽器 listeners
。監聽器是一個IP地址和一個被定義的端口,當用戶訪問時,Unit的監聽器會返回正確結果。IP地址能夠是一個完整的IP地址(示例,
127.0.0.1:8300
)或(示例,*:8300
).
在這個示例中,端口 8300 的請求所有會被髮送至 blogs
這個應用:
``` { "listeners": { "*:8300": { "application": "blogs" } }, ... } ```
完整的JSON語法細節,請點擊下面的連接。
JSON 詳細的監聽器配置和應用配置.
配置中至少須要包含一個監聽器和一個應用配置:
{ "listeners": { "*:8300": { "application": "blogs" } }, "applications": { "blogs": { "type": "php", "workers": 20, "root": "/www/blogs/scripts", "index": "index.php" } } }
你能夠建立一個配置文件,而且發送一個 PUT
請求。爲了減小發生錯誤的可能,當使用 curl
命令式,請包含 -d
選項。
經過下面的命令,能夠建立一個初始的配置文件
start.json :
# curl -X PUT -d @/path/to/start.json \ --unix-socket ./control.unit.sock http://localhost/
經過 wiki.json 咱們能夠建立一個 wiki 應用。
# curl -X PUT -d @/path/to/wiki.json \ --unix-socket ./control.unit.sock http://localhost/applications/wiki
wiki.json 裏包含了:
{ "type": "python", "workers": 10, "module": "wsgi", "user": "www-wiki", "group": "www-wiki", "path": "/www/wiki" }
要顯示配置的對象,它被附加在curl
的URL內。
若是你想顯示完整的配置文件,你能夠經過下面的指令來查看:
# curl --unix-socket ./control.unit.sock http://localhost/ { "applications": { "blogs": { "type": "php", "user": "nobody", "group": "nobody", "workers": 20, "root": "/www/blogs/scripts", "index": "index.php" }, "wiki": { "type": "python", "user": "nobody", "group": "nobody", "workers": 10, "path": "/www/wiki", "module": "wsgi" } }, "listeners": { "*:8300": { "application": "blogs" }, "*:8400": { "application": "wiki" } } }
顯示 wiki 這個應用的配置,只需:
# curl --unix-socket ./control.unit.sock http://localhost/applications/wiki { "type": "python", "workers": 10, "module": "wsgi", "user": "www", "group": "www", "path": "/www/wiki" }
要更改配置的對象,使用 curl
命令和-d
選項來實現特定的對象的JSON數據,而後發送一個PUT
請求。
在端口 *:8400上修改 application
應用指向 wiki-dev:
# curl -X PUT -d '"wiki-dev"' --unix-socket ./control.unit.sock \ 'http://localhost/listeners/*:8400/application' { "success": "Reconfiguration done." }
修改root
對象的 blogs 應用的本地路徑至
/www/blogs-dev/scripts:
# curl -X PUT -d '"/www/blogs-dev/scripts"' \ --unix-socket ./control.unit.sock \ http://localhost/applications/blogs/root { "success": "Reconfiguration done." }
要刪除配置的對象,你能夠經過 curl
發送一個DELETE
請求到對象目錄。
刪除對 *:8400 端口的監聽:
# curl -X DELETE --unix-socket ./control.unit.sock \ 'http://localhost/listeners/*:8400' { "success": "Reconfiguration done." }
對象 | 描述 |
---|---|
<IP地址>:<端口> |
IP地址和端口需在不一樣的Unit監聽器上均須要配置應用的名字 ,IP地址能夠是完整的 (127.0.0.1:8300 ) 或者(*:8300 ). |
application |
應用名。 |
示例:
"*:8300": { "application": "blogs" }
對象 | 描述 |
---|---|
type |
應用的編程語言 (go )。 |
workers |
應用的工做數量。 |
executable |
完整的本地路徑。 |
user (optional) |
運行進程的用戶,如未定義,則默認(nobody)。 |
group (optional) |
用戶所在的用戶組 。如未定義,則默認。 |
示例:
"go_chat_app": { "type": "go", "executable": "/www/chat/bin/chat_app", "user": "www-go", "group": "www-go" }
對象 | 描述 |
---|---|
type |
應用的編程語言 (php ). |
workers |
應用的工做數量。 |
root |
文件的本地路徑。 |
index |
默認的index文件路徑。 |
script (optional) |
訪問Unit內任意的URL均會運行,填寫路徑將不要填寫物理路徑,請填寫虛擬路徑。 |
user (optional) |
運行進程的用戶,如未定義,則默認(nobody)。 |
group (optional) |
用戶所在的用戶組 。如未定義,則默認。 |
示例:
"blogs": { "type": "php", "workers": 20, "root": "/www/blogs/scripts", "index": "index.php", "user": "www-blogs", "group": "www-blogs" },
Object | Description |
---|---|
type |
應用的編程語言 (python )。 |
workers |
應用的工做數量。 |
path |
wsgi.py 的路徑。 |
module |
必填。目前只支持 wsgi 。 |
user (optional) |
運行進程的用戶,如未定義,則默認(nobody)。 |
group (optional) |
用戶所在的用戶組 。如未定義,則默認。 |
示例:
"shopping_cart": { "type": "python", "workers": 10, "path": "/www/store/cart", "module": "wsgi", "user": "www", "group": "www" },
{ "listeners": { "*:8300": { "application": "blogs" }, "*:8400": { "application": "wiki" }, "*:8401": { "application": "shopping_cart" }, "*:8500": { "application": "go_chat_app" } }, "applications": { "blogs": { "type": "php", "workers": 20, "root": "/www/blogs/scripts", "user": "www-blogs", "group": "www-blogs", "index": "index.php" }, "wiki": { "type": "python", "workers": 10, "user": "www-wiki", "group": "www-wiki", "path": "/www/wiki" }, "shopping_cart": { "type": "python", "workers": 10, "module": "wsgi", "user": "www", "group": "www", "path": "/www/store/cart" }, "go_chat_app": { "type": "go", "user": "www-chat", "group": "www-chat", "executable": "/www/chat/bin/chat_app" } } }
配置NGINX來進行靜態文件的處理和接受代理的請求。
NGINX服務器將直接處理靜態文件的訪問請求,動態文件的處理將會直接轉發到NGINX Unit。
新建一個上傳模塊,在NGINX的配置中,將http的請求轉發給Unit,示例:
upstream unit_backend { server 127.0.0.1:8300; }
新建或修改NGINX的配置文件 server
塊和 location
塊 。指定的靜態文件的路徑和上傳模塊。
這個例子適用於基於PHP編程語言開發的程序。,所有的URL請求,如已.php結尾,均會被轉發至Unit服務器,其餘的所有文件將會直接被服務器返回文件:
server { location / { root /var/www/static-data; } location ~ \.php$ { proxy_pass http://unit_backend; proxy_set_header Host $host; } }
All other requests will be proxied to Unit:
下面的應用,所有都靜態文件須要被放置在/var/www/files
目錄下,在前端調用時,請直接使用/static
。
server { location /static { root /var/www/files; } location / { proxy_pass http://unit_backend; proxy_set_header Host $host; } }
相關的NGINX 文檔將會在http://nginx.org提供。
相關的支持和更多的功能將在https://www.nginx.com上提供。
默認狀況下,Unit的API將會在Unix domain socket下。若是你但願API能夠被遠程訪問,你須要使用NGINX配置代理。
NGINX 能夠提供安全的、可信的和可控制的API
使用下面的示例配置來配置NGINX:
server { # Configure SSL encryption server 443 ssl; ssl_certificate /path/to/ssl/cert.pem; ssl_certificate_key /path/to/ssl/cert.key; # Configure SSL client certificate validation ssl_client_certificate /path/to/ca.pem; ssl_verify_client on; # Configure network ACLs #allow 1.2.3.4; # Uncomment and change to the IP addresses and networks # of the administrative systems. deny all; # Configure HTTP Basic authentication auth_basic on; auth_basic_user_file /path/to/htpasswd.txt; location / { proxy_pass http://unix:/path/to/control.unit.sock } }
NGINX Unit的發佈和分發均使用Apache 2.0 license。
若是想貢獻本身的力量,你能夠選擇經過郵件unit@nginx.org
或者在Github上提交PRhttps://github.com/nginx/unit。
若是在中文翻譯方面須要改近請聯繫@tuzimoe。
Unit 日誌通常在默認的位置,能夠在/var/log/unit.log
中找到。
Log 文件的位置也能夠經過運行 unitd --help
來快速定位。
詳細的Debug日誌能夠經過輸入命令來得到:
./configure --debug
輸入完命令後,請務必從新編譯和重裝NGINX Unit。
請注意,debug日誌的內容將會以快速的增加。
社區郵箱的列表將會在unit@nginx.org上找到。
訂閱郵箱列表,能夠經過發送任何內容至訂閱
unit-subscribe@nginx.org
或直接點擊此處訂閱
沒錯就是我。