原生 Lua 需額外安裝 luasocket 且為阻塞模式。lua-nginx-module 內建 **100% 非阻塞** TCP/UDP API,完美融合 Nginx 事件迴圈,無需外部依賴。
local sock = ngx.socket.tcp()
sock:settimeout(5000) -- 5 秒超時(連線/收發/關閉)
local ok, err = sock:connect("whois.cnnic.net.cn", 43)
if not ok then
ngx.say("連線失敗: ", err)
return
end
local request = "baidu.cn\r\n"
local bytes, err = sock:send(request)
if not bytes then
ngx.say("發送失敗: ", err)
return
end
-- '*a' 讀取直到關閉
local data, err, partial = sock:receive("*a")
if not data then
ngx.say("接收失敗: ", err, " 部分資料: ", partial)
return
end
ngx.print(data)
sock:close()
local sock = ngx.socket.udp()
sock:settimeout(2000)
sock:setpeername("8.8.8.8", 53) -- Google DNS
-- 簡易 DNS 查詢封包(略,實際建議用 lua-resty-dns)
local ok, err = sock:send(dns_packet)
if not ok then ngx.say("UDP 發送失敗: ", err); return end
local data, err = sock:receive()
if not data then ngx.say("UDP 接收失敗: ", err); return end
ngx.say("收到 ", #data, " 位元組回應")
sock:close()
| 方法 | 說明 |
|---|---|
ngx.socket.tcp() | 建立 TCP socket 物件 |
ngx.socket.udp() | 建立 UDP socket 物件 |
sock:connect(host, port) | 非阻塞連線 |
sock:settimeout(ms) | 設定超時(毫秒) |
sock:send(data) | 發送資料,回傳位元組數 |
sock:receive(pattern) | 接收資料,pattern: *a(全部)、*l(行)、數字(定長) |
sock:close() | 關閉連線 |
sock:setkeepalive() | 放入連線池復用(高效能關鍵) |
-- 短連線模式:用完即關(適合低頻)
sock:close()
-- 長連線模式:放入池子(適合高頻,如 Redis、MySQL)
local ok, err = sock:setkeepalive(60000, 100) -- 60 秒存活、池大小 100
if not ok then ngx.log(ngx.ERR, "keepalive 失敗: ", err) end
lua-nginx-module Socket API 以「非阻塞 + 連線池」兩大特性,讓 OpenResty 輕鬆對接上游 TCP/UDP 服務。搭配 lua-resty-redis、lua-resty-mysql、lua-resty-http 等封裝庫,開發高效能閘道/代理服務得心應手。