Một mục mã nguồn mở trong kho dữ liệu GitHub của TopGit: alibaba/tengine, 13.4k sao, C. A high-performance web server and reverse proxy, 100% compatible with nginx.
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
Visit tengine.taobao.org for the full documentation, examples and guides.
Introduction
Tengine is a high-performance web server and reverse proxy originated by Taobao, the largest e-commerce website in Asia. It offers HTTP/3, Kubernetes Ingress support, zero-downtime dynamic configuration, active upstream health checks, and NTLS/TLCP (SM2/SM3/SM4), while remaining 100% compatible with nginx. Tengine has proven to be very stable and efficient on some of the top 100 websites in the world, including taobao.com and tmall.com.
Tengine has been an open source project since December 2011. It is being actively developed by the Tengine team, whose core members are from Taobao, Sogou and other Internet companies. Tengine is a community effort and everyone is encouraged to get involved.
Features
All features of nginx-1.31.5 are inherited, i.e., it is 100% compatible with nginx.
Dynamically configure the servers, locations and upstreams without reloading or restarting worker processes with tengine-ingress, the Kubernetes Ingress controller for Tengine.
HTTP/3 support (QUIC v1 and draft-29) with xquic, including connection management and multiplexing for lower latency and higher resilience to packet loss on unstable networks.
High-speed UDP transmission with kernel-bypass.
Dynamically configure different TLS protocols for different server names with tengine-ingress.
Dynamically configure timeout setting, SSL Redirects, CORS and enabling/disabling robots for the server and location with tengine-ingress.
Dynamically configure HTTP routing based on multiple values of a specific header, cookie or query parameter with tengine-ingress.
Dynamically configure HTTP routing based on multiple upstream according to weight with tengine-ingress.
Dynamically configure HTTP routing based on modulo operation for a specific header, cookie or query parameter with tengine-ingress.
Dynamically configure HTTP routing to add/append custom header or add query parameter in the HTTP request to the upstream with tengine-ingress.
Dynamically configure HTTP routing to add custom header in the HTTP response to the client with tengine-ingress.
Dynamically configure failover to a backup upstream or a redirect by response status code with tengine-ingress.
Support the CONNECT HTTP method for forward proxy.
Support asynchronous OpenSSL, using hardware such as QAT for HTTPS acceleration.
NTLS/TLCP (dual-certificate TLS, GM/T 0024) support with the Chinese SM2/SM3/SM4 algorithms via Tongsuo.
Zstandard (zstd) response compression, and serving pre-compressed static files.
Enhanced operations monitoring, such as asynchronous log & rollback, DNS caching, memory usage, etc.
Fine-grained timing statistics variables for the request and for each stage of the upstream interaction.
Support server_name in Stream module.
More load balancing methods, e.g., consistent hashing, session persistence, and a weighted round-robin with O(1) time and O(n) memory.
Input body filter support. It's quite handy to write Web Application Firewalls using this mechanism.
Dynamic scripting language (Lua) support, which is very efficient and makes it easy to extend core functionalities.
Limits retries for upstream servers (proxy, memcached, fastcgi, scgi, uwsgi).
Includes a mechanism to support standalone processes.
Protects the server in case system load or memory use goes too high.
Multiple CSS or JavaScript requests can be combined into one request to reduce download time.
Removes unnecessary white spaces and comments to reduce the size of a page.
Active health checks of upstream servers can be performed.
The number of worker processes and CPU affinities can be set automatically.
The limit_req module is enhanced with whitelist support and more conditions are allowed in a single location.
Enhanced diagnostic information makes it easier to troubleshoot errors.
More user-friendly command lines, e.g., showing all compiled-in modules and supported directives.
Expiration times can be specified for certain MIME types.
Receives HTTP traffic on the TLS listener with option.
Debugging HTTP connection usage.
Appends content to the response body.
...
Installation
Container image
Multi-arch (amd64 + arm64) images with the full feature set -- Tongsuo (NTLS), xquic (QUIC/HTTP-3) and Lua -- are published on every release:
docker pull ghcr.io/alibaba/tengine:latest # Debian based
docker pull ghcr.io/alibaba/tengine:latest-alpine # Alpine based, smaller
docker run --rm -p 8080:80 ghcr.io/alibaba/tengine:latest
The server runs as /usr/sbin/tengine with /etc/tengine/tengine.conf; drop your own server blocks into /etc/tengine/conf.d/.
Distribution packages
Every release ships .rpm, .deb and .apk packages for the mainstream distributions (RHEL/Rocky/Alma/Anolis/openEuler/SLES, Debian/Ubuntu, Alpine) on both x86_64 and aarch64, attached to the release page:
These packages install alongside a distribution nginx without conflicting. See packages/build/README.md for the exact feature set, how to build them yourself, and how the container images are produced.
From source
Tengine can be downloaded at https://tengine.taobao.org/download/tengine.tar.gz. You can also checkout the latest source code from GitHub at https://github.com/alibaba/tengine
To install Tengine, just follow these three steps:
./configure
make
sudo make install
By default, it will be installed to /usr/local/tengine. Everything is named after Tengine, which matches the layout used by the .rpm/.deb/.apk packages and the container images:
Default path
binary
/usr/local/tengine/sbin/tengine
configuration
/usr/local/tengine/conf/tengine.conf
pid file
/usr/local/tengine/logs/tengine.pid
error log
/usr/local/tengine/logs/error.log
access log
/usr/local/tengine/logs/access.log
dynamic modules
/usr/local/tengine/modules
You can use the '--prefix' option to specify the root directory, or --sbin-path, --conf-path, --pid-path, --error-log-path and --http-log-path to place the individual files.
If you want to know all the 'configure' options, you should run './configure --help' for help.
Upgrading from 3.1.0 or earlier. Those releases installed to
/usr/local/nginx as sbin/nginx driven by conf/nginx.conf. Because
3.2.0 writes to different paths, make install does not replace that
install -- the old binary stays on disk and keeps serving traffic, and
running it still reports the old version, which easily reads as "the
upgrade did not take effect". After switching over, stop and remove the old
install, and update any systemd unit, init script or log rotation config
still pointing at the old paths. configure prints a warning when it finds
an install at /usr/local/nginx/sbin/nginx.
To keep the previous layout instead, pass the old paths explicitly:
A plain ./configure builds without Tongsuo, xquic and Lua -- those need their own libraries. To reproduce the full feature set of the released packages and images, use the packaging helpers:
alibaba/tengine có 13.4k sao GitHub — tải lại trang để xem số mới nhất, hoặc xem trực tiếp github.com/alibaba/tengine. TopGit phản chiếu số sao của GitHub nhưng không cam kết đến từng phút.
Dự án có trang chủ ở https://tengine.taobao.org. Tab "Readme" ở trang này thường có ảnh chụp và hướng dẫn bắt đầu nhanh.
alibaba/tengine còn đang phát triển không?
Commit gần nhất trên alibaba/tengine là 2 tháng trước (theo timestamp GitHub). Repo có 2.5k fork — một chỉ báo về mức độ quan tâm của cộng đồng.
alibaba/tengine dùng license gì?
alibaba/tengine phát hành theo license BSD-2-Clause. Nên mở file LICENSE trên GitHub để xác nhận — license metadata đôi khi lệch với thực tế dự án.
alibaba/tengine viết bằng ngôn ngữ gì?
alibaba/tengine chủ yếu viết bằng C. Trường "language" của GitHub dựa trên phần lớn byte ở nhánh mặc định.
Đọc thêm về alibaba/tengine ở đâu?
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/alibaba/tengine là nguồn chính thức.
Đọc đầy đủ README ở tab phía trên.
Muốn nghe thêm một ý kiến về tengine?
Hỏi một AI đọc được trang này — một cú bấm là có ngay nhận định về tengine.