# 原生模块 本指南介绍 Angie 的原生模块, 提供配置示例,列出其指令和参数, 以及内置变量。 ## 核心模块 | [Core](https://cn.angie.software//angie/docs/configuration/modules/core.md#core) | 管理服务文件、进程和其他 Angie 模块。 | |------------------------------------------------------------------------------------|--------------------------| ## HTTP 模块 | [HTTP](https://cn.angie.software//angie/docs/configuration/modules/http/index.md#http-core) | 处理 HTTP 请求和响应的核心功能,
管理 HTTP 服务器、连接和静态文件。 | |----------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------| | [Access](https://cn.angie.software//angie/docs/configuration/modules/http/http_access.md#http-access) | 基于 IP 地址和 CIDR 范围的访问控制。 | | [ACME](https://cn.angie.software//angie/docs/configuration/modules/http/http_acme.md#http-acme) | 使用 ACME 协议为 HTTP 服务器
自动获取和续期 SSL 证书。 | | [Docker](https://cn.angie.software//angie/docs/configuration/modules/http/http_docker.md#http-docker) | 基于 Docker 容器标签
动态更新代理服务器组。 | | [Addition](https://cn.angie.software//angie/docs/configuration/modules/http/http_addition.md#http-addition) | 在响应正文之前或之后插入指定的代码片段。 | | [API](https://cn.angie.software//angie/docs/configuration/modules/http/http_api.md#http-api) | RESTful HTTP 接口,用于获取基本 Web 服务器信息和
JSON 格式的统计数据,
以及管理代理服务器组。 | | [Auth Basic](https://cn.angie.software//angie/docs/configuration/modules/http/http_auth_basic.md#http-auth-basic) | 基于用户名和密码的基本 HTTP 身份验证
用于访问控制。 | | [Auth Request](https://cn.angie.software//angie/docs/configuration/modules/http/http_auth_request.md#http-auth-request) | 使用对外部 HTTP 服务的子请求进行授权。 | | [AutoIndex](https://cn.angie.software//angie/docs/configuration/modules/http/http_autoindex.md#http-autoindex) | 在没有索引文件时自动生成目录列表。 | | [Browser](https://cn.angie.software//angie/docs/configuration/modules/http/http_browser.md#http-browser) (已弃用) | 基于 `User-Agent` 头的浏览器识别。 | | [Charset](https://cn.angie.software//angie/docs/configuration/modules/http/http_charset.md#http-charset) | 配置和转换响应编码。 | | [DAV](https://cn.angie.software//angie/docs/configuration/modules/http/http_dav.md#http-dav) | 使用 WebDAV 协议在服务器上进行文件管理。 | | [Empty GIF](https://cn.angie.software//angie/docs/configuration/modules/http/http_empty_gif.md#http-empty-gif) | 提供一个单像素透明 GIF。 | | [FastCGI](https://cn.angie.software//angie/docs/configuration/modules/http/http_fastcgi.md#http-fastcgi) | 将请求代理到 FastCGI 服务器。 | | [FLV](https://cn.angie.software//angie/docs/configuration/modules/http/http_flv.md#http-flv) | Flash Video (FLV) 文件的伪流式传输。 | | [Geo](https://cn.angie.software//angie/docs/configuration/modules/http/http_geo.md#http-geo) | 将 IP 地址转换为指定的变量值。 | | [GeoIP](https://cn.angie.software//angie/docs/configuration/modules/http/http_geoip.md#http-geoip) | 使用 MaxMind GeoIP 数据库
基于地理位置获取 IP 地址数据。 | | [gRPC](https://cn.angie.software//angie/docs/configuration/modules/http/http_grpc.md#http-grpc) | 将请求代理到 gRPC 服务器。 | | [GunZIP](https://cn.angie.software//angie/docs/configuration/modules/http/http_gunzip.md#http-gunzip) | 解压 GZip 压缩的响应以进行修改,以及在
客户端不支持压缩的情况下使用。 | | [GZip](https://cn.angie.software//angie/docs/configuration/modules/http/http_gzip.md#http-gzip) | 使用 GZip 方法压缩响应以节省流量。 | | [GZip Static](https://cn.angie.software//angie/docs/configuration/modules/http/http_gzip_static.md#http-gzip-static) | 提供使用 GZip 方法预压缩的静态文件。 | | [Headers](https://cn.angie.software//angie/docs/configuration/modules/http/http_headers.md#http-headers) | 修改响应头字段。 | | [HTTP2](https://cn.angie.software//angie/docs/configuration/modules/http/http_v2.md#http-v2) | 使用 HTTP/2 协议处理请求。 | | [HTTP3](https://cn.angie.software//angie/docs/configuration/modules/http/http_v3.md#http-v3) | 使用 HTTP/3 协议处理请求。 | | [Image Filter](https://cn.angie.software//angie/docs/configuration/modules/http/http_image_filter.md#http-image-filter) ^[1](#id8) | 图像转换。 | | [Index](https://cn.angie.software//angie/docs/configuration/modules/http/http_index.md#http-index) | 配置索引文件,
用于处理以斜杠 (`/`) 结尾的请求。 | | [Limit Conn](https://cn.angie.software//angie/docs/configuration/modules/http/http_limit_conn.md#http-limit-conn) | 限制并发请求数(活动连接数)
以防止过载。 | | [Limit Req](https://cn.angie.software//angie/docs/configuration/modules/http/http_limit_req.md#http-limit-req) | 限制请求频率
以防止过载和密码猜测。 | | [Log](https://cn.angie.software//angie/docs/configuration/modules/http/http_log.md#http-log) | 配置请求日志以跟踪资源访问
用于监控和分析目的。 | | [Map](https://cn.angie.software//angie/docs/configuration/modules/http/http_map.md#http-map) | 基于预定义的键值对转换变量。 | | [Metric](https://cn.angie.software//angie/docs/configuration/modules/http/http_metric.md#http-metric) | 实时统计 API 中的自定义数值指标。 | | [Memcached](https://cn.angie.software//angie/docs/configuration/modules/http/http_memcached.md#http-memcached) | 从 Memcached 服务器检索响应。 | | [Mirror](https://cn.angie.software//angie/docs/configuration/modules/http/http_mirror.md#http-mirror) | 将请求镜像到其他服务器。 | | [MP4](https://cn.angie.software//angie/docs/configuration/modules/http/http_mp4.md#http-mp4) | MP4 文件的伪流式传输。 | | [Perl](https://cn.angie.software//angie/docs/configuration/modules/http/http_perl.md#http-perl) ^[1](#id8) | 通过在 Perl 语言中指定附加逻辑
来扩展功能的处理程序。 | | [Prometheus](https://cn.angie.software//angie/docs/configuration/modules/http/http_prometheus.md#http-prometheus) | Prometheus 兼容格式的服务器指标
用于监控和统计收集。 | | [Proxy](https://cn.angie.software//angie/docs/configuration/modules/http/http_proxy.md#http-proxy) | 将请求反向代理到其他 HTTP 服务器。 | | [Random Index](https://cn.angie.software//angie/docs/configuration/modules/http/http_random_index.md#http-random-index) | 为以斜杠 (`/`) 结尾的请求
随机选择索引文件。 | | [RealIP](https://cn.angie.software//angie/docs/configuration/modules/http/http_realip.md#http-realip) | 在另一个代理服务器后运行时
确定客户端地址和端口。 | | [Referer](https://cn.angie.software//angie/docs/configuration/modules/http/http_referer.md#http-referer) | 验证 `Referer` 头值。 | | [Rewrite](https://cn.angie.software//angie/docs/configuration/modules/http/http_rewrite.md#http-rewrite) | 请求 URI 修改、重定向、变量设置
和条件配置选择。 | | [SCGI](https://cn.angie.software//angie/docs/configuration/modules/http/http_scgi.md#http-scgi) | 将请求代理到 SCGI 服务器。 | | [Secure Link](https://cn.angie.software//angie/docs/configuration/modules/http/http_secure_link.md#http-secure-link) | 创建具有限制访问时间能力的安全链接。 | | [Slice](https://cn.angie.software//angie/docs/configuration/modules/http/http_slice.md#http-slice) | 将请求拆分为多个子请求以获取单个片段,
以便更好地缓存大型响应。 | | [Split Clients](https://cn.angie.software//angie/docs/configuration/modules/http/http_split_clients.md#http-split-clients) | 创建用于 A/B 测试、金丝雀发布、分片
和其他需要按比例分组的场景的变量。 | | [SSI](https://cn.angie.software//angie/docs/configuration/modules/http/http_ssi.md#http-ssi) | 处理响应中的 SSI(服务器端包含)命令。 | | [SSL](https://cn.angie.software//angie/docs/configuration/modules/http/http_ssl.md#http-ssl) | 用于处理 HTTPS 请求的 SSL/TLS 配置。 | | [Stub Status](https://cn.angie.software//angie/docs/configuration/modules/http/http_stub_status.md#http-stub-status) (已弃用) | 文本格式的全局连接和请求计数器。 | | [Sub](https://cn.angie.software//angie/docs/configuration/modules/http/http_sub.md#http-sub) | 在响应正文中搜索和替换片段。 | | [Upstream](https://cn.angie.software//angie/docs/configuration/modules/http/http_upstream.md#http-upstream) | 配置用于负载均衡的代理服务器组。 | | [Upstream Probe](https://cn.angie.software//angie/docs/configuration/modules/http/http_upstream_probe.md#http-upstream-probe) | 为代理服务器组
配置主动健康探测。 | | [UserID](https://cn.angie.software//angie/docs/configuration/modules/http/http_userid.md#http-userid) | 发放和处理带有唯一客户端标识符的 Cookie
用于会话跟踪和分析。 | | [uWSGI](https://cn.angie.software//angie/docs/configuration/modules/http/http_uwsgi.md#http-uwsgi) | 将请求代理到 uWSGI 服务器。 | | [XSLT](https://cn.angie.software//angie/docs/configuration/modules/http/http_xslt.md#http-xslt) ^[1](#id8) | 使用 XSLT 语言转换 XML 文档。 | ## Stream 模块 | [Stream](https://cn.angie.software//angie/docs/configuration/modules/stream/index.md#stream-core) | 用于在 L4 层面平衡 TCP 和 UDP 协议的
核心流服务器功能。 | |-------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------| | [Access](https://cn.angie.software//angie/docs/configuration/modules/stream/stream_access.md#stream-access) | 基于 IP 地址和 CIDR 范围的访问控制。 | | [ACME](https://cn.angie.software//angie/docs/configuration/modules/stream/stream_acme.md#stream-acme) | 使用 ACME 协议为流服务器
自动获取和续期 SSL 证书。 | | [Geo](https://cn.angie.software//angie/docs/configuration/modules/stream/stream_geo.md#stream-geo) | 将 IP 地址转换为指定的变量值。 | | [GeoIP](https://cn.angie.software//angie/docs/configuration/modules/stream/stream_geoip.md#stream-geoip) | 使用 MaxMind GeoIP 数据库
基于地理位置获取 IP 地址数据。 | | [Limit Conn](https://cn.angie.software//angie/docs/configuration/modules/stream/stream_limit_conn.md#stream-limit-conn) | 限制并发连接数
以防止过载。 | | [Log](https://cn.angie.software//angie/docs/configuration/modules/stream/stream_log.md#stream-log) | 配置会话日志以跟踪资源访问
用于监控和分析目的。 | | [Map](https://cn.angie.software//angie/docs/configuration/modules/stream/stream_map.md#stream-map) | 基于预定义的键值对转换变量。 | | [MQTT Preread](https://cn.angie.software//angie/docs/configuration/modules/stream/stream_mqtt_preread.md#stream-mqtt-preread) | 在做出负载均衡决策之前
从 MQTT 连接中读取客户端标识符和用户名。 | | [Pass](https://cn.angie.software//angie/docs/configuration/modules/stream/stream_pass.md#stream-pass) | 将接受的连接
直接传递到配置的监听套接字。 | | [Proxy](https://cn.angie.software//angie/docs/configuration/modules/stream/stream_proxy.md#stream-proxy) | 配置到其他服务器的代理。 | | [RDP Preread](https://cn.angie.software//angie/docs/configuration/modules/stream/stream_rdp_preread.md#stream-rdp-preread) | 在做出负载均衡决策之前
从 RDP 连接中读取 Cookie。 | | [RealIP](https://cn.angie.software//angie/docs/configuration/modules/stream/stream_realip.md#stream-realip) | 在另一个代理服务器后运行时
确定客户端地址和端口。 | | [Return](https://cn.angie.software//angie/docs/configuration/modules/stream/stream_return.md#stream-return) | 在连接时向客户端发送指定值
而不进行进一步代理。 | | [Set](https://cn.angie.software//angie/docs/configuration/modules/stream/stream_set.md#stream-set) | 设置指定的变量值。 | | [Split Clients](https://cn.angie.software//angie/docs/configuration/modules/stream/stream_split_clients.md#stream-split-clients) | 创建用于 A/B 测试、金丝雀发布、分片
和其他需要按比例分组的场景的变量。 | | [SSL](https://cn.angie.software//angie/docs/configuration/modules/stream/stream_ssl.md#stream-ssl) | SSL/TLS 和 DTLS 协议终止。 | | [SSL Preread](https://cn.angie.software//angie/docs/configuration/modules/stream/stream_ssl_preread.md#stream-ssl-preread) | 在不进行 SSL/TLS 终止的情况下从 `ClientHello` 消息中提取信息,
并在做出负载均衡决策之前使用。 | | [Upstream](https://cn.angie.software//angie/docs/configuration/modules/stream/stream_upstream.md#stream-upstream) | 配置用于负载均衡的代理服务器组。 | | [Upstream Probe](https://cn.angie.software//angie/docs/configuration/modules/stream/stream_upstream_probe.md#stream-upstream-probe) | 为代理服务器组
配置主动健康探测。 | ## 邮件模块 | [Mail](https://cn.angie.software//angie/docs/configuration/modules/mail/index.md#mail-core) | 核心邮件代理服务器功能。 | |----------------------------------------------------------------------------------------------------------------|---------------------------------------------| | [Auth HTTP](https://cn.angie.software//angie/docs/configuration/modules/mail/mail_auth_http.md#mail-auth-http) | 使用 HTTP 请求向外部服务器进行用户身份验证和服务器选择,
以便后续代理。 | | [IMAP](https://cn.angie.software//angie/docs/configuration/modules/mail/mail_imap.md#mail-imap) | IMAP 协议支持。 | | [POP3](https://cn.angie.software//angie/docs/configuration/modules/mail/mail_pop3.md#mail-pop3) | POP3 协议支持。 | | [Proxy](https://cn.angie.software//angie/docs/configuration/modules/mail/mail_proxy.md#mail-proxy) | 配置到其他服务器的代理。 | | [RealIP](https://cn.angie.software//angie/docs/configuration/modules/mail/mail_realip.md#mail-realip) | 在另一个代理服务器后运行时
确定客户端地址和端口。 | | [SMTP](https://cn.angie.software//angie/docs/configuration/modules/mail/mail_smtp.md#mail-smtp) | SMTP 协议支持。 | | [SSL](https://cn.angie.software//angie/docs/configuration/modules/mail/mail_ssl.md#mail-ssl) | SSL/TLS 和 StartTLS 协议支持。 | ## Google PerfTools 模块 | [Google PerfTools](https://cn.angie.software//angie/docs/configuration/modules/google_perftools.md#google-perftools) | 负责与 Google Performance Tools 库集成,
用于应用程序性能分析。 | |------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------| ## WASM 模块 | [WASM](https://cn.angie.software//angie/docs/configuration/modules/wasm/index.md#wasm-core) ^[1](#id8) | 核心 WASM 功能,在 Angie 中启用 WASM 代码执行。 | |--------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------| | [WAMR](https://cn.angie.software//angie/docs/configuration/modules/wasm/wasm_wamr.md#wasm-wamr) | 与
[WebAssembly Micro Runtime](https://github.com/bytecodealliance/wasm-micro-runtime)
集成。 | | [Wasmtime](https://cn.angie.software//angie/docs/configuration/modules/wasm/wasm_wasmtime.md#wasm-wasmtime) | 与 [Wasmtime](https://wasmtime.dev/) 运行时环境集成。 | ### 脚注 * **[1]** 在我们的构建中,这些模块是动态编译的, 并作为 [独立软件包](https://cn.angie.software//angie/docs/installation/index.md#install-packages) 安装; 详细信息请参阅每个模块的说明。