Nginx/zh-cn

nginx是一个稳定、轻量、高性能的web服务器以及反向代理服务器. 它和Apache、lighttpd都是很好的常用的web服务器.

安装
在安装 包之前，首先请仔细查看Nginx包的USE标记.

扩展USE标记
Nginx使用模块来增加它的功能. 为了简化其模块的维护工作，nginx ebuild使用扩展USE ( USE_EXPAND )标记来指明应该安装哪些模块.


 * HTTP相关的模块可以通过设置 NGINX_MODULES_HTTP 变量使其生效
 * 邮件相关的模块可以通过设置 NGINX_MODULES_MAIL 变量使其生效
 * 第三方模块需要设置 NGINX_ADD_MODULES 变量

这些变量需要在 中进行设置. 关于它们的描述可以参看 和.

例如，为了使  模块生效：

上面的操作会覆盖默认 NGINX_MODULES_HTTP 的默认值，并且把他设置为. 要开启 模块且不覆盖 NGINX_MODULES_HTTP 的默认值，你需要使用USE标志:

Emerge
设置完毕USE标记后，安装：

验证安装
nginx默认的配置文件定义一个虚拟服务器，根目录设置为. 但是由于，nginx ebuild只会创建 目录，而没有index文件. 要具有可用的默认配置，请创建 目录和简单的index文件：

nginx包安装了一个初始化服务的脚本，允许管理员开始、停止或者重新运行该服务. 运行下列命令来开启nginx服务：

若要验证nginx已经正确安装，需打开浏览器并输入http://localhost地址，或使用命令行式的web工具，如：

配置
nginx使用文件来管理配置.

单站点访问
下面展示了一个不使用动态特性（如PHP）来进行单站点访问的例子.

多站点访问
可以使用 指令将配置文件分割成多个：

PHP支持
在nginx配置文件中加入下列配置来启用PHP支持. 在这个例子中，nginx通过UNIX套接字与PHP进程通信.

为了支持上述配置，PHP需要在编译时开启 USE标记，以加入FastCGI进程管理器（FastCGI Process Manager）支持（即）.

开启 USE标记后，重新编译PHP：

For PHP 7.0 and newer PHP versions use following configuration:

在文件 中设置php-fpm的时区. 将下面例子中的 替换为正确的时区信息：

启动 守护进程：

将 加入default runlevel：

重新加载 配置文件：

Alternatively, for systemd:

IP地址访问列表
下面的例子说明了如何使一个特定的URL地址（本例中为“”）只能被：


 * 当前主机（比如192.0.2.1 127.0.0.1）
 * 以及IP段（198.51.100.0/24）

基础的授权方式
nginx允许通过验证用户名和密码来限制资源的访问：

The file can be generated using:

第三方模块
下载第三方模块后，将其移动至. 手动编译选中的Nginx模块，并将下列配置加入 ：

重新编译 nginx 以添加第三方模块：

OpenRC
启动nginx：

停止nginx：

将nginx添加至default runlevel：

Reload nginx configuration without dropping connections:

重启nginx服务：

systemd
Start nginx web server:

Stop nginx web server:

Check the status of the service:

Enable service to start automatically on system reboot:

Reload nginx configuration without dropping connections:

Restart the nginx service:

故障排除
当遇到问题时，下列命令可以帮助你定位故障.

验证配置
验证正在运行的nginx配置没有故障：

在运行时添加  选项，它会自动验证配置文件的正确性，而并不会真正启动守护进程.

验证进程正在运行
验证进程正在运行：

验证绑定的地址和端口
验证nginx服务正在监听正确的TCP端口（如HTTP使用的80端口，或者HTTPS使用的443端口）：

另请参阅

 * Apache - 最常用的HTTP服务器.
 * Lighttpd - 一个快速、轻量的web服务器.

外部资源

 * https://nginx.org/en/docs/beginners_guide.html -  新手指南. 对于  所知不多的新手有所帮助.
 * https://nginx.com/resources/admin-guide/ - 管理指南. 有助于这个领域的web管理员.
 * https://wiki.nginx.org/Main - nginx维基.
 * https://github.com/h5bp/server-configs-nginx - H5BP nginx配置.