luajit.io

luajit io framework

Github星跟踪图

luajit.io

Introduction

Pure Lua IO framework, with C efficiency due to its simple but powerful design, and, of course, thanks to luajit, the perfect JIT engine. The HTTP Server is out-of-the-box, which simulates the functionalities and performance of nginx and ngx_lua. Moreover, it could be used to develop generic TCP/UDP server.

Why reinvent the wheel? Well, the nginx and ngx_lua is renowned at efficiency and extensible, but they are written in C language, so you need to be as smart as the authors to contribute codes. What if the core is written in pure lua language, but without any efficiency tradeoff? Then not only the web apps are extensible, but also the server core is extensible at ease by any levels of developers!

The Luajit is a perfect JIT engine to improve lua performance, so with dedicated and luajit-oriented design, the luajit.io would reassemble the advantages of nginx and ngx_lua, but provides extra benefit: simple and extensible at the core.

See the http://luajit.io for demo.

API compatible with ngx_lua (Work In Progress)

It provides seamless ngx_lua API, so third-party openresty libraries could be used in luajit.io without porting.

Tested libraries:

  • lua-resty-lock
  • lua-resty-upload
  • lua-resty-http
  • lua-resty-dns
  • lua-resty-redis
  • lua-resty-mysql
  • lua-resty-postgres

Supported Platforms

Only supports Linux on x86 or x64.

The luajit.io uses linux-specific features, e.g. epoll, signalfd, timerfd, inotify, etc.

Dependencies

  • openssl
  • zlib
  • pcre

On Debian Linux, you should install the dev packages of them, which contains the required *.so links:

apt-get install zlib1g-dev libssl-dev libpcre3-dev

Status

This library is considered experimental and still under active development.

And there is still big room to improve the performance, by increasing the jit compiled ratio, which is really a tough job.

Welcome to join and help!

QuickStart

http server

Just like the API compatibility, the luajit.io configuration simulates the nginx.conf, so most directives are copied from there.
See conf/httpd.lua for example.

Copy the example into new file, e.g. conf/myhttpd.lua, and adjust the content according to your need.

Then just run it:

luajit conf/myhttpd.lua

generic tcp server

It contains a simple socks5 server, as the generic tcp server demo.

LD_PRELOAD=/lib/x86_64-linux-gnu/libpthread.so.0 luajit conf/socks5.lua

Note that by default, the luajit is not compiled with -lpthread, which would cause multi-threading usage crash.

See https://sourceware.org/bugzilla/show_bug.cgi?id=10652 for detail.

The async DNS resolving uses multi-threading, so either re-compile the luajit or use LD_PRELOAD before running it.

You should locate the correct version of libpthread.so on your box.

locate libpthread.so

主要指标

概览
名称与所有者kingluo/luajit.io
主编程语言Lua
编程语言Lua (语言数: 1)
平台
许可证BSD 2-Clause "Simplified" License
所有者活动
创建于2015-03-29 05:59:51
推送于2021-03-03 06:15:58
最后一次提交2021-03-03 14:15:58
发布数0
用户参与
星数306
关注者数19
派生数31
提交数173
已启用问题?
问题数5
打开的问题数0
拉请求数2
打开的拉请求数0
关闭的拉请求数1
项目设置
已启用Wiki?
已存档?
是复刻?
已锁定?
是镜像?
是私有?