Difference between revisions of "Nginx (简体中文)"

From ArchWiki
Jump to: navigation, search
(Error: The page you are looking for is temporarily unavailable. Please try again later.)
(Error: No input file specified)
Line 146: Line 146:
 
另外一个原因是, nginx.conf 的 "location ~ \.php$" 段有错误的 "root" 参数, 请保证在同一个服务器内 "root" 与 "location /" 指向同一个目录. 或者把 root 设为全局, 不在其它的位置部分定义.
 
另外一个原因是, nginx.conf 的 "location ~ \.php$" 段有错误的 "root" 参数, 请保证在同一个服务器内 "root" 与 "location /" 指向同一个目录. 或者把 root 设为全局, 不在其它的位置部分定义.
  
记住 php 脚本路径默认是 /srv/www/nginx/html ,在 /etc/php/php.ini 文件内的变量 "open_basedir" 中定义, 请按需更改.
+
记住 php 脚本路径默认是 {{ic|/srv/www/nginx/html}} ,在 {{ic|/etc/php/php.ini}} 文件内的变量 {{ic|open_basedir}} 中定义, 请按需更改。
 +
 
 +
并且请注意不仅 PHP 脚本要有读取权限,它的路径结构也要有可执行权限,这样 PHP 用户才可以遍历目录。
  
 
==参考文献==
 
==参考文献==

Revision as of 16:35, 23 March 2013

Nginx (读作"engine X") 由Igor Sysoev(俄罗斯)于2005年编写,是一个免费、开源、高性能的HTTP服务器和反向代理,也可以作为一个IMAP/POP3代理服务器。根据 Netcraft 的 March 2013 Web Server Survey, 现在全世界13.53%的网站使用Nginx,而Apache占54.68%。Nginx因为稳定,丰富的功能集,配置简单,资源占用低而闻名世界。

安装

安装位于官方仓库nginx 软件包。

# pacman -S nginx

针对 Ruby on Rails 的安装参见 The Perfect Rails Setup.

启动服务

要启动Nginx服务,运行以下命令:

# systemctl start nginx

要Nginx服务开机时启动,运行以下命令:

# systemctl enabel nginx

http://127.0.0.1 的默认页面是:

/usr/share/nginx/html/index.html

配置

你可以修改在/etc/nginx/目录中的文件来更改配置./etc/nginx/nginx.conf是主配置文件.更多的细节可以参考Nginx 配置范例.

FastCGI

FastCGI,也称为FCGI,是一个外部服务与Web服务器的接口协议。FastCGI是早期的通用网关接口(CGI)的增强版本。 FastCGI致力于减少网页服务器与CGI程序之间的开销,从而使服务器可以同时处理更多的网页请求。

Nginx为了许多外部工具和服务而引入FastCGI技术,例如Perl, PHPPython。所以,在FastCGI服务启动之前,它们都是不能使用的。

PHP 集成

有不同的方式可以启动PHP FastCGI服务,我们将介绍php-fpm.这也是推荐的方案.

第一步: PHP 配置

/etc/php/php.ini中的open_basedir中列出包含PHP文件的基本目录,如/srv/http//usr/share/webapps/:

open_basedir = /usr/share/webapps/:/srv/http/:/home/:/tmp/:/usr/share/pear/
第二步: 安装 php-fpm

安装php-fpm.配置文件在/etc/php/php-fpm.conf。使用Systemd 启动并允许开机启动php-fpm

第三步: Nginx 配置

在每一个提供PHP Web应用程序的server块中都应该有一个location块,类似于下面:

 location ~ \.php$ {
      fastcgi_pass   unix:/run/php-fpm/php-fpm.sock;
      fastcgi_index  index.php;
      include        fastcgi.conf;
 }

你可以创建一个/etc/nginx/php.conf,并保存该配置,然后在需要的时候包含此文件到server块:

 server = {
     ...
     include  php.conf;
     ...
 }

如果你要使用 PHP 处理 .html 和 .htm 文件,你应该类似于这样:

 location ~ \.(php|html|htm)$ {
      fastcgi_pass   unix:/var/run/php-fpm/php-fpm.sock;
      fastcgi_index  index.php;
      include        fastcgi.conf;
 }

php-fpm 处理非PHP文件,应该明确地在 /etc/php/php-fpm.conf 中启用:

security.limit_extensions = .php .html .htm

如果你更改了配置文件,你需要重新启动php-fpm:

# systemctl restart php-fpm

注意这里的 fastcgi_pass 参数,因为它必须是所选择的FastCGI服务器在其配置文件中定义的TCP或Unix套接字.默认的 Unix php-fpm 是:

fastcgi_pass unix:/run/php-fpm/php-fpm.sock;

或者,你可以使用常用的TCP套接字,不是默认:

fastcgi_pass 127.0.0.1:9000;

使用Unix域套接字要更好一些。

通常都要包含 fastcgi.conf 或者 fastcgi_params,因为它们包含了 Nginx 的 FastCGI 设置(使用后者是不推荐的)。它们是安装 Nginx 时附带的。

最后,如果Nginx正在工作,运行以下命令:

# systemctl restart nginx

如果你想测试 FastCGI 是否可以使用,创建/usr/share/nginx/html/index.php,内容为:

<?php
  phpinfo ();
?>

然后在你的浏览器中访问 http://127.0.0.1/index.php 查看。

安装 phpMyAdmin

请看这篇 wiki 文章: PhpMyAdmin#NGINX_Configuration.

安全

  • 基于IP的访问限制

ngx_http_access_module

  • HTTP 认证

ngx_http_auth_basic_module

  • HTTPS 支持

ngx_http_ssl_module

疑难解答

访问本地的IP重定向到本地主机

解决方法在这: forum.

编辑 /etc/nginx/nginx.conf 找到 "server_name localhost" 没有被 # 注释掉的这行, 添加以下内容:

server_name_in_redirect off;

默认的行为是 nginx 重定向所有请求到在配置中 server_name 指定的值.

Error: 403 (Permission error)

这极有可能是一个权限错误. 你能肯定无论哪个在 Nginx 配置文件中配置的用户能读取到正确的文件吗?

如果文件位于 home 目录, (例如 /home/arch/public/webapp) 而且你能肯定运行 Nginx 的用户有正确的权限(为了测试这个可以暂时把所有文件 chmod 为 777), /home/arch 可能是 chmod 750, 只需要简单地把它 chmod751, 这样就应该正常工作了.

如果你修改过 document root

如果你确定权限都正确,确定一下你的 document root 目录是非空的。在那儿创建一个 index.html 试一试。

Error: The page you are looking for is temporarily unavailable. Please try again later.

这是因为 FastCGI server 还没启动。或者socket权限不正确。

Error: No input file specified

大多是因为你没有在 SCRIPT_FILENAME 中包含脚本的全路径. 如果 nginx 上的配置 (fastcgi_param SCRIPT_FILENAME) 是正确的, 这种错误意味着 php 加载请求脚本失败. 通常这是一个简单的权限问题, 只需用 root 运行 php-cgi

# spawn-fcgi -a 127.0.0.1 -p 9000 -f /usr/bin/php-cgi

或者可以创建一些组和用户来启动 php-cgi. 例如:

# groupadd www
# useradd -g www www
# chmod +w /srv/www/nginx/html
# chown -R www:www /srv/www/nginx/html
# spawn-fcgi -a 127.0.0.1 -p 9000 -u www -g www -f /usr/bin/php-cgi

另外一个原因是, nginx.conf 的 "location ~ \.php$" 段有错误的 "root" 参数, 请保证在同一个服务器内 "root" 与 "location /" 指向同一个目录. 或者把 root 设为全局, 不在其它的位置部分定义.

记住 php 脚本路径默认是 /srv/www/nginx/html ,在 /etc/php/php.ini 文件内的变量 open_basedir 中定义, 请按需更改。

并且请注意不仅 PHP 脚本要有读取权限,它的路径结构也要有可执行权限,这样 PHP 用户才可以遍历目录。

参考文献