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]>
This commit is contained in:
adminandClaude Code committed 2026-09-30 12:01:38 +08:00
commit c3689d501e
21 files changed
+3964

No files matched your search

+81
View File
@@ -0,0 +1,81 @@
#!/usr/bin/env bash
# ============================================================================
# collect-plugin-dist.sh —— 收集管理台前端产物到可部署目录
#
# 形状与 ipass-sso / ipass-ssw 的同名脚本一致(Ruling 16/19):
# - 核心壳来自 ipass-core/www/dist(SPA:index.html + assets)
# - 插件管理页是 UMD 产物,壳按 /static/plugins/<name>/dist/<name>-admin.umd.js
# 动态加载(寻址约定见 ipass-core www loader.ts;<name> = Plugin::name() 短名)
#
# Docker 构建上下文只覆盖本仓,COPY 不到兄弟仓库,故先把产物聚合进
# deploy/,再由 Dockerfile COPY 进镜像。
#
# 输出布局:
# deploy/shell/ ← ../ipass-core/www/dist
# deploy/static-plugins/<name>/dist/ ← ../ipass-plugin-<name>/www/dist
#
# 插件清单 = 本仓装配的全部插件(精简版只装 sso;其他插件仓不存在时自动跳过并告警)。
# 用法:bash scripts/collect-plugin-dist.sh # → deploy/
# ============================================================================
set -euo pipefail
HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
ROOT="$(cd "$HERE/.." && pwd)"
IPASS_DIR="${IPASS_DIR:-$(cd "$ROOT/.." && pwd)}"
ASSEMBLY_DIR="${ASSEMBLY_DIR:-deploy}"
case "$ASSEMBLY_DIR" in
/*) OUT="$ASSEMBLY_DIR" ;;
*) OUT="$ROOT/$ASSEMBLY_DIR" ;;
esac
SHELL_SUB="${SHELL_SUB:-shell}"
PLUGINS_SUB="${PLUGINS_SUB:-static-plugins}"
# 本仓 gateway 装配的插件短名(顺序无关;缺 dist 自动跳过并告警)
PLUGINS="${PLUGINS:-sso}"
# ---------------------------------------------------------------------------
# 1) 核心壳(默认 ipass-core www dist;**装配仓可用自己的 shell/dist 覆写**——
# 2026-09-26 架构定案第 2 条:各装配默认用 core 框架,也可整体重写壳)
# ---------------------------------------------------------------------------
SHELL_SRC="$IPASS_DIR/ipass-core/www/dist"
if [ -d "$ROOT/shell/dist" ] && [ -f "$ROOT/shell/dist/index.html" ]; then
SHELL_SRC="$ROOT/shell/dist"
echo "装配仓自带壳,覆盖 core 默认:$SHELL_SRC"
fi
SHELL_OUT="$OUT/$SHELL_SUB"
[ -d "$SHELL_SRC" ] || { echo "!! core shell dist 缺失:$SHELL_SRC(先在 ipass-core/www 跑 npm run build)" >&2; exit 1; }
mkdir -p "$SHELL_OUT"
rsync -a --delete --exclude .gitkeep "$SHELL_SRC/" "$SHELL_OUT/"
echo "shell : $SHELL_SRC → $SHELL_OUT"
# ---------------------------------------------------------------------------
# 2) 各插件的管理页 dist
# ---------------------------------------------------------------------------
PLUGINS_OUT="$OUT/$PLUGINS_SUB"
mkdir -p "$PLUGINS_OUT"
# 清空旧收集产物但保留 .gitkeep(Dockerfile COPY 依赖目录存在)
find "$PLUGINS_OUT" -mindepth 1 -maxdepth 1 ! -name .gitkeep -exec rm -rf {} +
count=0
for short in $PLUGINS; do
src="$IPASS_DIR/ipass-plugin-${short}/www/dist"
if [ ! -d "$src" ]; then
echo "!! ${short}:$src 缺失(先在 ipass-plugin-${short}/www 跑 npm run build),跳过" >&2
continue
fi
mkdir -p "$PLUGINS_OUT/$short/dist"
rsync -a --delete "$src/" "$PLUGINS_OUT/$short/dist/"
# 产物原文件名是 plugin-<短名>-admin.umd.js;壳按短名请求
# /static/plugins/<短名>/dist/<短名>-admin.umd.js → 补一份短名别名
if [ ! -f "$PLUGINS_OUT/$short/dist/${short}-admin.umd.js" ] \
&& [ -f "$PLUGINS_OUT/$short/dist/plugin-${short}-admin.umd.js" ]; then
cp "$PLUGINS_OUT/$short/dist/plugin-${short}-admin.umd.js" \
"$PLUGINS_OUT/$short/dist/${short}-admin.umd.js"
fi
echo "plugin: $src → $PLUGINS_OUT/$short/dist"
count=$((count + 1))
done
echo "完成:shell + ${count} 个插件 → $OUT"
+74
View File
@@ -0,0 +1,74 @@
#!/usr/bin/env bash
# ============================================================================
# 容器入口脚本(首发 + 每次启动都跑)
#
# 干的事:
# 1. 首次启动:data/ 为空时跑 seed-data.sh,生成 admin/123456 + alice/alice123
# 2. 每次启动:把容器外的 env(OAUTH_ISSUER 等)打印出来供排障
# 3. nginx -t 语法预检
# 4. exec nginx(让 nginx 拿到 PID 1,否则 stop signal 收不到)
#
# 设计:
# - nginx.test.conf 用了 env 占位(OAUTH_ISSUER / OAUTH_SIGNING_SECRET 等),
# nginx 启动时会从环境变量读取,无需重新渲染模板
# - seed-data.sh 用 python3 算 SHA-256 散列(与 rust/src/util.rs::hash_password
# 逐位一致:sha256("salt:password") 后迭代 1000 轮 sha256(x + salt))
# ============================================================================
set -euo pipefail
DATA_DIR="/usr/local/nginx/data"
SEED_DIR="/usr/local/nginx/data-seed"
NGINX_CONF="/usr/local/nginx/conf/nginx.conf"
LOG_DIR="/usr/local/nginx/logs"
c_ok() { printf '\033[32m✓\033[0m %s\n' "$*"; }
c_warn() { printf '\033[33m!\033[0m %s\n' "$*"; }
c_err() { printf '\033[31m✗\033[0m %s\n' "$*" >&2; }
# ---------------------------------------------------------------- 0. 基础目录
mkdir -p "$DATA_DIR" "$LOG_DIR"
# ---------------------------------------------------------------- 1. 打印关键 env(排障)
printf '\n== ipass-sso 启动参数 ==\n'
c_ok "OAUTH_ISSUER = ${OAUTH_ISSUER:-<未设置,默认走 nginx.conf 占位>}"
c_ok "OAUTH_COOKIE_DOMAIN= ${OAUTH_COOKIE_DOMAIN:-<未设置>}"
c_ok "ADMIN_USER = ${ADMIN_USER:-admin}"
if [ -n "${ADMIN_PASSWORD:-}" ]; then
c_ok "ADMIN_PASSWORD = <已注入>"
else
c_warn "ADMIN_PASSWORD = <未注入>,seed 将使用默认 123456"
fi
if [ -n "${OAUTH_SIGNING_SECRET:-}" ]; then
c_ok "OAUTH_SIGNING_SECRET= <已注入>"
else
c_warn "OAUTH_SIGNING_SECRET= <未注入>,seed 将生成随机值(重启即丢!)"
fi
# ---------------------------------------------------------------- 2. 数据物化(首次启动)
NEED_SEED=0
[ ! -f "$DATA_DIR/users.json" ] && NEED_SEED=1
[ ! -f "$DATA_DIR/oauth_clients.json" ] && NEED_SEED=1
if [ "$NEED_SEED" = "1" ]; then
printf '\n== 首次启动:seed-data.sh 物化 admin/alice ==\n'
# nginx worker 是 nobody(uid 65534),必须可写
chown -R 65534:65534 "$DATA_DIR" 2>/dev/null || c_warn "chown 65534 失败(继续)"
ADMIN_PASSWORD="${ADMIN_PASSWORD:-123456}" \
ALICE_PASSWORD="${ALICE_PASSWORD:-alice123}" \
DATA_DIR="$DATA_DIR" \
SEED_DIR="$SEED_DIR" \
bash /usr/local/nginx/scripts/seed-data.sh || \
{ c_err "seed-data.sh 失败"; exit 1; }
c_ok "data 目录物化完成"
else
c_ok "data 目录已有,跳过 seed"
fi
# ---------------------------------------------------------------- 3. nginx 语法预检
printf '\n== nginx -t ==\n'
/usr/local/nginx/sbin/nginx -t -c "$NGINX_CONF" 2>&1 || { c_err "nginx 配置语法错误"; exit 1; }
# ---------------------------------------------------------------- 4. exec nginx(PID 1 拿信号)
printf '\n== 起 nginx ==\n'
exec /usr/local/nginx/sbin/nginx -c "$NGINX_CONF" -g 'daemon off;'
+65
View File
@@ -0,0 +1,65 @@
#!/usr/bin/env bash
# push-init.sh —— 读取 ~/.ssw.ini [credential-git-18] 建仓(Gitea API)并推送 ipass-all
# 密钥只在脚本进程内流转,任何输出过滤掉口令字面量
set -euo pipefail
INI="$HOME/ssw.ini"
HOST="192.168.1.18:13300"
ORG="ipass"
REPO="ipass-all"
read_ini() { # read_ini <key>
awk -F= -v sec="credential-git-18" -v key="$1" '
/^\[/ { f = ($0 ~ "\\[" sec "\\]") ? 1 : 0; next }
f && $1 ~ key { gsub(/\r/, "", $2); gsub(/^ +| +$/, "", $2); print $2; exit }
' "$INI"
}
U="$(read_ini username)"
P="$(read_ini password)"
[ -n "$U" ] && [ -n "$P" ] || { echo "FAIL: ini 解析不到凭证"; exit 1; }
sanitized() { # 吞掉可能夹带的口令字面量
grep -v "$P" | head -c 300
}
# 1) 若仓库已存在则跳过建仓
CODE=$(curl -s -o /tmp/repo-check.json -w '%{http_code}' -u "$U:$P" "http://$HOST/api/v1/repos/$ORG/$REPO")
if [ "$CODE" = "200" ]; then
echo "仓库已存在: $ORG/$REPO"
else
echo "建仓 org/$REPO …"
RES=$(curl -s -u "$U:$P" -X POST "http://$HOST/api/v1/org/$ORG/repos" \
-H 'Content-Type: application/json' \
-d '{"name":"ipass-all","private":true,"auto_init":false,"description":"iPass 全插件一体网关(内核+6插件单.so单容器)"}')
if echo "$RES" | grep -q '"full_name"'; then
echo "建仓 OK"
else
echo "org 域建仓失败,尝试用户域 …"
RES=$(curl -s -u "$U:$P" -X POST "http://$HOST/api/v1/user/repos" \
-H 'Content-Type: application/json' \
-d '{"name":"ipass-all","private":true,"auto_init":false}')
if echo "$RES" | grep -q '"full_name"'; then
ORG="$U"
echo "建仓 OK(用户域: $U/$REPO)"
else
echo "FAIL: 建仓被拒"; echo "$RES" | sanitized; exit 1
fi
fi
fi
# 2) 挂远端(干净 URL,凭证走一次性 credential helper,不写入 .git/config)
cd "$(dirname "$0")"
git remote remove origin 2>/dev/null || true
git remote add origin "http://$HOST/$ORG/$REPO.git"
echo "推送 main …"
if git \
-c credential.helper= \
-c "credential.helper=!f(){ printf 'username=%s\n' '$U'; printf 'password=%s\n' '$P'; }; f" \
push -u origin main 2>&1 | sanitized | tail -3; then
echo "PUSH OK: $ORG/$REPO (main)"
else
echo "PUSH FAIL(上方为过滤后输出)"
exit 1
fi
+171
View File
@@ -0,0 +1,171 @@
#!/usr/bin/env bash
# ============================================================================
# 物化运行时数据目录:data-seed/ -> data/
#
# 为什么需要这一步
# data/ 是**运行时**目录(可写、含真实口令散列),不进版本库;
# data-seed/ 是**种子模板**(只放演示客户端与示例账号),进版本库。
# 本脚本把两者接起来,并顺便把示例里的占位符换成真实值。
#
# 做的事:
# 1. data/oauth_clients.json <- data-seed/oauth_clients.json
# 2. data/users.json <- 由本脚本生成(admin / alice 两个账号)
# 3. data/users.json.example <- 同步一份示例(占位符,不含真实散列)
#
# 幂等:users.json 已存在时**默认不动**(避免覆盖你手工改过的账号),要重建加 --force。
#
# 用法:
# bash scripts/seed-data.sh # 缺什么补什么
# bash scripts/seed-data.sh --force # 重建 users.json(会丢已有账号)
# DATA_DIR=/path ADMIN_PASSWORD=xxx bash scripts/seed-data.sh
#
# 口令来源:ADMIN_PASSWORD(默认 123456)、ALICE_PASSWORD(默认 alice123)。
# 这两个默认值只用于**本机/CI 演示**,生产部署必须覆盖。
# ============================================================================
set -euo pipefail
HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
ROOT="$(cd "$HERE/.." && pwd)"
SEED_DIR="${SEED_DIR:-$ROOT/data-seed}"
DATA_DIR="${DATA_DIR:-$ROOT/data}"
ADMIN_PASSWORD="${ADMIN_PASSWORD:-123456}"
ALICE_PASSWORD="${ALICE_PASSWORD:-alice123}"
FORCE=0
for a in "$@"; do [ "$a" = "--force" ] && FORCE=1; done
PYTHON="${PYTHON:-python3}"
[ -d "$SEED_DIR" ] || { echo "!! 种子目录缺失:$SEED_DIR" >&2; exit 1; }
mkdir -p "$DATA_DIR"
# ---------------------------------------------------------------------------
# 1. OAuth 接入方注册表:直接拷贝(没有则视为空表)
# ---------------------------------------------------------------------------
if [ -f "$SEED_DIR/oauth_clients.json" ]; then
if [ ! -f "$DATA_DIR/oauth_clients.json" ] || [ "$FORCE" = "1" ]; then
cp "$SEED_DIR/oauth_clients.json" "$DATA_DIR/oauth_clients.json"
echo " [seed] oauth_clients.json 已写入 $DATA_DIR/oauth_clients.json"
else
echo " [seed] oauth_clients.json 已存在,跳过"
fi
else
echo " [seed] 警告:$SEED_DIR/oauth_clients.json 不存在,注册表留空"
fi
# ---------------------------------------------------------------------------
# 1.5 插件启停注册表(R19):拷种子(缺省语义是「未列出 = 启用」,但显式
# 注册表让管理台/运维一眼看清装配了哪些插件,禁用也只改这一个文件)
# ---------------------------------------------------------------------------
if [ -f "$SEED_DIR/plugin-config.json" ]; then
if [ ! -f "$DATA_DIR/plugin-config.json" ] || [ "$FORCE" = "1" ]; then
cp "$SEED_DIR/plugin-config.json" "$DATA_DIR/plugin-config.json"
echo " [seed] plugin-config.json 已写入 $DATA_DIR/plugin-config.json"
else
echo " [seed] plugin-config.json 已存在,跳过"
fi
fi
# ---------------------------------------------------------------------------
# 2. 账号表:生成真实散列。
#
# ⚠️ 散列算法必须与 rust/src/util.rs::hash_password 逐位一致,
# 否则生成的账号永远登录不上:
# x = sha256("salt:password") ← 注意中间是冒号
# 重复 HASH_ROUNDS(=1000,见 config.rs) 次:x = sha256(x + salt)
# 改了拼接顺序或轮数,存量 users.json 会全部失效。
# ---------------------------------------------------------------------------
if [ -f "$DATA_DIR/users.json" ] && [ "$FORCE" != "1" ]; then
echo " [seed] users.json 已存在,跳过(要重建加 --force)"
else
ADMIN_PASSWORD="$ADMIN_PASSWORD" ALICE_PASSWORD="$ALICE_PASSWORD" \
OUT="$DATA_DIR/users.json" USERS_EXAMPLE="$SEED_DIR/users.json.example" \
"$PYTHON" - <<'PYEOF'
import hashlib, json, os, secrets
HASH_ROUNDS = 1000 # 必须与 rust/src/config.rs 的 HASH_ROUNDS 一致
def pwd_hash(salt, password):
x = hashlib.sha256(("%s:%s" % (salt, password)).encode()).hexdigest()
for _ in range(HASH_ROUNDS):
x = hashlib.sha256((x + salt).encode()).hexdigest()
return x
def entry(username, display_name, password, role, email, department, groups,
api_key, created_at=1768000000):
salt = secrets.token_hex(16) # 32 位 hex
return {
"username": username,
"display_name": display_name,
"role": role,
"salt": salt,
"pwd_hash": pwd_hash(salt, password),
"api_key": api_key,
"email": email,
"department": department,
"groups": groups,
"created_at": created_at,
}
users = {
"admin": entry(
"admin", "管理员", os.environ["ADMIN_PASSWORD"], "admin",
"[email protected]", "平台", ["admin"],
"sk_" + secrets.token_hex(20),
),
"alice": entry(
"alice", "爱丽丝", os.environ["ALICE_PASSWORD"], "user",
"[email protected]", "研发部", ["rd", "eng"],
"sk_" + secrets.token_hex(20),
),
}
out = os.environ["OUT"]
with open(out, "w", encoding="utf-8") as f:
json.dump(users, f, ensure_ascii=False, indent=2)
f.write("\n")
# 同步一份「占位符版」示例回种子目录,让后来人一眼看懂字段含义
HASH_NOTE = "sha256('<salt>:<password>') 后迭代 1000 轮 sha256(x + salt)"
example = {
"admin": {
"username": "admin",
"display_name": "管理员",
"role": "admin",
"salt": "<openssl rand -hex 16>",
"pwd_hash": "<%s>" % HASH_NOTE,
"api_key": "sk_<随机>",
"email": "[email protected]",
"department": "平台",
"groups": ["admin"],
"created_at": 0,
},
"alice": {
"username": "alice",
"display_name": "爱丽丝",
"role": "user",
"salt": "<openssl rand -hex 16>",
"pwd_hash": "<%s>" % HASH_NOTE,
"api_key": "sk_<随机>",
"email": "[email protected]",
"department": "研发部",
"groups": ["rd", "eng"],
"created_at": 0,
},
}
# 回写占位符示例只对「仓库内 host 流程」有意义(容器里种子目录在只读镜像层,
# 写不进也不该写——10106 非 root 跑会在这里 PermissionError 打断整个 seed)
example_path = os.environ["USERS_EXAMPLE"]
if os.access(example_path, os.W_OK):
with open(example_path, "w", encoding="utf-8") as f:
json.dump(example, f, ensure_ascii=False, indent=2)
f.write("\n")
else:
print(" [seed] 种子目录不可写(容器镜像层),跳过示例回写:%s" % example_path)
print(" [seed] users.json 已生成 %s(admin + alice)" % out)
PYEOF
fi
echo " [seed] 数据目录就绪:$DATA_DIR"