OpenResty 安装指南

🎉🎉🎉欢迎来到我们的博客！无论您是第一次访问，还是我们的老朋友，我们都由衷地感谢您的到来。无论您是来寻找灵感、获取知识，还是单纯地享受阅读的乐趣，我们都希望您能在这里找到属于自己的收获，也欢迎评论和留言，分享您的想法和见解。

你的每一次阅读，都是我在键盘上敲下这些文字的勇气 (๑•̀ㅂ•́)و✧。
✨️✨️欢迎订阅本专栏✨️✨️

前言

以下是安装 OpenResty（基于 Nginx 的增强版 Web 平台）的详细步骤，涵盖主流通用系统环境及验证方法：

一、安装前准备

1. 系统要求

• 支持系统：Ubuntu/Debian、CentOS/RHEL、macOS（Homebrew）、Windows（WSL）
• 依赖工具：wget、gcc、make、perl

2. 安装依赖包（以 Ubuntu/Debian 为例）

sudo apt update
sudo apt install -y libpcre3-dev libssl-dev perl make build-essential zlib1g-dev

二、通过官方仓库安装（推荐）

1. 添加 OpenResty 官方仓库

# 导入 GPG 密钥
wget -qO - https://openresty.org/package/pubkey.gpg | sudo apt-key add -# 添加 APT 源
echo "deb http://openresty.org/package/ubuntu $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/openresty.list# 更新仓库索引
sudo apt update

2. 安装 OpenResty

sudo apt install -y openresty

3. 验证安装

openresty -v  # 应显示版本号（如 openresty/1.21.4.1）

三、源码编译安装（自定义需求）

1. 下载源码包

wget https://openresty.org/download/openresty-1.21.4.1.tar.gz
tar -xzvf openresty-1.21.4.1.tar.gz
cd openresty-1.21.4.1

2. 配置编译选项

./configure \--prefix=/usr/local/openresty \--with-luajit \--with-http_ssl_module \--with-http_v2_module \--with-http_stub_status_module \--with-pcre-jit

3. 编译并安装

make -j$(nproc)  # 使用多核加速编译
sudo make install

4. 配置环境变量

echo 'export PATH=/usr/local/openresty/nginx/sbin:$PATH' >> ~/.bashrc
source ~/.bashrc

四、基本操作命令

操作	命令
启动服务	sudo systemctl start openresty
停止服务	sudo systemctl stop openresty
重载配置	sudo systemctl reload openresty
设置开机自启	sudo systemctl enable openresty
检查配置文件语法	sudo nginx -t

五、验证运行状态

1. 创建测试配置文件

编辑 /usr/local/openresty/nginx/conf/nginx.conf，添加以下内容：

server {listen 80;server_name localhost;location /hello {default_type text/plain;content_by_lua_block {ngx.say("Hello, OpenResty!")}}
}

2. 重载服务并测试

sudo nginx -s reload
curl http://localhost/hello  # 应输出 "Hello, OpenResty!"

六、常见问题解决

1. 端口冲突

   • 修改 nginx.conf 中的 listen 端口号（如改为 8080）
   • 检查占用端口的进程：sudo lsof -i :80

2. 权限不足

   • 使用 sudo 执行命令
   • 确保 /usr/local/openresty 目录权限正确：

     sudo chown -R www-data:www-data /usr/local/openresty
     

3. 模块缺失

   • 重新编译时添加所需模块（如 --with-http_gzip_static_module）

七、卸载方法

# 仓库安装
sudo apt remove openresty && sudo apt autoremove# 源码安装
sudo rm -rf /usr/local/openresty

结语

通过以上步骤即可完成 OpenResty 的安装与基础配置。建议优先使用官方仓库安装以简化维护流程，需要深度定制时再选择源码编译。