openresty是集成lua的高性能nginx增强版,提供五种安装方式:一、yum(centos/rhel);二、apt(ubuntu/debian);三、源码编译(自定义模块);四、离线rpm(内网部署);五、验证启停服务。

如果您希望在Linux系统中部署高性能Web服务并集成Lua脚本能力,则OpenResty是Nginx的增强发行版,内置Lua运行时与常用模块。以下是多种可行的安装方法:
一、使用包管理器安装(推荐)
该方式由OpenResty官方维护,自动处理依赖关系、安装路径规范,且便于后续升级维护,适用于联网环境下的主流发行版。
1、对于CentOS/RHEL系统:
执行命令添加OpenResty官方YUM仓库并安装核心组件与命令行工具。
2、运行以下命令安装依赖管理工具:
sudo yum install -y yum-utils
3、添加OpenResty仓库:
sudo yum-config-manager --add-repo https://openresty.org/package/centos/openresty.repo
4、安装OpenResty主程序:
sudo yum install -y openresty
5、可选安装命令行工具resty:
sudo yum install -y openresty-resty
二、APT方式安装(Ubuntu/Debian)
该方式适配Debian系系统,通过导入GPG签名密钥与配置受信APT源,确保软件包完整性与来源可信。
1、下载并导入OpenResty官方GPG公钥:
wget -O - https://openresty.org/package/pubkey.gpg | sudo gpg --dearmor -o /usr/share/keyrings/openresty.gpg
2、创建APT源列表文件:
echo "deb [signed-by=/usr/share/keyrings/openresty.gpg] http://openresty.org/package/debian $(lsb_release -sc) openresty" | sudo tee /etc/apt/sources.list.d/openresty.list
3、更新软件包索引:
sudo apt update
4、安装OpenResty:
sudo apt install -y openresty
三、源码编译安装(自定义构建)
该方式适用于需启用特定第三方模块、禁用默认模块、或使用尚未发布到仓库的开发版本等高级场景,要求手动管理依赖与编译参数。
1、安装基础编译依赖:
CentOS/RHEL执行:
sudo yum install -y gcc make git pcre-devel openssl-devel readline-devel
2、Ubuntu/Debian执行:
sudo apt install -y build-essential git libpcre3-dev libssl-dev libreadline-dev
3、下载指定版本源码包(以1.25.3.1为例):
wget https://openresty.org/download/openresty-1.25.3.1.tar.gz
4、解压并进入源码目录:
tar -zxvf openresty-1.25.3.1.tar.gz && cd openresty-1.25.3.1
5、执行configure脚本,指定安装路径与所需模块:
./configure --prefix=/usr/local/openresty --with-http_ssl_module --with-http_realip_module
6、编译并安装:
make && sudo make install
四、离线环境安装(内网部署)
该方式适用于无外网访问权限的生产内网环境,需提前在有网机器下载全部依赖RPM包与OpenResty主包,并统一传输至目标主机。
1、在同版本同架构的联网机器上,使用yumdownloader获取完整依赖链:
sudo yum install -y yum-plugin-downloadonly
2、下载openresty及其所有依赖RPM包:
yumdownloader --resolve --destdir ./openresty-pkgs openresty
3、将整个openresty-pkgs目录拷贝至目标离线主机的/usr/local目录下。
4、在目标主机执行批量安装:
cd /usr/local/openresty-pkgs && sudo rpm -Uvh *.rpm --force --nodeps
5、验证安装路径是否存在OpenResty二进制文件:
ls /usr/local/openresty/nginx/sbin/nginx
五、验证与基础服务启停
无论采用何种安装方式,安装完成后均需确认服务状态并完成首次启动,确保Nginx主进程与OpenResty Lua运行时正常加载。
1、检查OpenResty默认安装路径下的nginx二进制文件:
/usr/local/openresty/nginx/sbin/nginx -v
2、启动OpenResty服务(非systemd托管时):
/usr/local/openresty/nginx/sbin/nginx -c /usr/local/openresty/nginx/conf/nginx.conf
3、如已配置systemd服务单元文件,则启用开机自启:
sudo systemctl enable openresty && sudo systemctl start openresty
4、检查监听端口是否生效:
sudo ss -tuln | grep ':80'
5、验证默认欢迎页是否可访问:
curl -I http://127.0.0.1










