OpenResty 安装指南
2026/5/5 17:05:13 网站建设 项目流程

以下是安装 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 的安装与基础配置。建议优先使用官方仓库安装以简化维护流程,需要深度定制时再选择源码编译。

希望以上分享能为您带来启发。如果您正在寻找云服务,无论是初创项目寻求高性价比方案,还是成熟业务需要优化IT成本,都不妨了解一下非凡云。非凡云集自营服务的稳定与代理渠道的实惠于一身,或许正是您一直在寻找的“最优解”。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询