docs/config/
├── README.md                    # 本说明文件
├── basic/                       # 基础配置
│   ├── static-server.conf       # 静态文件服务器
│   ├── reverse-proxy.conf       # 反向代理基础配置
│   └── virtual-host.conf        # 虚拟主机配置
├── ssl/                         # SSL/TLS 配置
│   ├── basic-ssl.conf           # 基础 HTTPS 配置
│   ├── mtls.conf                # 双向 TLS 认证
│   ├── ocsp-stapling.conf       # OCSP Stapling 配置
│   └── hsts.conf                # HSTS 安全配置
├── load-balancing/              # 负载均衡配置
│   ├── round-robin.conf         # 轮询负载均衡
│   ├── weighted.conf            # 加权负载均衡
│   ├── least-conn.conf          # 最少连接负载均衡
│   ├── ip-hash.conf             # IP 哈希会话保持
│   └── consistent-hash.conf     # 一致性哈希
├── advanced/                    # 高级功能配置
│   ├── websocket.conf           # WebSocket 代理
│   ├── grpc.conf                # gRPC 代理
│   ├── http2.conf               # HTTP/2 配置
│   ├── http3.conf               # HTTP/3 (QUIC) 配置
│   ├── stream-tcp.conf          # TCP Stream 代理
│   └── stream-udp.conf          # UDP Stream 代理
├── security/                    # 安全配置
│   ├── rate-limit.conf          # 请求速率限制
│   ├── conn-limit.conf          # 连接数限制
│   ├── access-control.conf      # IP 访问控制
│   ├── basic-auth.conf          # Basic 认证
│   ├── security-headers.conf    # 安全响应头
│   └── auth-request.conf        # 外部认证子请求
├── caching/                     # 缓存配置
│   ├── proxy-cache.conf         # 代理响应缓存
│   ├── gzip.conf                # Gzip 压缩
│   └── brotli.conf              # Brotli 压缩
├── rewriting/                   # URL 重写配置
│   ├── rewrite-rules.conf       # URL 重写规则
│   ├── redirect.conf            # 重定向配置
└── lua/                         # Lua 脚本配置
    ├── basic-lua.conf           # 基础 Lua 使用
    ├── access-by-lua.conf       # access_by_lua 认证
    ├── content-by-lua.conf      # content_by_lua 内容生成
    ├── balancer-by-lua.conf     # balancer_by_lua 动态负载均衡
    └── shared-dict.conf         # lua_shared_dict 共享字典

配置对照说明

每个 nginx 配置文件都配有对应的 lolly YAML 配置注释，说明 lolly 如何实现相同功能。

使用目的

功能对照: 明确 nginx 配置指令与 lolly 配置项的对应关系
兼容性测试: 用于验证 lolly 实现的功能是否符合预期
迁移参考: 帮助用户从 nginx 配置迁移到 lolly 配置

配置来源

基于 nginx 官方文档和最佳实践整理，参考：

nginx 官方文档: https://nginx.org/en/docs/
OpenResty 文档: https://openresty.org/

功能对照表

负载均衡

nginx 指令	Lolly 配置
`upstream { server ...; }`	`proxy.targets` 列表
`weight=N`	`targets[].weight: N`
`least_conn;`	`load_balance: "least_conn"`
`ip_hash;`	`load_balance: "ip_hash"`
`hash $key consistent;`	`load_balance: "consistent_hash"`

SSL/TLS

nginx 指令	Lolly 配置
`ssl_certificate`	`ssl.cert`
`ssl_certificate_key`	`ssl.key`
`ssl_protocols`	`ssl.protocols`
`ssl_ciphers`	`ssl.ciphers`
`ssl_stapling on`	`ssl.ocsp_stapling: true`
`add_header Strict-Transport-Security`	`ssl.hsts`
`ssl_verify_client`	`ssl.client_verify.mode`
`ssl_client_certificate`	`ssl.client_verify.client_ca`

安全

nginx 指令	Lolly 配置
`limit_req zone`	`security.rate_limit.request_rate`
`limit_conn zone`	`security.rate_limit.conn_limit`
`allow/deny`	`security.access.allow/deny`
`auth_basic`	`security.auth.type: "basic"`
`auth_request`	`security.auth_request.enabled: true`
`add_header X-Frame-Options`	`security.headers.x_frame_options`

代理

nginx 指令	Lolly 配置
`proxy_pass`	`proxy[].targets[].url`
`proxy_set_header`	`proxy[].headers.set_request`
`proxy_cache`	`proxy[].cache.enabled`
`proxy_next_upstream`	`proxy[].next_upstream`
`grpc_pass`	HTTP/2 + gRPC 协议支持

压缩

nginx 指令	Lolly 配置
`gzip on`	`compression.type: "gzip"`
`gzip_comp_level`	`compression.level`
`gzip_types`	`compression.types`
`gzip_static on`	`compression.gzip_static`
`brotli on`	`compression.type: "brotli"`

高级功能

nginx 功能	Lolly 支持
WebSocket 代理	✓ 自动协议升级
HTTP/2	✓ `ssl.http2.enabled`
HTTP/3 (QUIC)	✓ `http3.enabled`
TCP/UDP Stream	✓ `stream` 配置
URL 重写	✓ `rewrite` 配置
Lua 脚本	✓ 内置 Lua 沙箱

统计

配置文件总数: 33 个
覆盖功能: 负载均衡、SSL/TLS、安全、代理、缓存、重写、Lua 等