18e4f7e891
- ServerConfig 新增 Host 字段:空=监听所有接口(兼容),设值=绑定指定地址 (127.0.0.1 仅本机 / 内网IP 绑定指定网卡),避免生产暴露 0.0.0.0 - app.go 启动地址改 host:port,日志区分"所有接口"/指定地址 - 面向用户/调用的文案统一中文: - middleware/recover.go: "Panic recovered"→"panic 已恢复","Panic: %v"→"服务器内部错误: %v" - middleware/logger.go: 5 处日志消息改中文 - middleware/metrics.go: 3 个 Prometheus Help 改中文 - app.go/database/manager.go/logger.go: 英文 error 改中文 - 保留英文:JSON 协议字段名、Prometheus metric Name、MySQL 错误串匹配、技术专有名词 - CLI 模板与 example 配置加 host 注释 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
xlgo 示例
两个可运行示例,帮助快速上手 xlgo。
minimal — 最小 HTTP 服务
不依赖 MySQL / Redis / Storage,纯 HTTP + 健康检查。第一次接触 xlgo 从这里开始。
go run ./examples/minimal
访问 http://localhost:8081/health(健康检查)与 http://localhost:8081/api/v1/(示例路由)。
full — 完整业务 API
包含 MySQL + Redis + JWT + 一个 user CRUD(登录发 token、认证路由、创建/查询用户)。
运行前需准备:
- MySQL(修改
examples/full/config.yaml的database配置) - Redis(修改
examples/full/config.yaml的redis配置)
go run ./examples/full
启动后自动迁移 user 表。接口:
| 方法 | 路径 | 说明 | 认证 |
|---|---|---|---|
| POST | /api/v1/login | 登录,返回 token | 否 |
| GET | /api/v1/users/:id | 查询用户 | 是(Bearer token) |
| POST | /api/v1/users | 创建用户 | 是(Bearer token) |
登录示例:
curl -X POST http://localhost:8082/api/v1/login \
-H "Content-Type: application/json" \
-d '{"username":"alice","password":"secret"}'
示例代码为演示用途,密码明文存储、未做参数校验,生产环境请使用 bcrypt 哈希密码并配合
validation包校验入参。