OpenResty Alpine APK 安装包

lijunlong , 12 Dec 2023 (created 01 May 2020)

OpenResty 官方 APK 包仓库提供下面的 apk 包 (适用于 Alpine 系统)。

openresty

这是用于核心 OpenResty 服务的生产版本。

这个包注册在 /usr/bin/openresty, 它是 OpenResty 的 nginx 可执行文件 /usr/local/openresty/nginx/sbin/nginx 的符号链接。默认的，你应该能在你的 PATH 环境变量中看到 openresty 命令。当你想调用这个包提供的 nginx 可执行文件时，记得总是用 openresty 而不是 nginx。 nginx 默认并不在你的 PATH 环境变量中，这是为了避免和同一个系统中其他 NGINX 包发生冲突。

你可以使用这个命令来启动默认的 OpenResty 服务

sudo rc-service openresty start

stop、reload、upgrade、reopen 和 checkconfig 这些指令也是支持的。

默认的服务前缀是 /usr/local/openresty/。对于你自己的 OpenResty 应用，强烈推荐指定你自己的前缀，并指向你自己应用的目录，像这样：

sudo openresty -p /opt/my-fancy-app/

然后在 /opt/my-fancy-app/ 目录下会有一些 conf/, html/ 和 logs/ 这样的子目录。用这种方法，我们可以避免污染 /usr/local/openresty/ 下的 OpenResty 安装目录树，并且允许多个不同的 OpenResty 应用共享同一个 OpenResty 服务程序。但是你需要为每一个自己的 OpenResty 应用写一份启动脚本。你可以使用默认的 /etc/init.d/openresty 和 /etc/conf.d/openresty 启动脚本作为参考模板。

我们使用了我们自己的 OpenSSL（通过 openresty-openssl 包）、PCRE、zlib 和 LuaJIT 版本，来保证这些关键组件是最新的并且可以一起工作。

openresty-resty

这个包里面有 resty 命令行程序，它可以在你的 PATH 环境变量（做为 /usr/bin/resty）中看到。你可以这样尝试用下

$ resty -e 'ngx.say("hello")'
hello

这个包依赖标准 perl 包以及我们的 openresty 包才能正常工作。

你可以从 resty-cli 这个项目得到更多细节。

openresty-restydoc

这个包包含 OpenResty 文档工具链和文档数据。最有用的工具是 restydoc 命令行程序，默认应该能在你的 PATH 环境变量（做为 /usr/bin/restydoc）里面看到。

这样尝试:

restydoc ngx_lua

restydoc -s content_by_lua

restydoc -s proxy_pass

可以从 restydoc -h 命令的输出中看到更多使用的细节。

为了达到最佳结果，请确保你的 terminal 使用的是 UTF-8 字符编码，并且安装的 perl 和 groff 是比较新的版本。否则那些非 ASCII 的字符可能显示不正常。

openresty-debug

这个是 OpenResty 的正常调试版本。和 openresty 包比起来，它有以下不同：

这个版本禁止了 C 编译器的各种优化。
它打开了 NGINX 调试日志功能。
除了 NGINX 中默认的 epoll 模块，它额外开启了 poll 模块，以便能用上 mockeagain 这个测试工具。
对于 OpenSSL 库，它使用 openresty-openssl-debug 包替代了 openresty-openssl。
它在 LuaJIT 版本中打开了 API 检查和断言。
在 ngx_http_lua 模块中打开了断言。
它让 ngx_http_lua 模块在 LuaJIT 自己的垃圾回收管理内存分配失败时，立即退出当前的 nginx 工作进程（默认行为是记录错误信息并优雅退出当前工作进程）。
NGINX 默认的服务前缀是 /usr/local/openresty-debug/。
你在 PATH 环境变量里面看到的入口点是 openresty-debug 而不是 openresty。
它没有带启动脚本。