nginx Unit 服务器

时间  2019-11-12
标签 nginx unit 服务器 栏目 Nginx 繁體版
原文   原文链接

转自：
https://github.com/nginx/unit/pull/18/
感谢：
https://www.v2ex.com/t/389528php

English
简体中文
繁體中文前端

NGINX Unit

NGINX Unit 是一个动态的网络应用服务器，它的设计初衷就是可运行多种编程语言的。经过API能够轻巧，多面化的动态配置Unit。当工程师或操做者有须要时，能够轻松重构服务器已适配特殊的应用参数。python

NGINX Unit 如今是beta版本。你如今虽然可使用它，但建议仅用于测试环境，不建议用于生产环境。linux

本项目的源代码及分发均使用Apache 2.0 license。nginx

核心功能

  • 使用RESTful JSON API可完整的动态重配置服务器。
  • 可同时运行多语言及多版本的应用。
  • 动态语言的进程管理功能。 (敬请期待)
  • TLS 支持 (敬请期待)
  • TCP, HTTP, HTTPS, HTTP/2 路由和代理 (敬请期待)

Supported Application Languages

  • Python
  • PHP
  • Go
  • JavaScript/Node.js (敬请期待)
  • Java (敬请期待)
  • Ruby (敬请期待)

安装

系统需求

NGINX Unit 已被测试经过在如下系统上运行:git

  • Linux 2.6 或更高
  • FreeBSD 9 或更高
  • MacOS X
  • Solaris 11

系统架构:github

  • i386
  • amd64
  • powerpc
  • arm

NGINX Unit 支持不一样的编程语言，你能够选择下面列出的版本:golang

  • Python 2.6, 2.7, 3
  • PHP 5, 7
  • Go 1.6 or later

你能够在一个系统上运行不一样版本的相同编程语言。apache

安装包

你能够在CentOS 7.0 和 Ubuntu 16.04 LTS。上直接安装 NGINX Next编程

CentOS 安装

  1. 在 /etc/yum.repos.d/unit.repo 目录下创建文件，并包含如下内容:
[unit]
name=unit repo
baseurl=http://nginx.org/packages/mainline/centos/7/$basearch/
gpgcheck=0
enabled=1
  1. 安装Nginx Unit:
# yum install unit

Ubuntu 安装

  1. 下载key key 用于签名NGINX, Inc. 的源和包。

  2. 添加秘钥到 apt 程序里。程序将会认证NGINX源的签名，这样将会消除警告。

# sudo apt-key add nginx_signing.key
  1. 将下面两行写入文件尾部。
    /etc/apt/sources.list:
deb http://nginx.org/packages/mainline/ubuntu/ xenial nginx
deb-src http://nginx.org/packages/mainline/ubuntu/ xenial nginx
  1. 安装NGINX Unit:
# apt-get update
# apt-get install unit

源代码

本章将会完整的解释如何经过源代码安装NIGIX Unit。

得到源代码

你能够经过三种方法得到NGINX Unit的源代码: 从 NGINX, Inc.
的Mercurial源，Github，或从tarball得到源代码。

不管从那种方式得到源代码，你都可以在 unit 子目录中，找到咱们的源代码。

Mercurial源
  1. 若是你没有安装Mercurial软件。你须要先下载并安装它。
    示例：在 Ubuntu 系统下，运行下面的命令:
# apt-get install mercurial
  1. 下载NIGIX Unit的源代码:
# hg clone http://hg.nginx.org/unit
GitHub 源

  1. 若是你没有Git，请先移步Github帮助你安装Git
    GitHub 帮助文档。

  2. 下载NGINX Unit源:

# git clone https://github.com/nginx/unit
Tarball

NGINX Unit源代码请在如下连接得到
http://unit.nginx.org/download/

安装依赖软件

在配置和安装 NGINX Unit 以前，你必须现安装依赖文件和必要的工具。以及你但愿运行的编程语言。如 Go，PHP，和 Python。

Ubuntu 依赖安装
  1. 安装 build tools。
# apt-get install build-essential
  1. 若是想支持Go语言应用，请安装 golang 包。
# apt-get install golang
  1. 若是想支持PHP语言应用，请安装 php-dev 和 libphp-embed 包。
# apt-get install php-dev
# apt-get install libphp-embed
  1. 若是想支持Python语言应用，请安装 python-dev 包。
# apt-get install python-dev
CentOS 依赖
  1. 安装 build tools。
# yum install gcc make
  1. 若是想支持Go语言应用，请安装 golang 包。
# yum install golang
  1. 若是想支持PHP语言应用，请安装 php-devel 和 libphp-embedded 包。
# yum install php-devel php-embedded
  1. 若是想支持Python语言应用，请安装 python-devel 包。
# yum install python-devel

配置源代码

使用NGINX Unit，你能够同时运行不一样版本的编程语言。（Go，PHP，或者Python）。你须要配置一个separate（分区）。
NGINX Unit有不一样的模块。下面的命令会给不一样的模块建立分区。 Makefile

配置Go语言环境

NGINX Unit 会提供Go的依赖包，供你方便配置NGINX Unit内的Go使用环境。

  1. 使用下面的设置 GOPATH 的环境变量。
# export GOPATH=/home/user/go_apps
  1. 运行如下命令:
# ./configure go
configuring Go package
checking for Go ... found
 + go version go1.6.2 linux/amd64
 + Go package path: "/home/user/go_apps"
创建Go应用

  1. 定义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)

  2. 创建 GO应用。

    # go build

若是你直接运行Go应用，Go将会自动使用http.ListenandServe。若是使用NGINX Unit，启动Go程序，将会自动执行unit.ListenandServe。程序将会与Unit的路由进行交互。

配置PHP模块

配置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模块

配置特定的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:

  1. 确认GOPATH 环境变量已被正确设置。
# go env GOPATH

# export GOPATH=<path>
  1. 完成编译:
# 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"
          }

Go语言应用

对象 描述
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"
        }

PHP语言应用

对象 描述
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"
        },

Python语言应用

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来进行静态文件的处理和接受代理的请求。
NGINX服务器将直接处理静态文件的访问请求，动态文件的处理将会直接转发到NGINX Unit。
新建一个上传模块，在NGINX的配置中，将http的请求转发给Unit，示例：

upstream unit_backend {
    server 127.0.0.1:8300;
}

新建或修改NGINX的配置文件 server块和 location块 。指定的静态文件的路径和上传模块。

示例 1

这个例子适用于基于PHP编程语言开发的程序。，所有的URL请求，如已.php结尾，均会被转发至Unit服务器，其余的所有文件将会直接被服务器返回文件：

server {

    location / {
        root /var/www/static-data;
    }

    location ~ \.php$ {
        proxy_pass http://unit_backend;
        proxy_set_header Host $host;
    }
}

示例 2

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

默认状况下，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
或直接点击此处订阅
没错就是我。

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程