CentOS 平台安装
从包管理安装
OpenResty 现在提供了 CentOS 上的 官方包。 你只需运行下面的命令:
sudo yum-config-manager --add-repo https://openresty.org/yum/cn/centos/OpenResty.repo
sudo yum install openresty
如果一切顺利,OpenResty 应该已经安装好了。 接下来,我们就可以进入到后面的章节 HelloWorld 学习。
如果你想了解更多 OpenResty 上的细节,且不介意弄脏双手;抑或有自定义 OpenResty 安装的需求,可以往下看从源码安装的方式。
源码包准备
我们首先要在官网下载 OpenResty 的源码包。官网上会提供很多的版本,各个版本有什么不同也会有说明,我们可以按需选择下载。 笔者选择下载的源码包为 ngx_openresty-1.9.7.1.tar.gz(请大家跟进使用最新版本,这里只是个例子)。
依赖库安装
将这些相关的库perl 5.6.1+,libreadline, libpcre, libssl
安装在系统中。
按照以下步骤:
- 输入以下命令
yum install readline-devel pcre-devel openssl-devel perl
,一次性安装需要的库。 - 相关库安装成功。安装成功后会有 “Complete!” 字样。
OpenResty 安装
- 在命令行中切换到源码包所在目录。
- 解压源码包,
tar xzvf ngx_openresty-1.9.7.1.tar.gz
。若你下载的源码包版本不一样,将相应的版本号改为你所下载的即可。 - 切换工作目录到
cd ngx_openresty-1.9.7.1
。 - 了解默认激活的组件。OpenResty 官网有组件列表,我们可以参考,列表中大部分组件默认激活,也有部分默认不激活。 默认不激活的组件,我们可以在编译的时激活,后面步骤详说明。
配置安装目录及需要激活的组件。使用选项 --prefix=install_path,指定安装目录(默认为/usr/local/openresty)。
使用选项 --with-Components 激活组件,--without 则是禁止组件。 你可以根据自己实际需要选择 with 或 without。如下命令,OpenResty 将配置安装在 /opt/openresty 目录下(注意使用 root 用户),并激活
luajit
、http_iconv_module
并禁止http_redis2_module
组件。# ./configure --prefix=/opt/openresty\ --with-luajit\ --without-http_redis2_module \ --with-http_iconv_module
在上一步中,最后没有什么 error 的提示就是最好的。若有错误,最后会显示 具体原因可以看源码包目录下的
build/nginx-VERSION/objs/autoconf.err
文件查看。若没有错误,则会出现如下信息:Type the following commands to build and install: gmake gmake install
编译:根据上一步命令提示,输入
gmake
。- 安装:输入
gmake install
。 - 上面的步骤顺利完成之后,安装已经完成。可以在你指定的安装目录下看到一些相关目录及文件。
设置环境变量
为了后面启动 OpenResty 的命令简单一些,不用在 OpenResty 的安装目录下进行启动,我们设置环境变量来简化操作。
将 nginx 目录添加到 PATH 中。打开文件 /etc/profile,
在文件末尾加入export PATH=$PATH:/opt/openresty/nginx/sbin
,若你的安装目录不一样,则做相应修改。
注意:这一步操作需要重新加载环境变量才会生效,可通过命令source /etc/profile
或者重启服务器等方式实现。
接下来,我们就可以进入到后面的章节 HelloWorld 学习。