How to compile Tengine custom module on Debian
2026-09-29
AdSense Slot
Tengine is an enhanced web server based on Nginx. Sometimes official prebuilt packages do not contain the custom modules you need. You need to compile Tengine from source on Debian.
Prerequisites
Install build dependencies first:
sudo apt update
sudo apt install build-essential libpcre3-dev zlib1g-dev libssl-dev git
Step1 Download Tengine source
git clone https://github.com/alibaba/tengine.git
cd tengine
Step2 Download your custom module source
Place your custom module folder inside tengine directory.
Step3 Configure compile flags
./configure --add-module=./your-custom-module-path
You can add other common flags such as --with-http_ssl_module.
Step4 Compile & Install
make -j$(nproc)
sudo make install
Step5 Verify installation
/usr/local/tengine/sbin/nginx -v
Check whether your custom module appears in the compiled modules list.
Common pitfalls
- Missing system dev libraries will throw header file missing errors.
- Make sure custom module version matches your Tengine version.
- Do not mix source compiled Tengine with apt installed Nginx.
Summary
Compiling Tengine custom module is useful when prebuilt packages lack required features. Always test compiled binary in staging server before production use.
AdSense Slot