xfy
2122067efb
- 更新所有 AGENTS.md 时间戳至 2026-04-24 - 添加 converter、e2e、testutil 模块文档 - 更新 README.md：nginx 配置导入、stale 缓存功能说明 - 更新项目统计：132 Go 文件，157 测试文件 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2.2 KiB
2.2 KiB
lolly
Purpose
高性能 HTTP 服务器，类似 nginx 的纯 Go 实现。使用 YAML 配置，单二进制运行，支持静态文件服务、反向代理、负载均衡、SSL/TLS、安全控制等功能。
Key Files
| File | Description |
|---|---|
main.go |
程序入口，CLI 参数解析和启动逻辑 |
go.mod |
Go 模块定义，依赖 fasthttp、zerolog、yaml.v3 |
go.sum |
依赖版本锁定 |
Makefile |
构建脚本，支持多平台编译、测试、覆盖率 |
lolly.yaml |
默认配置文件示例 |
config.example.yaml |
完整配置文件示例（所有字段枚举） |
.gitignore |
Git 忽略规则 |
Subdirectories
| Directory | Purpose |
|---|---|
internal/ |
核心业务代码（不可被外部导入） |
bin/ |
编译输出目录 |
docs/ |
项目文档和实现计划 |
examples/ |
Lua 脚本示例 |
html/ |
静态 HTML 文件（测试/示例） |
scripts/ |
构建/测试辅助脚本（回归检测） |
.github/ |
CI/CD 工作流定义 |
For AI Agents
Working In This Directory
- 这是 Go 项目，使用
go mod管理依赖 - 使用
make build构建二进制文件到bin/目录 - 使用
make test运行测试，make test-cover生成覆盖率报告 - 配置文件使用 YAML 格式，结构定义在
internal/config/config.go - HTTP 库使用 fasthttp（比 net/http 快 6 倍），路由使用 fasthttp/router
- 日志库使用 zerolog（零分配，JSON 输出）
Testing Requirements
- 运行测试前确保依赖已下载：
go mod download - 测试覆盖率目标 >80%
- 使用
make check运行完整检查（fmt + lint + test）
Common Patterns
- 配置结构体使用
yaml标签，通过gopkg.in/yaml.v3解析 - 中间件使用
fasthttp.RequestHandler函数签名 - 版本信息通过
-ldflags在编译时注入 - 信号处理：SIGTERM/SIGINT 快速停止，SIGQUIT 优雅停止
Dependencies
External
github.com/valyala/fasthttp- 高性能 HTTP 服务器github.com/fasthttp/router- 基于 radix tree 的路由器github.com/rs/zerolog- 零分配 JSON 日志库gopkg.in/yaml.v3- YAML 解析库