帮助文档

云服务器 域名注册 虚拟主机 服务器租用

帮助中心  >  技术文档  >  技术文档

怎样安装OpenResty?

发布时间:2026-11-16 18:36:46

OpenResty作为基于Nginx的高性能Web平台,正被越来越多的开发者采用。本文将详细介绍三种主流安装方式,助您快速搭建开发环境。

一、系统环境准备

在安装OpenResty前,请确保系统满足以下要求:

  • 操作系统:支持Linux/Unix、macOS和Windows(需WSL)
  • 内存:建议至少1GB可用内存
  • 磁盘空间:200MB以上可用空间
  • 权限:需要root或管理员权限

二、三种主流安装方式

方法1:使用官方二进制包(推荐)

这是最简单的安装方式,适合大多数用户:

  1. 访问官方下载页面
  2. 选择对应系统的预编译包
  3. 执行安装命令(以Ubuntu为例):
    # 添加官方仓库
    sudo apt-get -y install --no-install-recommends wget gnupg ca-certificates
    sudo wget -O - https://openresty.org/package/pubkey.gpg | sudo apt-key add -
    sudo echo "deb http://openresty.org/package/ubuntu $(lsb_release -sc) main" \
        | sudo tee /etc/apt/sources.list.d/openresty.list
    
    # 安装OpenResty
    sudo apt-get update
    sudo apt-get -y install openresty

方法2:源码编译安装

适合需要自定义功能的高级用户:

  1. 安装依赖库:
    # Ubuntu/Debian
    sudo apt-get install libpcre3-dev libssl-dev perl make build-essential curl
    
    # CentOS/RHEL
    sudo yum install pcre-devel openssl-devel gcc curl
  2. 下载并编译源码:
    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/
    ./configure --prefix=/usr/local/openresty \
        --with-http_ssl_module \
        --with-http_realip_module \
        --with-http_stub_status_module
    make
    sudo make install

方法3:使用Docker容器

适合需要快速部署测试环境的用户:

# 拉取官方镜像
docker pull openresty/openresty:alpine

# 运行容器
docker run -d --name my-openresty -p 8080:80 openresty/openresty:alpine

# 进入容器
docker exec -it my-openresty bash

三、安装后配置

完成安装后需要进行基础配置:

  1. 设置环境变量:
    # 将以下内容添加到~/.bashrc或/etc/profile
    export PATH=/usr/local/openresty/nginx/sbin:$PATH
  2. 验证安装:
    openresty -v
    # 应显示类似:nginx version: openresty/1.21.4.1
  3. 创建systemd服务(可选):
    sudo tee /etc/systemd/system/openresty.service <

四、常见问题解决

Q:启动时报端口冲突错误?
A:修改conf/nginx.conf中的监听端口,或停止占用80端口的服务

Q:如何添加第三方模块?
A:在源码编译时使用--add-module参数指定模块路径

Q:性能调优建议?
A:根据CPU核心数调整worker_processes参数,合理设置worker_connections

客服
活动
工单
电话
图标
爱云新创客服中心

公司已全面启动企业微信客户服务,请优先选择微信客服进行咨询。

  • 业务咨询 业务咨询

    扫码添加微信好友

    优惠提前知

    服务更全面

    行业资讯通

    业务相关,请咨询售前客服,为避免丢失消息,请尽量添加好友

  • 售后服务 售后服务

    微信扫码咨询客服

    优惠提前知

    服务更全面

    行业资讯通

    售后问题,请咨询售后值班,我们会尽全力解决您的问题

  • 工单服务 工单服务
    提交工单

    在线提交工单,3分钟极速响应

  • 投诉合作 投诉/合作

    微信扫码咨询客服

    优惠提前知

    服务更全面

    行业资讯通

    主管

    处理:投诉,建议,代理,大客户

  • 全国服务热线: