Repository navigation
Releases
Releases · ffseika0304/shanhai-gateway
v0.5.1 — 克隆完整性与看板修复
三个修复,装了 v0.5.0 的请务必升级:
- 克隆完整性(关键):
.gitignore的runtime/、shg两条未锚定规则误伤了internal/runtime源码包与cmd/shg入口——v0.5.0 克隆下来不可编译(本地镜像从磁盘构建所以未暴露)。规则已全部锚定到仓库根。 - 看板兜底模型可见:
/api/stats从候选表遍历改为全量在册,兜底后端(如按量兜底)进入看板「兜底模型」表;sidecar 显式跳过兜底行,行为零变化。 - wb-panel 导航同主机回退:看板 WorkBuddy 跳转默认指向当前主机的
:7863/panel/,不再需要手动 localStorage。
克隆自检:go build ./... && go test ./... 全绿。
v0.5.0 · 天下第一关 — 首个公开发布
ShanHaiGateway · 山海关 — v0.5.0
两京锁钥无双地,万里长城第一关。 多上游 LLM API 网关,首个公开发布。
✨ 特性
- 🚦 SWRR 加权轮转 + 兜底链隔离 —— 权重/并发/超时逐后端可调
- ❄️ 错误分类学驱动的冷却 —— 配额类指数退避 5m→4h,满载排队不甩 503,客户端断连不惩罚
- 📌 任务级会话亲和 —— 优先
X-Job-Id、退回X-Session-Key,前缀缓存命中率实测 27% → 51%(峰值 69%) - 🧩 quirk 怪癖层 —— 按家差异独立演进,内核零按名分支
- 🔭 影子留存观测 —— attempts/captures 落库前自动脱敏,
/api/stats细粒度看板 - 👥 多用户下游 key 计费 ——
sk-user-*额度核发 + 可插拔登录 - 🩺 sidecar 慢周期自愈 —— 独立 Python 进程,零第三方依赖
- 🐳 Docker 一把梭 —— 多阶段构建、纯 Go SQLite 零 CGO、非 root、healthcheck、镜像零密钥
🚀 三分钟起一个
git clone https://github.com/ffseika0304/shanhai-gateway.git && cd shanhai-gateway
mkdir -p runtime/config runtime/data
cp config/backends.example.json runtime/config/backends.json # 改成你的后端
cp config/keys.example.json runtime/config/keys.json # 改成你的下游 key
docker compose -f deploy/docker-compose.yml up -d --build
curl -s http://127.0.0.1:18016/health🛡️ 这不是又一个轮询器
README 的运维语义里有八条规则,
每条背后都是一次真实事故:1720×503 断连风暴、后端空转四天半无人发现、403 自锁循环……
排队、冷却、断连判定的每一个魔法数字,都是被产线流量校准过的。
如果对你有帮助,给个 Star ⭐