xfy/lolly
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
580 Commits 1 Branch 7 Tags
Commit Graph

580 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
xfy
42a4c8d311 docs(proxy): 为反向代理模块添加标准化 godoc 注释 
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-04-20 11:23:03 +08:00
xfy
10f3da0954 docs(matcher): 为 location 匹配引擎添加标准化 godoc 注释 
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-04-20 11:23:03 +08:00
xfy
1c3e04afdb docs(lua): 为 Lua API 模块添加标准化 godoc 注释 
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-04-20 11:23:03 +08:00
xfy
2458ac1ed1 docs: 为其余模块添加标准化 godoc 注释 
为剩余模块添加完整文档注释：
- app: 应用生命周期管理
- cache: 文件缓存
- config: 配置加载器
- handler: 静态文件处理和错误页面
- http2/http3: HTTP/2 和 HTTP/3 适配器
- loadbalance: 负载均衡算法和均衡器
- middleware: bodylimit、compression、rewrite、security
- mimeutil: MIME 类型检测
- netutil: URL 处理工具
- resolver: DNS 解析器
- server: 服务器升级处理
- ssl: SSL/TLS 和 OCSP
- stream: 流处理
- testutil: 测试工具
- variable: 变量池和 SSL 变量

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-04-20 10:59:53 +08:00
xfy
088785bce2 docs(logging): 为日志模块添加标准化 godoc 注释 
为 logging 包添加完整的包级和函数级文档：
- Init: 全局日志初始化
- New: 创建日志管理器（支持访问/错误日志分离）
- LogAccess: 记录访问日志
- NewAppLogger: 创建应用日志管理器
- Error/Info/Warn/Debug: 日志级别方法

注释说明支持的日志格式（console、text、json）
和级别（debug、info、warn、error）。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-04-20 10:59:42 +08:00
xfy
0c71a80b5a docs(proxy): 为反向代理模块添加标准化 godoc 注释 
为 proxy 包所有文件添加完整文档注释：
- proxy: 反向代理核心（负载均衡、缓存、WebSocket、SSL/TLS）
- headers: X-Forwarded 系列请求头设置
- health: 后端健康检查
- proxy_ssl: 上游 SSL/TLS 配置
- redirect_rewrite: 重定向响应改写
- tempfile_cleaner: 临时文件清理

包级注释详细说明支持的负载均衡算法、故障转移机制、
代理缓存策略、重定向改写模式等核心功能。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-04-20 10:59:35 +08:00
xfy
6094327620 docs(matcher): 为 location 匹配引擎添加标准化 godoc 注释 
为 matcher 包所有文件添加完整文档注释：
- conflict: 路径冲突检测器
- exact: 精确路径匹配器（O(1) hash map）
- location: 统一匹配引擎（整合所有策略）
- matcher: 匹配结果和接口定义
- named: 命名捕获组匹配器
- prefix: 普通前缀匹配器
- prefix_priority: 前缀优先匹配器（^~）
- radix: Radix Tree 最长前缀匹配
- regex: 正则表达式匹配器

注释说明匹配优先级顺序（精确 > 前缀优先 > 正则 > 普通前缀），
以及各匹配器的使用方法和性能特点。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-04-20 10:59:27 +08:00
xfy
ad177e9640 docs(lua): 为 Lua API 模块添加标准化 godoc 注释 
为所有 Lua API 文件添加完整的包级和函数级文档注释：
- api_balancer: 负载均衡 API（set_current_peer, set_more_tries 等）
- api_ctx: 请求上下文存储 API（ngx.ctx）
- api_location: 子请求捕获 API（ngx.location.capture）
- api_log: 日志输出 API（ngx.log）
- api_req: 请求对象 API
- api_resp: 响应对象 API
- api_shared_dict: 共享字典 API
- api_socket_tcp: TCP socket API
- api_timer: 定时器 API
- api_var: 变量 API
- engine: Lua 引擎核心
- context: 请求上下文管理
- coroutine: 协程调度器
- middleware: 中间件集成
- filter_writer: 响应过滤器
- cache: Lua 脚本缓存
- shared_dict: 共享字典实现
- socket_manager: socket 连接管理

注释格式遵循 Go 官方风格，包含功能说明、参数说明和注意事项。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-04-20 10:59:17 +08:00
xfy
5f5717d6a4 test: 添加各模块覆盖率补充测试 
- middleware/security: access 中间件覆盖率测试
- proxy: proxy 核心功能覆盖率测试
- server: server 扩展功能测试
- stream: stream 处理覆盖率测试

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-04-20 08:27:25 +08:00
xfy
c82e6dcdb7 test(matcher): 添加 location 匹配引擎完整测试覆盖 
- conflict_test.go: 测试 location 冲突检测
- location_test.go: 测试 location 匹配逻辑
- named_test.go: 测试命名捕获组
- prefix_priority_test.go: 测试前缀匹配优先级
- prefix_test.go: 测试前缀匹配
- regex_test.go: 测试正则匹配

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-04-20 08:27:24 +08:00
xfy
7ef16f2be1 test(lua): 添加 api_shared_dict 和 engine 测试覆盖 
- api_shared_dict_test.go: 测试 shared_dict API 功能
- engine_test.go: 测试 Lua 引擎初始化和执行

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-04-20 08:27:24 +08:00
xfy
28be9e7e66 fix(server): 添加 shutdownServers nil ctx 防御性检查 
防止 ctx 参数为 nil 时导致 panic：
- nil ctx 时使用 context.Background() 作为默认值
- 防御性检查确保函数健壮性

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-04-20 08:26:51 +08:00
xfy
d856e3c570 fix(lua): 改进 dictReplace key 存在性检查逻辑 
修复 shared_dict.replace() 方法对过期 key 的判断：
- 区分 key 不存在和 key 存在但已过期的情况
- Get() 返回 val="" 且 expired=false 表示 key 不存在
- 先检查不存在情况，再检查过期情况

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-04-20 08:26:50 +08:00
xfy
5a5f733cb4 refactor(logging): 将日志格式参数从布尔值改为字符串，支持 json/text/console 格式 
将 Init 接口从 pretty bool 参数改为 format string 参数，
支持 json（纯 JSON）、text（无颜色 ConsoleWriter）、console（带颜色）三种格式。
简化 AppLogger 实现，统一使用 zerolog 格式化输出。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-04-17 17:26:08 +08:00
xfy
2ef5fc3b7f docs: update CHANGELOG and README for v0.2.1 release 
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-04-17 16:29:12 +08:00
xfy
8f6991fb3d chore: bump version to 0.2.1 
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
v0.2.1 		2026-04-17 15:07:28 +08:00
xfy
7a589fec18 fix(config): 设置 ClientMaxBodySize 默认值并使配置生成使用该值 
- 将 ClientMaxBodySize 默认值设为 10MB（而非空值）
- 修改 GenerateConfigYAML 使用实际配置值而非硬编码的 1MB
- 使默认配置与生成配置保持一致

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-04-17 15:02:50 +08:00
xfy
bd5a2c0202 feat(resolver): 为 DNS 缓存添加 LRU 淘汰机制 
将 sync.Map 替换为 map + RWMutex，实现基于 cache_size 的 LRU 淘汰：
- 添加 lruOrder 链表追踪访问顺序
- 新增 storeCache 方法处理缓存存储和淘汰
- 添加 evictLRULocked、moveToFrontLocked 辅助方法
- 新增 TestCacheSizeLimit、TestLRUEvictionOrder 等测试

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-04-17 11:31:34 +08:00
xfy
83fc6beba3 refactor(config): 移除 Transport.MaxIdleConnsPerHost 配置字段 
简化连接池配置，仅保留 MaxConnsPerHost 作为总连接上限。
MaxConnsPerHost 已涵盖活跃和空闲连接，无需单独控制空闲连接数。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-04-17 11:31:34 +08:00
xfy
5f60dc9ff7 feat(server): 为静态文件处理添加符号链接安全检查 
在 registerStaticHandlersWithLocationEngine 和 registerStaticHandlers
两个方法中设置 SymlinkCheck 安全检查，防止通过符号链接访问敏感文件。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-04-17 10:41:13 +08:00
xfy
bbf8032e6a refactor(config): 调整 include 配置示例位置 
将 include 配置示例从 SSL 配置前移动到变量配置后的位置，
使配置示例的组织结构更加合理。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-04-17 10:41:13 +08:00
xfy
c929d320c6 chore: 禁用 govet fieldalignment 检查并修复未使用参数 
- govet 禁用 fieldalignment 检查（结构体字段顺序优化不强制）
- ConfigLoader.merge 函数参数 srcPath 改为 _

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-04-17 10:11:57 +08:00
xfy
6281196dfd refactor(server): 优化结构体字段布局并使用 matcher 常量 
- Server 和 VHostManager 结构体字段重新排序优化内存布局
- RegexHostMatcher 字段顺序调整
- 使用 matcher.LocationType* 常量替代硬编码字符串
- server_names 数组支持：遍历注册所有主机名
- 提取 createListener 方法支持 Unix socket

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-04-17 10:11:57 +08:00
xfy
ca03c121d3 refactor(matcher): 提取 LocationType 常量并优化结构体字段布局 
- 添加 LocationType 常量定义替代硬编码字符串
- 优化 MatchResult、ExactMatcher、NamedMatcher 结构体字段顺序
- RadixTree.Insert 添加 locationType 参数用于调试追踪
- 更新测试代码适配新接口

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
 2026-04-17 10:11:45 +08:00
xfy
c418baeb90 feat(vhost): 增强 server_name 匹配支持通配符和正则 
按 nginx server_name 规则实现多类型匹配：
- 精确匹配：example.com
- 前缀通配：*.example.com（最长匹配优先）
- 后缀通配：example.*
- 正则匹配：~regex（按配置顺序）
- 匹配优先级：精确 → 前缀通配 → 后缀通配 → 正则 → 默认

更新 AddHost 返回 error 以支持正则编译错误反馈

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-04-17 09:26:47 +08:00
xfy
359afb5e24 feat(server): 集成 LocationEngine 和 Unix socket 监听支持 
- 使用 LocationEngine 替代 fasthttp/router 进行路由匹配
- 新增 createListener 支持 Unix domain socket 监听
- 支持热升级场景下的 Unix socket 继承
- 新增 registerProxyRoutesWithLocationEngine 和 registerStaticHandlersWithLocationEngine
- 添加 SetUpgradeManager 方法供 App 层注入

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-04-17 09:26:38 +08:00
xfy
1926bf34e0 feat(config): 添加配置引入、Unix socket 和多 server_name 支持 
新增配置功能：
- include 机制：支持 glob 模式引入子配置文件，DAG-safe 循环检测
- unix_socket：Unix domain socket 权限和所有权配置
- server_names：多 server_name 支持（通配符和正则）
- location_type：proxy/static 的位置匹配类型配置
- location_name：命名 location 配置

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-04-17 09:26:30 +08:00
xfy
53eaec57ad feat(matcher): 添加 nginx 风格 location 匹配引擎 
实现 nginx 兼容的 location 匹配系统，支持：
- 精确匹配 (=) - Hash Map O(1)
- 前缀优先匹配 (^~) - Radix Tree
- 正则匹配 (~, ~*) - 按配置顺序
- 普通前缀匹配 - Radix Tree 最长匹配
- 命名 location (@name) - 内部重定向

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-04-17 09:26:22 +08:00
xfy
584ca9170d test(lua,security): 优化测试代码错误返回值处理 
- api_socket_tcp_test.go: 使用空白标识符忽略非关键错误返回值
- auth_test.go: 使用空白标识符忽略不需要的 hash 返回值

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-04-16 18:24:05 +08:00
xfy
9d95aecd6f refactor(lua): 提取常量并优化结构体字段布局 
- api_var.go: 提取 argPrefix 常量，消除魔法字符串
- coroutine.go: 按逻辑分组重排 LuaCoroutine 字段，改善可读性

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-04-16 18:24:05 +08:00
xfy
4000d220f4 test(proxy): 添加 DNS 解析测试覆盖 
- 测试 DNS 解析功能
- 测试解析超时处理
- 测试缓存和刷新机制

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-04-16 18:12:38 +08:00
xfy
734304c5d7 test(server): 添加状态端点完整测试覆盖 
- 测试 JSON/HTML/Text 输出格式
- 测试 localhost IP 限制
- 测试 Enabled 配置项控制
- 测试健康检查和指标输出

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-04-16 18:12:37 +08:00
xfy
3bdecd87eb test(security): 扩展认证和 GeoIP 中间件测试 
- auth_test: 扩展 Basic/JWT/IP 白名单测试
- geoip_test: 扩展 GeoIP 限制和数据库加载测试
- 提高安全中间件测试覆盖率

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-04-16 18:12:29 +08:00
xfy
8f3f1527bc test(loadbalance): 添加负载均衡器完整测试覆盖 
- 测试 RoundRobin/WRR/LeastConn/IPHash 算法
- 测试后端选择和权重分布
- 测试边界条件和并发安全

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-04-16 18:12:28 +08:00
xfy
04f6caa40d test(handler): 添加静态文件发送处理测试 
- 测试 SendFile 基本功能和错误处理
- 测试 Range 请求支持
- 测试不同文件类型和 MIME 类型

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-04-16 18:12:28 +08:00
xfy
05a414d1bb feat(server): 添加 Purge 测试导出方法和安全检查 
- purgeByPath/purgeByPattern 添加 nil server 检查
- 导出 PurgeByPathForTest/PurgeByPatternForTest 用于测试
- 添加 purge.go 全面单元测试覆盖
- 添加 cache purge 测试验证缓存清理功能

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-04-16 18:12:16 +08:00
xfy
f123018f2d feat(lua): 增强变量 API 支持数值类型返回和测试覆盖 
- 新增 getVariableLua 方法返回 Lua 类型而非字符串
- request_length 等变量返回数值类型而非字符串
- luaVarNewIndex 支持 nil 值转换为空字符串
- 添加 api_var 全面的单元测试覆盖
- 添加 api_ctx 上下文 API 测试
- 添加 api_socket_tcp TCP socket 测试

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-04-16 18:12:16 +08:00
xfy
bec8932561 feat(server): 添加缓存清理 API 支持 
新增 PurgeHandler 处理器，支持：
- 按精确路径和通配符模式清理缓存
- HTTP 方法过滤（默认 GET）
- IP 白名单访问控制（CIDR/单 IP/localhost）
- Token 认证保护
- 三种启动模式路由注册

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-04-16 16:47:10 +08:00
xfy
87cd41a81f docs(config): 添加 default/cache_valid/proxy_ssl 配置示例注释 
补充 GenerateConfigYAML 输出的配置示例：
- default: 虚拟主机模式下标记默认服务器
- cache_valid: 按 HTTP 状态码细分缓存时间
- proxy_ssl: 上游 SSL/TLS 连接配置（含 mTLS 支持）

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-04-16 15:16:14 +08:00
xfy
8daab83d78 feat(status): 添加 HTML/Text 输出格式和 localhost IP 支持 
扩展状态端点输出格式支持：
- json: 默认 JSON 格式
- text: 纯文本格式，便于终端查看
- html: HTML 表格格式，便于浏览器查看
- prometheus: Prometheus 指标格式

Allow 配置新增 "localhost" 特殊值支持，自动解析为
127.0.0.1/32 和 ::1/128，简化本地调试配置。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-04-16 15:07:12 +08:00
xfy
5625fdccc6 feat(status): 添加 Enabled 配置项显式控制状态端点启用 
StatusConfig 新增 Enabled 字段，默认为 false 需显式启用。
修改 server.go 仅在 Enabled=true 时注册状态端点。
更新测试文件适配新配置结构。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-04-16 15:06:50 +08:00
xfy
75317b44dd build(docker): 添加 Docker 构建支持 
- Dockerfile: 添加 GOPROXY/GOSUMDB 代理设置，优化编译参数
- Makefile: 添加 docker/docker-push/docker-clean 命令

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-04-16 14:12:32 +08:00
xfy
8ed800271d test: 迁移基准测试循环到 Go 1.24 b.Loop() API 
- 所有 *_bench_test.go 文件从 for i := 0; i < b.N; i++ 改为 for b.Loop()
- 部分测试文件从 for i := 0; i < N; ... 改为 for range N 或 for i := range N
- 涵盖模块: cache, handler, http2, http3, loadbalance, logging, lua,
  middleware/accesslog, middleware/bodylimit, middleware/rewrite,
  middleware/security, netutil, resolver, server, ssl, stream

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-04-16 13:50:15 +08:00
xfy
326eedc729 perf(proxy,logging,compression): 使用零拷贝字节路径减少内存分配 
- proxy: headersPool sync.Pool 复用 header map，容量 20
- proxy: buildCacheKeyHash 使用池化 map 替代 make(map[string]string)
- proxy: ServeHTTP 目标 URI 构造使用 []byte append + SetRequestURIBytes
- headers: X-Forwarded-For 构造使用 []byte append + SetBytesKV
- logging: Str() 改为 Bytes() 零拷贝日志字段
- compression: Process() 直接操作 []byte，使用 bytes.Contains/Equal/HasPrefix
- compression: isCompressible() 签名从 string 改为 []byte

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-04-16 13:50:15 +08:00
xfy
dc7358bf4e feat(variable): 添加 EphemeralGet 和 PersistentGet 零拷贝变量访问 API 
- 新增 EphemeralGet() 方法返回 []byte，用于请求范围内的零拷贝访问
- 新增 PersistentGet() 方法返回 string，用于跨请求持久存储
- BuiltinVariable 结构体添加 GetterBytes 字段支持字节获取器
- Context 结构体添加 bytesCache map 缓存字节值
- 为 $host、$request_uri、$uri、$args、$request_method 添加字节获取器
- 添加完整的单元测试和性能基准测试

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-04-16 13:50:15 +08:00
xfy
ddc9e0cef1 test(integration): 添加端到端集成性能基准测试 
覆盖静态文件、代理转发、中间件链、Lua 脚本和多路由场景的完整请求路径吞吐量。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-04-16 11:44:45 +08:00
xfy
fdefaefdb3 test(ssl): 添加 SSL/TLS 性能基准测试 
覆盖 TLS 握手、证书加载、会话恢复和 OCSP 装订性能。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-04-16 11:44:45 +08:00
xfy
8a2e118ab8 test(proxy): 添加 WebSocket 代理性能基准测试 
覆盖握手升级请求构建、不同帧大小转发吞吐量和心跳往返延迟。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-04-16 11:44:45 +08:00
xfy
76c9e9df54 test(http2): 添加 HTTP/2 服务器性能基准测试 
覆盖 HTTP/2 帧编码、HPACK 头部压缩、流管理开销和完整请求往返延迟。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-04-16 11:44:45 +08:00
xfy
79f7ed38f0 perf(server): 添加 goroutine 池对象池化效果验证基准测试 
添加 BenchmarkGoroutinePoolObjectPool 测试池任务上下文复用能力，
添加 BenchmarkGoroutinePoolParallelSubmit 测试并发提交吞吐量，
验证 PoolTask 零分配复用场景。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-04-16 11:44:32 +08:00