前因:公司项目用到了淘宝的nginx-http-concat,导致本地PHP跑项目前端页面的js/css无法加载出来。设备是mac,当初为了省事直接用homebrew 安装的Nginx,不支持安装第三方模块(homebrew有个nginx-full似乎也是可以实现,后面再验证)。homebrew折腾了半天还是决定放弃,采用nginx编译安装来实现,一套走下来发现也没想象中麻烦,步骤如下。
准备工作
卸载homebrew中的nginx
brew list #查看brew安装列表
brew uninstall nginx #卸载nginx
安装包
下载 Nginx 源码包
下载页: http://nginx.org/en/download.html
当前稳定版本: http://nginx.org/download/nginx-1.8.1.tar.gz
zlib
下载页: http://zlib.net/
当前稳定版本: http://zlib.net/zlib-1.2.8.tar.gz
注: Nginx 参考文档中提到需要 1.1.3 以上版本的 zlib
pcre
下载页: http://www.pcre.org/
当前稳定版本: ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/pcre-8.38.tar.gz
注: Nginx 参考文档中提到需要 4.4 以上版本的 pcre
concat
下载页:https://github.com/alibaba/nginx-http-concat
配置及安装
First, 进入到包所在的文件夹内(也可以直接到下载目录手动解压)
tar zxvf zlib-1.2.8.tar.gz # 得到 zlib-1.2.8 目录
tar zxvf pcre-8.36.tar.gz # 得到 pcre-8.36 目录
tar zxvf nginx-http-concat.tar.gz # 得到 concat 目录
编译安装 Nginx
这里会将各依赖的源码编译进 Nginx, 所以 --with-zlib 和 --with-pcre 后为对应的依赖源码目录路径。此外, 编译选项中还开启了 HTTPS 的协议支持--with-http_ssl_module, 若不需要 HTTPS, 可取消该选项。
注意:观察自己下载的版本号,操作的时候对应版本号,然后就是make的过程中如果有error 需要先处理掉。
tar zxvf nginx-1.8.0.tar.gz
cd nginx-1.8.0
./configure --prefix=/usr/local/nginx --with-zlib=../zlib-1.2.8 --with-pcre=../pcre-8.36 --with-openssl=你的openssl文件夹路径 --add-module=你的concat文件夹路径 (2种写法,也可参考下面指令示例)
make
sudo make install
其他安装指令(可做了解)
nginx大部分常用模块,编译时./configure --help以--without开头的都默认安装。
--prefix=PATH : 指定nginx的安装目录。默认 /usr/local/nginx
--conf-path=PATH : 设置nginx.conf配置文件的路径。nginx允许使用不同的配置文件启动,通过命令行中的-c选项。默认为prefix/conf/nginx.conf
--user=name: 设置nginx工作进程的用户。安装完成后,可以随时在nginx.conf配置文件更改user指令。默认的用户名是nobody。--group=name类似
--with-pcre : 设置PCRE库的源码路径,如果已通过yum方式安装,使用--with-pcre自动找到库文件。使用--with-pcre=PATH时,需要从PCRE网站下载pcre库的源码(版本4.4 - 8.30)并解压,剩下的就交给Nginx的./configure和make来完成。perl正则表达式使用在location指令和 ngx_http_rewrite_module模块中。
--with-zlib=PATH : 指定 zlib(版本1.1.3 - 1.2.5)的源码解压目录。在默认就启用的网络传输压缩模块ngx_http_gzip_module时需要使用zlib 。
--with-http_ssl_module : 使用https协议模块。默认情况下,该模块没有被构建。前提是openssl与openssl-devel已安装
--with-http_stub_status_module : 用来监控 Nginx 的当前状态
--with-http_realip_module : 通过这个模块允许我们改变客户端请求头中客户端IP地址值(例如X-Real-IP 或 X-Forwarded-For),意义在于能够使得后台服务器记录原始客户端的IP地址
--add-module=PATH : 添加第三方外部模块,如nginx-sticky-module-ng或缓存模块。每次添加新的模块都要重新编译(Tengine可以在新加入module时无需重新编译)
比如:
./configure \
--prefix=/usr \
--sbin-path=/usr/sbin/nginx \
--conf-path=/etc/nginx/nginx.conf \
--error-log-path=/var/log/nginx/error.log \
--http-log-path=/var/log/nginx/access.log \
--pid-path=/var/run/nginx/nginx.pid \
--lock-path=/var/lock/nginx.lock \
--user=nginx \
--group=nginx \
--with-http_ssl_module \
--with-http_stub_status_module \
--with-http_gzip_static_module \
--http-client-body-temp-path=/var/tmp/nginx/client/ \
--http-proxy-temp-path=/var/tmp/nginx/proxy/ \
--http-fastcgi-temp-path=/var/tmp/nginx/fcgi/ \
--http-uwsgi-temp-path=/var/tmp/nginx/uwsgi \
--with-pcre=../pcre-7.8 \
--with-zlib=../zlib-1.2.3 \
--with-openssl=你的openssl文件夹路径(部分模块需要有这个,下载后解压到一个后指向即可,下载地址https://www.openssl.org/source/) \
--add-module=你的concat文件夹路径 \
设置监听
进入配置文件/usr/local/nginx/conf/nginx.conf ,修改listen下参数:
server {
listen 85; #监听端口
server_name localhost; #监听服务器
#charset koi8-r;
#access_log logs/host.access.log main;
location / {
root html;
index index.html index.htm;
}
#error_page 404 /404.html;
# redirect server error pages to the static page /50x.html
#
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root html;
}
}
启动nginx
cd /usr/local/nginx
#启动(需要找到正确的nginx启动程序,才能生效)
sudo sbin/nginx #浏览器访问 127.0.0.1 测试是否成功启动
PS:上面路径如果不对,可以试试 sudo /usr/sbin/nginx
sudo sbin/nginx -s reload #重启
sudo sbin/nginx -s stop #停止
PS:最后,请注意在nginx配置,检查是否开启了concat的配置,这里被把我坑到了。