openresty/openresty:alpine

### 使用 OpenResty 和 Docker 的配置与设置 #### 安装并运行 OpenResty 镜像 为了在 Docker 中使用 OpenResty，可以基于官方镜像创建容器。下面是一个简单的 `Dockerfile` 示例： ```dockerfile FROM openresty/openresty:alpine COPY ./html /usr/local/openresty/nginx/html/ COPY nginx.conf /usr/local/openresty/nginx/conf/nginx.conf EXPOSE 80 CMD ["nginx", "-g", "daemon off;"] ``` 此文件定义了一个新的 Docker 映像，它从官方的 OpenResty 映像开始，并复制本地目录中的 HTML 文件和 Nginx 配置到映像中。 #### 创建自定义 Nginx 配置 Nginx 配置文件通常位于 `/etc/nginx/nginx.conf` 或者在这个例子中是在 `/usr/local/openresty/nginx/conf/nginx.conf` 下面。这里提供一个基本的例子来展示如何配置 OpenResty 来托管静态页面或作为反向代理服务器[^1]。 ```nginx worker_processes auto; error_log /var/log/nginx/error.log warn; pid /var/run/nginx.pid; events { worker_connections 1024; } http { include mime.types; default_type application/octet-stream; sendfile on; keepalive_timeout 65; server { listen 80; server_name localhost; location / { root html; index index.html index.htm; } error_page 500 502 503 504 /50x.html; location = /50x.html { root html; } } } ``` 这段配置指定了工作进程的数量、事件模块参数以及 HTTP 块内的多个指令，其中包括监听端口和服务名称等信息。还设置了默认首页位置和其他错误页的位置。 #### 构建和启动容器 完成上述准备工作之后，在命令行工具里执行如下操作即可构建新映像并启动容器: ```bash $ docker build -t my-openresty . $ docker run --name some-openresty -d -p 80:80 my-openresty ``` 这会下载所需的依赖项并将它们打包成一个新的 Docker 映像；然后以前台模式启动该映像的一个实例，同时将主机上的端口 80 转发给容器内部相同的端口。

### OpenResty 在 Windows 上的设置与使用 尽管 OpenResty 主要设计用于类 Unix 系统（如 Linux 和 macOS），但在某些情况下，开发者可能希望在 Windows 平台上进行开发或测试。以下是关于如何在 Windows 上设置和使用 OpenResty 以及 Lua 的方法。 #### 方法一：通过 WSL 安装 OpenResty Windows Subsystem for Linux (WSL) 是一种兼容层，允许在 Windows 中运行 Linux 应用程序。这是推荐的方式之一来在 Windows 上使用 OpenResty。 1. **启用并安装 WSL** 打开 PowerShell 或命令提示符，执行以下命令以启用 WSL： ```bash wsl --install ``` 2. **更新系统包** 启动 WSL，并确保其已成功安装 Ubuntu 或其他发行版。接着更新系统包： ```bash sudo apt-get update && sudo apt-get upgrade -y ``` 3. **安装依赖项** 配置构建环境所需的工具和库： ```bash sudo apt-get install build-essential curl libreadline-dev libncurses5-dev libpcre3-dev \ openssl libssl-dev perl make git unzip -y ``` 4. **下载并编译 OpenResty** 下载最新版本的 OpenResty 源码并按照标准流程编译： ```bash wget https://openresty.org/download/openresty-1.19.3.1.tar.gz tar -xvzf openresty-1.19.3.1.tar.gz cd openresty-1.19.3.1/ ./configure --with-luajit --with-http_ssl_module make -j$(nproc) sudo make install ``` 默认安装路径为 `/usr/local/openresty`[^3]。 5. **验证安装** 使用以下命令确认 OpenResty 是否正常工作： ```bash /usr/local/openresty/nginx/sbin/nginx -V ``` --- #### 方法二：基于 Docker 的解决方案 如果不想手动配置环境，Docker 提供了一种更简便的方法： 1. **安装 Docker Desktop** 访问 [Docker官网](https://www.docker.com/) 下载并安装适用于 Windows 的 Docker Desktop。 2. **拉取官方镜像** 使用以下命令获取最新的 OpenResty 镜像： ```bash docker pull openresty/openresty:alpine ``` 3. **启动容器** 创建一个新的交互式会话： ```bash docker run -it --rm openresty/openresty:alpine sh ``` 4. **编写 Nginx 配置文件** 编辑 `nginx.conf` 文件以集成 Lua 脚本功能[^2]: ```nginx worker_processes 1; error_log logs/error.log; events { worker_connections 1024; } http { server { listen 8080; location / { default_type text/html; content_by_lua ' ngx.say("<h1>Hello from OpenResty!</h1>") '; } } } ``` 5. **运行服务** 将上述配置挂载至容器内部并启动服务： ```bash docker run -d -p 8080:8080 -v $(pwd)/nginx.conf:/usr/local/openresty/nginx/conf/nginx.conf openresty/openresty:alpine ``` 访问浏览器中的 `http://localhost:8080` 即可查看效果。 --- #### 方法三：纯 Windows 开发方式 虽然不建议直接在 Windows 原生环境中部署 OpenResty，但如果确实需要，可以通过第三方项目实现部分功能。 1. **安装 LuaJIT** 下载预编译好的 LuaJIT 版本（支持 Windows）： ```plaintext https://luajit.org/download.html ``` 2. **模拟 NGINX 功能** 利用开源模块如 [ngx_openresty-windows-port](https://github.com/AgentZ/ngx_openresty_windows_port)，尝试移植核心组件到本地机器上。 注意此方案可能存在兼容性和稳定性问题，仅适合实验用途。 --- #### 示例代码片段 下面展示了一个简单的 Lua 脚本嵌入 Nginx 配置的例子： ```lua location /test { content_by_lua_block { local name = "World" ngx.say("Hello ", name, "! This is running on OpenResty.") } } ``` 该脚本会在请求 `/test` 地址时返回一条消息。 --- ### 总结 对于生产环境而言，在 Windows 上正式部署 OpenResty 不太现实；但对于学习目的或者轻量级应用来说，则完全可行。优先考虑利用虚拟化技术（如 WSL/Docker）完成相关操作更为稳妥可靠。