Files
sso/README.md
T
adminandClaude Code c3689d501e chore: SSO-only 精简版初始提交(从 ipass-all 派生)
**影响**:新建独立仓 ipass-sso 作为 ipass-all 的 SSO-only 精简发行版——
剔除了 domain / llm / apix / cache / waf 5 个插件及对应的 nginx location
与 LLM/域名数据面 server,PLUGINS 数组只剩 sso + core,单 .so 体积与编
译时间同步下降。镜像名沿用 ssw188/nginx(同 repo 加 tag),新 tag
`ipass-sso-v0.6.0`,K8s 部署在 wuguirong ns NodePort 30082,与生产
ipass-all-v0.5.2 (30083/30084/30085) 并存互不干扰。

**改动**:
- `rust/Cargo.toml` + `rust/gateway/Cargo.toml`:删 5 个 plugin path 依赖,
  package/lib 重命名为 `ipass-sso-gateway` / `libipass_sso_gateway`
- `rust/gateway/src/lib.rs`:PLUGINS 只剩 `&SsoPlugin` + `&CorePlugin`;
  GatewayExt 4 个方法改为 no-op / 返回默认值(无 domain/llm 装饰);
  ModuleConfig 只剩 api + iap 两个开关;NGX_HTTP_COMMANDS 数组 11→4 条;
  init_process / exit_process 删 llm audit / stats persist 调用;
  state_zone_init 删 domain/upstreams/apix 的预装载
- `rust/gateway/src/api.rs`:删除(h_admin_trend 依赖 llm + apix)
- `deploy/nginx.conf`:删 server 498 (LLM) + server 565 (域名);
  主 server 删 `/apix/` `/apixp/` `/_apix_probe/` 等 7 个 location;
  删 6 条 `proxy_cache_path` 与 8 个 cache location;删 `ipass_audit_dir` 指令
- `deploy/Dockerfile`:删 5 个 plugin named context 的 COPY 块;
  .so 文件名改 `libipass_sso_gateway.so`
- `deploy/build.sh`:TAG 默认 `ipass-sso-v0.6.0`;
  5 个 plugin build-context 删除;删 collect-legacy.sh 调用
- `data-seed/plugin-config.json`:只保留 `sso` 一个 plugin
- `scripts/collect-plugin-dist.sh`:PLUGINS 默认值改 `sso`
- `scripts/container-entrypoint.sh`:删 cache/audit 目录预创建
- `deploy/legacy/` `tests/` `docs/` `deploy/custom/` `deploy/compose.yml`:
  精简版不需要,删除
- `deploy/k8s/ipass-sso.yaml`:新建精简版 K8s manifest
  (NodePort 30082 单端口;replicas=1;同 10106 准入 + nginx-data PVC sso/ subPath;
  探针用 `/admin/` try_files 兜底,与 ipass-all 同款止血方案)

**设计**:保留 ipass-core("core 是网关身份底座,永不跳过")+ ipass-plugin-sso,
其余插件整链剥离;不再维护 ssow/ssw 时代的多插件装配文档。剔除 ipass_audit_dir
是因为精简版没有 LLM 对话审计,剔除 proxy_cache_path 同理。K8s 部署沿用
nginx-data PVC + subPath 隔离模式(sso/ 与 ipass-all/ 互不干扰)。

**已知约束**:精简版仍是单进程共享内存,pod 重启使所有管理员/用户会话失效
(与 ipass-all 同款代价)。精简版不带单元/E2E 测试,老管理台 iframe 集成
也未引入。

Co-Authored-By: Claude Code <[email protected]>
2026-09-30 12:01:38 +08:00

35 lines
1.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# ipass-all
iPass 全插件一体网关:内核 + 6 插件(身份 sso / 域名 domain / LLM 代理 llm /
API 代理 apix / 制品缓存 cache / WAF waf)编译期装配成**单个** nginx 动态模块,
一个容器跑完。单进程、零外部依赖。
## 端口
| 端口 | 承载 |
|---|---|
| 18098 | 管理台 `/admin/` · OIDC(`/.well-known/openid-configuration`)· `/api/*` · apix(`/apix/`、`/apixp/`)· 制品缓存 8 路由(`/go/ /cargo/ /pypi/ /npm/ /maven/ /v2/…`)· 域名转发(`Host: *.ipass.local`) |
| 18099 | LLM 数据面 `<base_url>/<slot>/...`(sk_ Key 鉴权,出站换上游真 Key) |
## 快速开始
```bash
bash deploy/build.sh # 收集前端 + docker build + push 阿里云 CR
kubectl apply -f deploy/k8s/ipass-all.yaml # wuguirong 租户 ns(NodePort 30083/30084)
curl -fs http://192.168.1.26:30083/.well-known/openid-configuration
```
首次登录 `admin / 123456`(立即改密)。各插件能力与配置见管理台对应页。
## 装配清单与顺序
`SsoPlugin → CorePlugin → DomainPlugin → LlmPlugin → ApixPlugin → CachePlugin → WafPlugin → trend`
顺序即端点认领顺序:sso 排第一接管身份端点;trend 组合端点由装配根自己提供。
## 文档
- 构建约束、踩坑与边界 → [`CLAUDE.md`](CLAUDE.md)
- K8s 清单 → [`deploy/k8s/ipass-all.yaml`](deploy/k8s/ipass-all.yaml)
- 各插件自身文档 → 兄弟仓 `ipass-plugin-*/CLAUDE.md`