OpenResty 安装指南

前言

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

一、安装前准备

1. 系统要求

  • 支持系统:Ubuntu/Debian、CentOS/RHEL、macOS(Homebrew)、Windows(WSL)
  • 依赖工具 :wget、gcc、make、perl

2. 安装依赖包(以 Ubuntu/Debian 为例)

bash 复制代码
sudo apt update
sudo apt install -y libpcre3-dev libssl-dev perl make build-essential zlib1g-dev

二、通过官方仓库安装(推荐)

1. 添加 OpenResty 官方仓库

bash 复制代码
# 导入 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

bash 复制代码
sudo apt install -y openresty

3. 验证安装

bash 复制代码
openresty -v  # 应显示版本号(如 openresty/1.21.4.1)

三、源码编译安装(自定义需求)

1. 下载源码包

bash 复制代码
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. 配置编译选项

bash 复制代码
./configure \
  --prefix=/usr/local/openresty \
  --with-luajit \
  --with-http_ssl_module \
  --with-http_v2_module \
  --with-http_stub_status_module \
  --with-pcre-jit

3. 编译并安装

bash 复制代码
make -j$(nproc)  # 使用多核加速编译
sudo make install

4. 配置环境变量

bash 复制代码
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,添加以下内容:

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

2. 重载服务并测试

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

六、常见问题解决

  1. 端口冲突

    • 修改 nginx.conf 中的 listen 端口号(如改为 8080)
    • 检查占用端口的进程:sudo lsof -i :80
  2. 权限不足

    • 使用 sudo 执行命令

    • 确保 /usr/local/openresty 目录权限正确:

      bash 复制代码
      sudo chown -R www-data:www-data /usr/local/openresty
  3. 模块缺失

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

七、卸载方法

bash 复制代码
# 仓库安装
sudo apt remove openresty && sudo apt autoremove

# 源码安装
sudo rm -rf /usr/local/openresty

结语

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

相关推荐
kyriewen1 天前
编辑弹窗点了取消,列表里的数据怎么还是变了?
前端·javascript·人工智能
Karl_fang1 天前
🥳 再也不用拿起手机抄验证码!我做了一个 Android → Mac 的「验证码接力」工具
前端·macos·ai编程
谭光志1 天前
如何让 AI 高效工作
前端·后端·ai编程
速捷工控 PLC触摸屏还原程序1 天前
欧姆龙NB上传密码忘了,换屏前怎么保留原程序?
运维·服务器·欧姆龙
FRing031 天前
vue2干货总结11(短信验证、登录功能、统一处理错误(响应拦截器)、将token信息存入vuex、vuex持久化处理)
开发语言·前端·javascript·vue.js·vue2
泯泷1 天前
改一个字,整段都红了?——中文内容差异对比的算法与协议设计
前端·javascript·typescript
再吃一根胡萝卜1 天前
DSH plugin 开发示例:五种插件形态完整代码整理
前端
爱勇宝1 天前
SSL 证书别再手动续了:acme.sh + Let's Encrypt + 云厂商 DNS 全自动实战
运维·服务器
Yk酱228401 天前
A2UI随笔-demo-01
前端
云起SAAS1 天前
本地生活同城多商户商城系统源码源码 合伙人分红加区域代理加排队返现
前端·javascript·后端