3 分鐘閱讀 | 最後修改: 0001-01-01, 0:00:00 am

lua-io-nginx-module-plus

注意：此庫需要 OpenResty 1.21.4.3 或更高版本。

二進位制安裝程式的資源庫

首先，我們需要使用下面的命令配置二進位制安裝程式的資源庫。命令中的 “CLIENT_TOKEN” 需要替換為訂閱郵件中的有效令牌。

curl -o get-xray-priv-lib-repo.sh https://pkg2.openresty.com/scripts/get-xray-priv-lib-repo.sh
sudo bash get-xray-priv-lib-repo.sh -l lua-io-nginx-module-plus -t CLIENT_TOKEN

安裝

適用於 OpenResty-1.21.4.x

對於使用 yum 作為軟體包管理器的 CentOS/RockyLinux/Amazon Linux/Alibaba Cloud Linux/Tecent Linux 作業系統，執行以下命令安裝私有庫。

sudo yum makecache --disablerepo="*" --enablerepo="lua-io-nginx-module-plus"
sudo yum install --disablerepo="*" --enablerepo="lua-io-nginx-module-plus" -y lua-io-nginx-module-plus-1.21.4

對於使用 dnf 作為軟體包管理器的 Fedora 等作業系統，執行以下命令安裝私有庫。

sudo dnf makecache --disablerepo="*" --enablerepo="lua-io-nginx-module-plus"
sudo dnf install --disablerepo="*" --enablerepo="lua-io-nginx-module-plus" -y lua-io-nginx-module-plus-1.21.4

對於使用 apt 作為軟體包管理器的作業系統（如 Ubuntu/Debian），執行以下命令安裝私有庫。

sudo apt-get install -y lua-io-nginx-module-plus-1.21.4

適用於 OpenResty 1.25.3.x

對於使用 yum 作為軟體包管理器的 CentOS/RockyLinux/Amazon Linux/Alibaba Cloud Linux/Tecent Linux 作業系統，執行以下命令安裝私有庫。

sudo yum makecache --disablerepo="*" --enablerepo="lua-io-nginx-module-plus"
sudo yum install --disablerepo="*" --enablerepo="lua-io-nginx-module-plus" -y lua-io-nginx-module-plus-1.25.3

對於使用 dnf 作為軟體包管理器的作業系統（如 Fedora ），執行以下命令安裝私有庫。

sudo dnf makecache --disablerepo="*" --enablerepo="lua-io-nginx-module-plus"
sudo dnf install --disablerepo="*" --enablerepo="lua-io-nginx-module-plus" -y lua-io-nginx-module-plus-1.25.3

對於使用 apt 作為軟體包管理器的作業系統（如 Ubuntu/Debian），執行以下命令安裝私有庫。

sudo apt-get install -y lua-io-nginx-module-plus-1.25.3

升級

適用於 OpenResty-1.21.4.x

對於使用 yum 作為軟體包管理器的 CentOS/RockyLinux/Amazon Linux/Alibaba Cloud Linux/Tecent Linux 作業系統，執行以下命令安裝私有庫。

sudo yum makecache --disablerepo="*" --enablerepo="lua-io-nginx-module-plus"
sudo yum update --disablerepo="*" --enablerepo="lua-io-nginx-module-plus" -y lua-io-nginx-module-plus-1.21.4

對於使用 dnf 作為軟體包管理器的 Fedora 等作業系統，執行以下命令安裝私有庫。

sudo dnf makecache --disablerepo="*" --enablerepo="lua-io-nginx-module-plus"
sudo dnf update --disablerepo="*" --enablerepo="lua-io-nginx-module-plus" -y lua-io-nginx-module-plus-1.21.4

對於使用 apt 作為軟體包管理器的作業系統（如 Ubuntu/Debian），執行以下命令安裝私有庫。

sudo apt-get update
sudo apt-get install -y lua-io-nginx-module-plus-1.21.4

適用於 OpenResty 1.25.3.x

對於使用 yum 作為軟體包管理器的 CentOS/RockyLinux/Amazon Linux/Alibaba Cloud Linux/Tecent Linux 作業系統，執行以下命令安裝私有庫。

sudo yum makecache --disablerepo="*" --enablerepo="lua-io-nginx-module-plus"
sudo yum update --disablerepo="*" --enablerepo="lua-io-nginx-module-plus" -y lua-io-nginx-module-plus-1.25.3

對於使用 dnf 作為軟體包管理器的作業系統（如 Fedora ），執行以下命令安裝私有庫。

sudo dnf makecache --disablerepo="*" --enablerepo="lua-io-nginx-module-plus,coro-nginx-module"
sudo dnf update --disablerepo="*" --enablerepo="lua-io-nginx-module-plus,coro-nginx-module" -y lua-io-nginx-module-plus-1.25.3

對於使用apt作為軟體包管理器的作業系統，如Ubuntu/Debian，執行以下命令安裝私有庫。

sudo apt-get update
sudo apt-get install -y lua-io-nginx-module-plus-1.25.3

適用於 OpenResty 1.27.1.x

對於使用 yum 作為軟體包管理器的 CentOS/RockyLinux/Amazon Linux/Alibaba Cloud Linux/Tecent Linux 作業系統，執行以下命令安裝私有庫。

sudo yum makecache --disablerepo="*" --enablerepo="lua-io-nginx-module-plus"
sudo yum update --disablerepo="*" --enablerepo="lua-io-nginx-module-plus" -y lua-io-nginx-module-plus-1.27.1

對於使用 dnf 作為軟體包管理器的作業系統（如 Fedora ），執行以下命令安裝私有庫。

sudo dnf makecache --disablerepo="*" --enablerepo="lua-io-nginx-module-plus,coro-nginx-module"
sudo dnf update --disablerepo="*" --enablerepo="lua-io-nginx-module-plus,coro-nginx-module" -y lua-io-nginx-module-plus-1.27.1

對於使用 apt作為軟體包管理器的作業系統（如Ubuntu/Debian`），執行以下命令安裝私有庫。

sudo apt-get update
sudo apt-get install -y lua-io-nginx-module-plus-1.27.1

安裝 OpenResty

比如，對於 yum 作為包管理器的系統，想要安裝 1.25.3 的 OpenResty：

$ yum list --showduplicates openresty
Last metadata expiration check: 0:07:22 ago on Sat 13 Sep 2025 07:15:05 AM CST.
Available Packages
openresty.x86_64                                                      1.21.4.4-1.el9                                                      openresty
openresty.x86_64                                                      1.25.3.2-1.el9                                                      openresty
openresty.x86_64                                                      1.27.1.2-1.el9                                                      openresty
$ sudo yum install openresty-1.25.3.2-1.el9

比如，對於 dnf 作為包管理器的系統，想要安裝 1.25.3 的 OpenResty：

$ dnf list --showduplicates openresty
Last metadata expiration check: 0:07:22 ago on Sat 13 Sep 2025 07:15:05 AM CST.
Available Packages
openresty.x86_64                                                      1.21.4.4-1.el9                                                      openresty
openresty.x86_64                                                      1.25.3.2-1.el9                                                      openresty
openresty.x86_64                                                      1.27.1.2-1.el9                                                      openresty
$ sudo dnf install openresty-1.25.3.2-1.el9

對於使用 apt 作為包的理器的系統，安裝 openresty 1.25.3 的 OpenResty：

$ apt-cache madison openresty
 openresty | 1.27.1.2-1~noble1 | https://openresty.org/package/ubuntu noble/main amd64 Packages
 openresty | 1.27.1.1-1~noble1 | https://openresty.org/package/ubuntu noble/main amd64 Packages
 openresty | 1.25.3.2-2~noble1 | https://openresty.org/package/ubuntu noble/main amd64 Packages

$ sudo apt install openresty=1.25.3.2-2~noble1

使用方法

Nginx 配置

在使用 lua-io-nginx-module-plus 之前，需要在配置檔案 nginx.conf 中新增以下配置項，以載入相關動態模組。

# load_module 指令必須位於 nginx.conf 頂部
load_module /usr/local/openresty/nginx/modules/ngx_http_lua_io_module.so;

thread_pool default threads=2 max_queue=10;
...

http {
    location /ngx_io {
        content_by_lua_block {
            local ngx_io = require "ngx.io"

            local file, err = ngx_io.open("/tmp/foo.txt", "w")
            if not file then
                ngx.log(ngx.ERR, "failed to open /tmp/foo.txt: ", err)
                return
            end

            local bytes, err = file:write("hello world\n")
            if err ~= nil then
                ngx.log(ngx.ERR, "failed to write: ", err)
                -- fall through
            end

            local ok, err = file:close()
            if err ~= nil then
                ngx.log(ngx.ERR, "failed to close: ", err)
                return
            end
        }
    }
}