다음 두 가지 방법으로 Ubuntu 24.04 환경의 Nginx에 ngx_http_lua_module(Lua 모듈)를 활성화할 수 있습니다.
⸻
1) Ubuntu 패키지(apt)로 간단 설치
1. Universe 저장소 활성화
sudo add-apt-repository universe sudo apt update
2. Nginx 및 Lua 모듈용 패키지 설치
sudo apt install nginx libnginx-mod-http-lua
3. 모듈 로드 설정
/etc/nginx/nginx.conf 파일 최상단(또는 /etc/nginx/modules-enabled/)에 다음 라인 추가:
load_module modules/ngx_http_lua_module.so;
4. 간단한 Lua 헬로우 월드 테스트
/etc/nginx/sites-available/default 안 server { … } 블록에 예를 들어:
location /lua { content_by_lua_block { ngx.say("Hello from Lua!") } }
5. 설정 테스트 및 재시작
sudo nginx -t sudo systemctl reload nginx
6. 브라우저에서 http://<서버IP>/lua 접속 시 "Hello from Lua!"가 출력되면 성공입니다.
⸻
2) 소스에서 직접 컴파일
특수한 Nginx 버전이나 커스텀 설정이 필요할 때 유용합니다.
1. 빌드 의존성 설치
sudo apt update sudo apt install -y build-essential libpcre3-dev zlib1g-dev libssl-dev git
2. 소스 코드 및 모듈 클론
mkdir -p ~/src && cd ~/src wget http://nginx.org/download/nginx-1.26.1.tar.gz && tar xzf nginx-1.26.1.tar.gz git clone https://github.com/vision5/ngx_devel_kit.git git clone https://github.com/openresty/lua-nginx-module.git
3. Nginx 컴파일 & 설치
cd nginx-1.26.1 ./configure \ --prefix=/etc/nginx \ --sbin-path=/usr/sbin/nginx \ --conf-path=/etc/nginx/nginx.conf \ --add-module=../ngx_devel_kit \ --add-module=../lua-nginx-module \ --with-http_ssl_module make sudo make install
4. 서비스 파일(옵션) 설정
/lib/systemd/system/nginx.service를 만들어 두었다면, ExecStart 경로 등이 맞는지 확인하세요.
5. 위 1)의 3~5번과 같이 테스트 후 재시작
⸻
3) OpenResty 사용하기
OpenResty는 Lua 모듈을 포함한 Nginx 배포판입니다. 별도 컴파일 없이 바로 Lua 기능을 쓸 수 있습니다.
OpenResty 공식 저장소 추가
sudo apt install -y curl gnupg2 ca-certificates lsb-release curl -fsSL https://openresty.org/package/pubkey.gpg | sudo apt-key add - echo "deb http://openresty.org/package/ubuntu $(lsb_release -sc) main" \ | sudo tee /etc/apt/sources.list.d/openresty.list
설치
sudo apt update sudo apt install -y openresty
실행 (systemd)
sudo systemctl enable --now openresty
설치 후 sudo vi /usr/local/openresty/nginx/conf/nginx.conf 등에 Lua 설정을 추가하면 됩니다.
⸻
마무리 • 가장 쉬운 방법은 apt + libnginx-mod-http-lua 설치(방법 1) • 커스텀 빌드나 최신 버전이 필요하면 소스 컴파일(방법 2) • Lua를 많이 쓴다면 OpenResty(방법 3)
상황에 맞춰 선택하시면 됩니다. 문제가 있으면 에러 메시지와 함께 알려주세요!