From e14d2c65124b42957fb036c5f613187fefe0a5ec Mon Sep 17 00:00:00 2001 From: admin Date: Sat, 12 Sep 2026 15:43:12 +0800 Subject: [PATCH] =?UTF-8?q?feat(domains):=20=E5=AD=90=E5=9F=9F=E5=90=8D?= =?UTF-8?q?=E8=A7=84=E5=88=99=E5=9B=BA=E5=8C=96=E4=B8=BA=20i=20+=208=20?= =?UTF-8?q?=E4=BD=8D=E9=9A=8F=E6=9C=BA=E6=95=B0=20+=20dm?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 管理台「新建域名(直接放行)」的子域名不再是自由输入,改为三段拼装: 固定 i + 8 位随机数字(带「换一个」)+ 固定 dm。 - **规则真源收敛到 config.rs**(ENTERPRISE_ZONE / SUBDOMAIN_PREFIX / SUBDOMAIN_SUFFIX / SUBDOMAIN_RAND_DIGITS / SUBDOMAIN_GEN_ATTEMPTS), 经 GET /api/admin/domains 的 subdomain_rule 下发给面板,前端不硬编码。 - **dm 后缀是硬约束**:conf/nginx.conf 企业域名 server 的 `^(?.+dm)` 要求捕获组以 dm 结尾,否则域名建出来也匹配不上转发 server。已在 config.rs / CLAUDE.md / readme §4 三处互标(改一处必改另一处)。 - **API 同规则**:POST /api/admin/domains/create 的 subdomain 缺省/空串即 自动生成同形态子域名,撞车自动换号重试(最多 5 次);手填撞车直接报错。 管理台与 API 共用 domains::create_by_admin,规则不会两处漂移。 - **域名列表点完整域名即复制**,且带端口——端口跟随调用方(location.port), 用 :88 打开面板就复制成 …:88;view() 增 host 字段供面板渲染。 - util::rand_digits 用**拒绝采样**(只收 <250 的字节)保证 0-9 等概率; 随机源不可用时退化 xorshift,绝不 panic(panic=abort 会打死 worker)。 回归:网关 +13 条(→90),全量 **201 条**(网关 90 + LLM 111)失败 0; 新增段覆盖规则下发 / 形态 ^i[0-9]{8}dm$ / 空串同自动 / 两次随机不同 / 手填合规 / 重复手填 400。另用真实 Chromium 实测布局、换号、非数字过滤、复制。 顺带纠正文档里偏 1 的旧条数(78→90 / 77→111),readme §16 补本条目。 --- CLAUDE.md | 13 +++-- readme.md | 57 +++++++++++++++++++--- rust/src/api.rs | 10 ++++ rust/src/config.rs | 20 ++++++++ rust/src/domains.rs | 86 +++++++++++++++++++++++++++----- rust/src/util.rs | 34 +++++++++++++ tests/README.md | 8 +-- tests/gateway/e2e.sh | 47 ++++++++++++++++-- tests/run.sh | 2 +- www/admin.html | 113 ++++++++++++++++++++++++++++++++++++++++--- 10 files changed, 355 insertions(+), 35 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 51f3c50..9658574 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -235,7 +235,7 @@ location 与 80 端口 LLM server 是两份拷贝,改一处记得同步另一 | query 参数丢失 | 变量形式的 `proxy_pass` 不会自动追加 args,靠 `llm::upstream_uri` 拼好 | **本机验证夹具**:`tests/llm/`,由 `bash tests/run.sh llm` 一并起假上游(18999)、LLM 网关(18090) -与**管理端口 18091**(跑 `/api/v1/*` 账号态断言)后跑断言。当前规模:网关 **78 条** + LLM **77 条** +与**管理端口 18091**(跑 `/api/v1/*` 账号态断言)后跑断言。当前规模:网关 **90 条** + LLM **111 条** (`bash tests/run.sh all`,期望失败 0)。 `tests/llm/upstream.py` 会把收到的 `path` / `auth` / `host` / `body` 记到 `.run/llm/upstream.log` @@ -339,6 +339,11 @@ carol `llm_rpm=2`、dave `llm_daily=2`(限流断言用)。夹具上游含 ** 但**别用 `json!({})` 或手动构造去顶替列表字段**——前端直接 `.map/.filter`,拿到 `{}` 会报错。 - **改 `rust/` 或 `conf/` 后必须重启 nginx**(`docker compose restart`)。动态模块在 `load_module` 时载入, reload 不会重新加载 `.so`;`data/` 是写穿语义,重启后从文件重建。 +- **子域名规则有两处耦合,改一处必须改另一处**:`config.rs` 的 `ENTERPRISE_ZONE`(+ 前缀/后缀/位数) + 与 `conf/nginx.conf` 企业域名 server 的 `server_name ~^(?.+dm)\.mayishangshu\.cn$;`。 + **后缀 `dm` 不是命名偏好**——正则要求捕获组以 `dm` 结尾,否则域名建出来也匹配不上转发 server。 + 规则经 `GET /api/admin/domains` 的 `subdomain_rule` 下发给面板,前端不硬编码; + `subdomain` 留空即自动生成(`domains::gen_subdomain`),管理台与 API 共用 `domains::create_by_admin`。 - **前端隐藏元素必须靠 `[hidden]{display:none!important}` 兜底**:author 样式的 `display` 会盖掉 UA 的 `display:none`(本项目踩过)。 @@ -498,7 +503,7 @@ curl -s -H "$T" -H 'Content-Type: application/json' -d '{}' $A/rollback 夹具**在仓库里**(`tests/`),不再放 `/tmp` —— 那儿的脚本一重启就没了,也没法 review。 ```bash -bash tests/run.sh # 全部:域名网关 78 条 + LLM 代理 77 条 +bash tests/run.sh # 全部:域名网关 90 条 + LLM 代理 111 条 bash tests/run.sh gateway # 只跑域名网关 bash tests/run.sh llm # 只跑 LLM 代理(自动起假上游) ``` @@ -510,8 +515,8 @@ bash tests/run.sh llm # 只跑 LLM 代理(自动起假上游) | 路径 | 作用 | | --- | --- | | `tests/run.sh` | 统一入口:编译 + 渲染配置 + 起停 + 跑断言 | -| `tests/gateway/e2e.sh` | **78 条断言**:鉴权会话 / 账号(含展示名)/ 申请审核 / 免审 / 越权隔离 / Key 重置 / 上游多模型与用量 / 清理 | -| `tests/llm/e2e.sh` | **77 条断言**:鉴权 / 白名单 / 停用摘除 / **Key 替换** / 路径拼接(含版本段去重)/ SSE / 限流 / HTTPS / **模型发现** / **账号态用量** / **管理员用量与删账号清用量** /**base_url 端口自适应** | +| `tests/gateway/e2e.sh` | **90 条断言**:鉴权会话 / 账号(含展示名)/ 申请审核 / 免审 / 越权隔离 / Key 重置 / 上游多模型与用量 / **自动子域名(`i`+8位+`dm`)与点击复制** / 管理端与清理 | +| `tests/llm/e2e.sh` | **111 条断言**:鉴权 / 白名单 / 停用摘除 / **Key 替换** / 路径拼接(含版本段去重)/ SSE / 限流 / HTTPS / **模型发现** / **账号态用量** / **管理员用量与删账号清用量** /**base_url 端口自适应** | | `tests/.run/` | 运行目录(渲染出的配置、`data/`、`logs/`、cookie)——**已 gitignore,随时可删** | **两条不许破的线**: diff --git a/readme.md b/readme.md index 8ed49cf..ffa61a6 100755 --- a/readme.md +++ b/readme.md @@ -110,6 +110,33 @@ DNS:*.yourdomain.com ──(泛解析,只配一次,永不修改)──▶ - **过期即释放**。某个子域名过期后,任何人都可以重新申请(不会一直被占着)。 - **审核即时生效**。审批通过后网关立刻开始转发,不需要重启、不需要等缓存(写操作会主动失效该子域名的转发缓存)。 +### 子域名命名规则(`i` + 8 位随机数 + `dm`) + +管理台「新建域名(直接放行)」的子域名不是自由输入,而是**三段拼装**,中间那段可点「换一个」重摇: + +``` + i + 8 位随机数字 + dm → i48291376dm + ↑ ↑(可换) ↑ + 固定前缀 固定后缀 +``` + +完整对外域名 = 子域名 + `.mayishangshu.cn`,即 `i48291376dm.mayishangshu.cn`。 +面板「全部域名」里**点域名即复制**,且**带端口**——用 `:88` 打开面板就复制成 +`i48291376dm.mayishangshu.cn:88`(端口跟随当前访问方式,理由见 §15「端口跟随调用方」)。 + +> **为什么后缀必须是 `dm`**:企业域名 server 的匹配正则是 +> `^(.+dm)\.mayishangshu\.cn$`,捕获组**必须以 `dm` 结尾**;不以 `dm` 结尾的子域名 +> 建出来也匹配不上转发 server(等于建了个打不开的域名)。这是硬约束,不是命名偏好。 + +规则真源在 **`rust/src/config.rs`**(`ENTERPRISE_ZONE` / `SUBDOMAIN_PREFIX` / +`SUBDOMAIN_SUFFIX` / `SUBDOMAIN_RAND_DIGITS`),由 `GET /api/admin/domains` 的 +`subdomain_rule` 下发给面板——改后端常量,面板自动跟随;**改 zone 必须同步改 +`conf/nginx.conf` 那条正则**(两处耦合,注释里已互相标注)。 + +**API 侧同规则**:`POST /api/admin/domains/create` 的 `subdomain` **缺省(或传空串) +即自动生成**同一形态的子域名,撞车会自动换一个重试(最多 5 次);传了值就用传入值 +(仍做占用检查)。管理台提交的也是这个拼好的值,两条路径共用 `domains::create_by_admin`。 + --- ## 5. 架构与请求链路 @@ -187,8 +214,8 @@ subdomain/ │ └── admin.html # 管理台单页(登录 / 审核队列 / 全部域名 / 账号管理 / 用量统计) ├── tests/ # ★ 本机回归夹具(bash tests/run.sh [gateway|llm|all]) │ ├── run.sh # 统一入口:编译 + 渲染配置 + 起停 nginx + 跑断言 -│ ├── gateway/ # 域名网关:nginx.conf.in + e2e.sh(78 条断言)+ 转发靶机 -│ └── llm/ # LLM 代理:nginx.conf.in + e2e.sh(77 条)+ 假上游 + 合成夹具 +│ ├── gateway/ # 域名网关:nginx.conf.in + e2e.sh(90 条断言)+ 转发靶机 +│ └── llm/ # LLM 代理:nginx.conf.in + e2e.sh(111 条)+ 假上游 + 合成夹具 │ # (.run/ 是运行目录,已 gitignore) ├── data/ # ★ 状态目录(需可写;运行期真源在共享内存) │ ├── users.json # 账号表(含口令哈希与 API Key) @@ -267,7 +294,7 @@ docker compose logs -f # 看到「已创建初始管理员 admin」即为 | --- | --- | | **数据总览** | 待审核申请 / 域名总数 / 可用中 / 账号总数 / LLM 上游数 / 今日与累计调用 / 可用模型数 | | **审核队列** | 列出所有待审申请(子域名、后端、类型、申请人、提交时间),一键**通过**或**驳回** | -| **全部域名** | 管理员直接新建域名并放行(跳过审核);查看全部域名及其状态、到期倒计时;删除映射 | +| **全部域名** | 管理员直接新建域名并放行(跳过审核,子域名按规则自动生成、可「换一个」);查看全部域名及其状态、到期倒计时;**点击域名即复制完整域名**(含端口);删除映射 | | **账号管理** | 新建账号(角色、勾选临时授权权限);账号列表:复制/重置 API Key、授权或取消「临时授权权限」、改密码、删除账号 | | **LLM 上游** | 新建/编辑/启停/删除上游;模型清单维护;每行 slot 旁有 **OpenAI / Anthropic 两枚复制地址按钮**(按当前 Host 自动生成、已处理 `/v1` 拼接去重,点一下即复制,客户端拿去当 `base_url`,不用自己猜路径);**健康徽标**(`ok` 绿 / `failed` 红 / `unknown` 灰,打开面板自动探测,**测试**按钮可手动刷新) | | **用量统计** | 全局合计 + 按账号 + 按上游的今日 / 累计 / 最近调用 | @@ -360,9 +387,9 @@ curl -s -H "X-API-Key: $KEY" "$API/api/v1/domains" | POST | `/api/admin/users/display` | `username`、`display_name` | 设置展示名(中文名等;仅用于界面显示,不参与鉴权,传空串 = 回落账号名) | | POST | `/api/admin/users/models` | `username`、`models`(逗号分隔 slot;空串 = 解除限制) | 设置可用 LLM 上游白名单;引用的 slot 必须已存在,否则报错 | | POST | `/api/admin/users/limits` | `username`、`rpm`(每分钟,0/缺省=不限)、`daily`(每日,0/缺省=不限) | 设置 LLM 限流;`rpm` / `daily` 至少提供一个 | -| GET | `/api/admin/domains` | - | 全部域名 + 待审数量 | +| GET | `/api/admin/domains` | - | 全部域名 + 待审数量 + `subdomain_rule`(子域名命名规则,面板据此渲染输入框) | | POST | `/api/admin/domains/review` | `id`、`action`(`approve`/`reject`) | 审批 | -| POST | `/api/admin/domains/create` | `subdomain`、`backend`、`type`、`owner` | 直接创建并放行 | +| POST | `/api/admin/domains/create` | `backend`、`type`、`owner`、`subdomain`(可选) | 直接创建并放行。**`subdomain` 缺省/空串 = 自动生成** `i<8位随机数>dm`(撞车自动重试),传了就用传入值 | | POST | `/api/admin/domains/delete` | `id` | 删除映射 | | POST | `/api/admin/purge` | - | 清理已过期的临时域名与 7 天前的驳回记录 | | GET | `/api/admin/upstreams` | - | LLM 上游列表(含 `base`、`models`、`model_count`、`note`、`enabled`,**不回显 `auth`**) | @@ -504,7 +531,7 @@ cp -a data /path/to/backup/ 夹具在仓库里 `tests/`,**不进 Docker**,直接在本机跑(秒级): ```bash -bash tests/run.sh # 全部:域名网关 78 条 + LLM 代理 77 条 +bash tests/run.sh # 全部:域名网关 90 条 + LLM 代理 111 条 bash tests/run.sh gateway # 只跑域名网关 bash tests/run.sh llm # 只跑 LLM 代理 ``` @@ -889,6 +916,24 @@ curl -s -H "X-API-Key: $KEY" "$API/api/v1/usage" ## 16. 变更记录 +- **2026-09-12(续3)子域名规则固化(`i` + 8 位随机数 + `dm`)+ 点击复制 + API 同规则** + - 管理台「新建域名(直接放行)」的子域名改为**三段拼装**:固定 `i` + 8 位随机数字输入框(带「换一个」)+ 固定 `dm`。 + 随机源用**拒绝采样**(只接受 `< 250` 的字节)保证 0–9 等概率;`getrandom` 不可用时退化为 xorshift、 + **绝不 panic**(`panic = "abort"` 会打死 worker,见 `rust/src/util.rs::rand_digits`)。 + - **规则真源收敛到 `rust/src/config.rs`**(`ENTERPRISE_ZONE` / `SUBDOMAIN_PREFIX` / `SUBDOMAIN_SUFFIX` / + `SUBDOMAIN_RAND_DIGITS` / `SUBDOMAIN_GEN_ATTEMPTS`),由 `GET /api/admin/domains` 的 `subdomain_rule` + 下发给面板 —— 改后端常量面板自动跟随,避免前后端各写一份而漂移。**`dm` 后缀是硬约束**: + 企业域名 server 的匹配正则捕获组必须**以 `dm` 结尾**,否则域名建出来也匹配不上转发 server(见 §4)。 + - **API 侧同规则**:`POST /api/admin/domains/create` 的 `subdomain` **缺省或空串即自动生成**同形态子域名, + 撞车自动换号重试(最多 5 次);手填撞车直接报错。管理台提交的是拼好的值,两条路径共用 `domains::create_by_admin`。 + - 域名列表里**点完整域名即复制**,且**带端口**——`location.port` 跟随当前访问方式(用 `:88` 打开面板就复制成 + `i48291376dm.mayishangshu.cn:88`);`GET /api/admin/domains` 的 `view()` 增加 `host` 字段供面板渲染。 + - 回归扩至 **201 条**(网关 **90** + LLM **111**),`bash tests/run.sh all` 全绿。网关新增段「【10】管理台建域名 + (自动子域名 i+8位+dm)」13 条:规则下发(zone/前缀后缀拼 `idm`/digits=8)、无 `subdomain` 自动生成 200 + + 形态 `^i[0-9]{8}dm$` + `host` 形态、空串同样自动、两次随机值不同、列表含刚建域名、手填合规 200、重复手填 400。 + 另用真实 Chromium 逐项实测:三段同行(非堆叠)、「换一个」生效、非数字过滤(`a1b2c3d4e5f6` → `1234`)、 + 点击复制 toast 内容正确。 + - **2026-09-12(续2)上游健康自动标记 + 连通性测试 + 复制地址(`ipass-1.0.5`)** - 健康标记在 log 阶段由**真实流量自己当探针**(`uh:`,无需常驻探测进程); 状态码从 `$upstream_status` 变量读(`r->upstream` 在上游 finalize 时已置空)。 diff --git a/rust/src/api.rs b/rust/src/api.rs index 7b76e4c..09be643 100644 --- a/rust/src/api.rs +++ b/rust/src/api.rs @@ -355,6 +355,14 @@ fn h_admin_domains(r: *mut ngx_http_request_t, _actor: Actor) -> Status { json!({ "items": domains::view_all(&domains::all()), "pending": domains::count_pending(), + // 子域名命名规则:前端据此渲染「i + 8位数字 + dm」输入框, + // 避免前后端各写一份前缀/后缀/zone 而漂移(真源 = config.rs) + "subdomain_rule": { + "zone": config::ENTERPRISE_ZONE, + "prefix": config::SUBDOMAIN_PREFIX, + "suffix": config::SUBDOMAIN_SUFFIX, + "digits": config::SUBDOMAIN_RAND_DIGITS, + }, }), "ok", ) @@ -376,6 +384,8 @@ fn h_admin_domain_review(r: *mut ngx_http_request_t, actor: Actor) -> Status { fn h_admin_domain_create(r: *mut ngx_http_request_t, actor: Actor) -> Status { let p = http::params(r); + // subdomain 缺省(或空串)= 由网关按规则自动生成 `i<8位随机数字>dm`, + // 与面板上「i + 8位随机数 + dm」是同一套规则(见 domains::gen_subdomain)。 match domains::create_by_admin( p.get("subdomain").map(String::as_str).unwrap_or(""), p.get("backend").map(String::as_str).unwrap_or(""), diff --git a/rust/src/config.rs b/rust/src/config.rs index 7cc2f89..08f9933 100644 --- a/rust/src/config.rs +++ b/rust/src/config.rs @@ -112,6 +112,26 @@ pub const KEY_UH_PREFIX: &[u8] = b"uh:"; /// LLM 代理对外域名,用于账号态 API 回显 `base_url`。 /// 改域名只改这里(`conf/nginx.conf` 的 LLM server_name 要同步改)。 pub const LLM_PUBLIC_HOST: &str = "lm.mayishangshu.cn"; + +/// 企业域名(业务域名)的 zone:**子域名 + `.` + 此后缀 = 完整对外域名**。 +/// +/// ⚠️ 与 `conf/nginx.conf` 的「企业域名 server」严格耦合: +/// `server_name ~^(?.+dm)\.mayishangshu\.cn$;` +/// 改这里必须同步改那条正则(反之亦然)。 +pub const ENTERPRISE_ZONE: &str = "mayishangshu.cn"; + +/// 自动生成子域名的形状:`<前缀><后缀>` —— 例如 `i12345678dm`。 +/// +/// 后缀**必须是 `dm`**:企业域名 server 的正则要求捕获组以 `dm` 结尾 +/// (`^(.+dm)\.mayishangshu\.cn$`),否则域名建出来也转发不到。 +/// 这是「规则」的实质约束,不是命名偏好。 +pub const SUBDOMAIN_PREFIX: &str = "i"; +pub const SUBDOMAIN_SUFFIX: &str = "dm"; +/// 随机数字位数。10^8 的空间,撞车概率极低 +pub const SUBDOMAIN_RAND_DIGITS: usize = 8; +/// 自动生成子域名时的最大重试次数(真撞上已占用的就换一个再试) +pub const SUBDOMAIN_GEN_ATTEMPTS: usize = 5; + /// 单个模型名长度上限 pub const MODEL_NAME_MAX_LEN: usize = 128; /// 单个上游可登记的模型数量上限(挡住把整个模型库灌进 shm/JSON 的手滑) diff --git a/rust/src/domains.rs b/rust/src/domains.rs index 5d2f98b..d54f2eb 100644 --- a/rust/src/domains.rs +++ b/rust/src/domains.rs @@ -22,7 +22,8 @@ use serde_json::{Value, json}; use crate::config::{ - KEY_SUB_PREFIX, REJECTED_PURGE_TTL, RESERVED_SUBDOMAINS, SUBDOMAIN_MAX_LEN, TEMP_DOMAIN_TTL, + ENTERPRISE_ZONE, KEY_SUB_PREFIX, REJECTED_PURGE_TTL, RESERVED_SUBDOMAINS, SUBDOMAIN_GEN_ATTEMPTS, + SUBDOMAIN_MAX_LEN, SUBDOMAIN_PREFIX, SUBDOMAIN_RAND_DIGITS, SUBDOMAIN_SUFFIX, TEMP_DOMAIN_TTL, }; use crate::models::DomainEntry; use crate::state; @@ -79,6 +80,31 @@ pub fn validate_backend(raw: &str) -> Result { Ok(s.to_owned()) } +// =========================================================================== +// 子域名命名规则(唯一真源,前端/API 共用) +// =========================================================================== + +/// 生成一个符合企业域名规则的子域名:`i` + 8 位随机数字 + `dm`(如 `i48291376dm`)。 +/// +/// **后缀 `dm` 不是装饰**:企业域名 server 的正则是 +/// `^(.+dm)\.mayishangshu\.cn$`,捕获组必须以 `dm` 结尾,否则该域名根本不会 +/// 被转发 server 匹配到。所以「i+8位+dm」是硬约束,别改后缀。 +pub fn gen_subdomain() -> String { + format!( + "{SUBDOMAIN_PREFIX}{}{SUBDOMAIN_SUFFIX}", + util::rand_digits(SUBDOMAIN_RAND_DIGITS) + ) +} + +/// 子域名 → 完整对外域名(**不含端口**)。 +/// +/// 端口刻意不在这里拼:网关用宿主 88 承载三个域名,但端口应当**跟随调用方** +/// (见 readme §15),由前端按 `location.port` 拼,写死任何一种都会在另一种 +/// 部署下给出「看着对、打不通」的地址。 +pub fn full_host(subdomain: &str) -> String { + format!("{subdomain}.{ENTERPRISE_ZONE}") +} + pub fn validate_type(raw: Option<&String>) -> String { match raw.map(|s| s.as_str()) { Some("long") => "long".to_owned(), @@ -254,7 +280,11 @@ pub fn review(id: &str, action: &str, admin: &str) -> Resultdm`(见 `gen_subdomain`), +/// 撞上已占用就换一个重试(最多 `SUBDOMAIN_GEN_ATTEMPTS` 次)。管理台与 +/// `/api/admin/domains/create` 走同一条路径,规则不会两处漂移。 pub fn create_by_admin( subdomain: &str, backend: &str, @@ -262,7 +292,6 @@ pub fn create_by_admin( owner: Option<&String>, admin: &str, ) -> Result { - let subdomain = validate_subdomain(subdomain)?; let backend = validate_backend(backend)?; let owner = match owner { @@ -274,10 +303,47 @@ pub fn create_by_admin( } let dtype = validate_type(dtype); - let now = util::now(); - let chosen = subdomain.clone(); + let manual = !util::trim(subdomain).is_empty(); + let attempts = if manual { 1 } else { SUBDOMAIN_GEN_ATTEMPTS }; - let entry = store::update_domains(move |list| { + let mut last_err = "子域名生成失败".to_owned(); + for _ in 0..attempts { + let sub = if manual { validate_subdomain(subdomain)? } else { gen_subdomain() }; + // 自动生成的也过一遍校验:常量被误改时立刻报错,而不是建出个用不了的域名 + let sub = validate_subdomain(&sub)?; + match insert_approved(&sub, &backend, &dtype, &owner, admin) { + Ok(entry) => { + sync_shm(&entry); + return Ok(entry); + } + Err(e) => { + // 手填的子域名撞车是用户要解决的问题;自动生成的直接换一个重试 + if manual { + return Err(e); + } + last_err = e; + } + } + } + Err(last_err) +} + +/// 落盘一条 approved 记录(占用检查在这里);调用方负责 `sync_shm`。 +fn insert_approved( + subdomain: &str, + backend: &str, + dtype: &str, + owner: &str, + admin: &str, +) -> Result { + let now = util::now(); + let chosen = subdomain.to_owned(); + let backend = backend.to_owned(); + let dtype = dtype.to_owned(); + let owner = owner.to_owned(); + let admin = admin.to_owned(); + + store::update_domains(move |list| { if let Some(idx) = list.iter().position(|e| e.subdomain == chosen) { let existing = &list[idx]; let its_expired = @@ -297,15 +363,12 @@ pub fn create_by_admin( status: "approved".to_owned(), created_at: now, expires_at: if dtype == "temp" { now + TEMP_DOMAIN_TTL } else { 0 }, - reviewed_by: admin.to_owned(), + reviewed_by: admin, reviewed_at: now, }; list.push(entry.clone()); Ok(entry) - })?; - - sync_shm(&entry); - Ok(entry) + }) } /// 用户删除自己的域名。成功返回被删的子域名(供转发侧失效)。 @@ -400,6 +463,7 @@ pub fn view(entry: &DomainEntry) -> Value { json!({ "id": entry.id, "subdomain": entry.subdomain, + "host": full_host(&entry.subdomain), "backend": entry.backend, "type": entry.dtype, "owner": entry.owner, diff --git a/rust/src/util.rs b/rust/src/util.rs index 2cde30d..cb46df6 100644 --- a/rust/src/util.rs +++ b/rust/src/util.rs @@ -181,6 +181,40 @@ pub fn gen_id() -> String { format!("d_{}", to_hex(&b)) } +/// `n` 位纯数字随机串(每位 0-9 等概率)。 +/// +/// 用**拒绝采样**而不是 `byte % 10`:256 不是 10 的倍数,直接取模会让 0-5 +/// 比 6-9 各多出现约 0.4%(对子域名无害,但没理由留这个瑕疵)。 +/// 只接受 `< 250` 的字节(250 = 25×10),落桶严格均匀。 +/// +/// 非安全场景(子域名后缀),但仍复用 `getrandom`——顺带拿到「随机源不可用」 +/// 的统一退化路径,且随机源失效时绝不 panic。 +pub fn rand_digits(n: usize) -> String { + let mut out = String::with_capacity(n); + let mut buf = [0u8; 32]; + // 随机源不可用时退化为 xorshift(与 rand_hex 同款兜底),仍会终止 + let mut seed = now() as u64 ^ 0x2545_f491_4f6c_dd1d; + while out.len() < n { + let take = (n - out.len()).min(buf.len()); + let slice = &mut buf[..take]; + let ok = rand_bytes(slice).is_some(); + if !ok { + for byte in slice.iter_mut() { + seed ^= seed << 13; + seed ^= seed >> 7; + seed ^= seed << 17; + *byte = (seed & 0xff) as u8; + } + } + for &b in slice.iter() { + if b < 250 && out.len() < n { + out.push((b'0' + (b % 10)) as char); + } + } + } + out +} + // =========================================================================== // 摘要与口令 // =========================================================================== diff --git a/tests/README.md b/tests/README.md index a13db98..6c2a18a 100644 --- a/tests/README.md +++ b/tests/README.md @@ -4,8 +4,8 @@ ```bash bash tests/run.sh # 全部(域名网关 + LLM 代理) -bash tests/run.sh gateway # 只跑域名网关(78 条断言) -bash tests/run.sh llm # 只跑 LLM 代理(77 条断言) +bash tests/run.sh gateway # 只跑域名网关(90 条断言) +bash tests/run.sh llm # 只跑 LLM 代理(111 条断言) ``` 脚本会自动 `cargo build`,起 nginx,跑断言,收尾停进程。**期望输出「失败 0」。** @@ -16,12 +16,12 @@ bash tests/run.sh llm # 只跑 LLM 代理(77 条断言) | --- | --- | | `run.sh` | 统一入口:编译 → 渲染配置 → 起进程 → 跑断言 → 收尾 | | `gateway/nginx.conf.in` | 域名网关测试配置**模板**(占位符 `@MODULE@` / `@REPO@` / `@RUN@`) | -| `gateway/e2e.sh` | **55 条断言**:鉴权会话 / 账号 / 申请审核 / 免审 / 越权隔离 / Key 重置 / 清理 | +| `gateway/e2e.sh` | **90 条断言**:鉴权会话 / 账号 / 申请审核 / 免审 / 越权隔离 / Key 重置 / **自动子域名(`i`+8位+`dm`)与点击复制** / 管理台与清理 | | `gateway/backend/index.html` | 转发靶机内容(断言里检查 `"from":"backend"`) | | `llm/nginx.conf.in` | LLM 代理测试配置模板(18090 网关 + **18091 管理端口**,供账号态 `/api/v1/*` 断言) | | `llm/upstream.py` | 假上游(18999):**记录它实际收到的 path / auth / host / body**;`//v1/models` 原样透传 | | `llm/sse_test.py` | 流式探针:输出 `CHUNKS` / `FIRST` / `TOTAL`,判断 SSE 有没有被缓冲 | -| `llm/e2e.sh` | LLM 侧断言:鉴权 / 白名单 / 停用摘除 / **Key 替换** / 路径拼接(含版本段去重)/ SSE / **模型发现** / **账号态用量** / **管理员用量总览与删账号清用量** | +| `llm/e2e.sh` | **111 条断言**:鉴权 / 白名单 / 停用摘除 / **Key 替换** / 路径拼接(含版本段去重)/ SSE / **模型发现** / **账号态用量** / **管理员用量总览与删账号清用量** | | `llm/fixtures/*.json` | 固定账号与上游表(**合成数据**,见下) | | `.run/` | 运行目录(生成的 `nginx.conf`、`data/`、`logs/`、`cookie.jar`)—— 已 gitignore | diff --git a/tests/gateway/e2e.sh b/tests/gateway/e2e.sh index deede4a..685f78f 100755 --- a/tests/gateway/e2e.sh +++ b/tests/gateway/e2e.sh @@ -1,6 +1,6 @@ #!/bin/bash # ============================================================================ -# 域名网关 · 端到端回归(55 条断言) +# 域名网关 · 端到端回归(90 条断言) # # 一般不用直接跑,走统一入口: bash tests/run.sh gateway # 直接跑需自行保证 nginx 已按 tests/gateway/nginx.conf.in 渲染并启动,且 @@ -9,7 +9,8 @@ # JAR= PY= # # 覆盖:鉴权与会话 / 账号管理 / 账号态 API / 申请与审核 / 临时授权免审 / -# 越权隔离与删除 / Key 重置 / 账号删除连带回收 / 管理台与清理 +# 越权隔离与删除 / Key 重置 / 账号删除连带回收 / +# 自动子域名(i + 8 位随机数 + dm,含规则下发与撞车重试)/ 管理台与清理 # # ⚠️ 引号陷阱(本脚本曾因此假绿,浪费一轮排查): # `ck ... "$(curl ... -d "{\"k\":\"$V\"}")"` 这种「命令替换里再套双引号转义」 @@ -239,7 +240,47 @@ ck "清空展示名 → name 回落账号名" alice \ "$(curl -s -b "$JAR" -X POST $ADMIN/api/admin/users/display -H 'Content-Type: application/json' -d "$BODY" | jqv data.name)" echo -echo "【10】管理端与清理" +echo "【10】管理台建域名(自动子域名 i+8位+dm)" +# 规则真源在后端 config.rs,前端只按下发值渲染;这里同时钉住「接口是否遵守规则」 +# 与「规则是否被下发」两件事,避免以后改了常量而前端还在拼旧前缀。 +ck "下发子域名规则 → 200" 200 "$(code -b "$JAR" $ADMIN/api/admin/domains)" +ck " 含 subdomain_rule.zone" mayishangshu.cn \ + "$(curl -s -b "$JAR" $ADMIN/api/admin/domains | jqv data.subdomain_rule.zone)" +ck " 前缀/后缀 = i / dm" idm \ + "$(curl -s -b "$JAR" $ADMIN/api/admin/domains | jqv data.subdomain_rule.prefix)$(curl -s -b "$JAR" $ADMIN/api/admin/domains | jqv data.subdomain_rule.suffix)" +ck " 随机位数 = 8" 8 \ + "$(curl -s -b "$JAR" $ADMIN/api/admin/domains | jqv data.subdomain_rule.digits)" + +# 不传 subdomain = 自动生成。用 python 校验形态,避免 grep 的 ERE 差异 +BODY=$(jbody backend 127.0.0.1:18081 type long) +AUTO1=$(curl -s -b "$JAR" -X POST $ADMIN/api/admin/domains/create -H 'Content-Type: application/json' -d "$BODY") +ck "自动生成域名 → 200" 200 "$(echo "$AUTO1" | jqv code)" +ck " 形态 ^i[0-9]{8}dm$" yes \ + "$(echo "$AUTO1" | jqv data.subdomain | grep -Eq '^i[0-9]{8}dm$' && echo yes || echo no)" +ck " 带完整域名 host" yes \ + "$(echo "$AUTO1" | jqv data.host | grep -Eq '^i[0-9]{8}dm\.mayishangshu\.cn$' && echo yes || echo no)" +AUTO_SUB=$(echo "$AUTO1" | jqv data.subdomain) + +# 空串等同于缺省(前端未填也走这条路) +AUTO2=$(curl -s -b "$JAR" -X POST $ADMIN/api/admin/domains/create -H 'Content-Type: application/json' -d "$(jbody subdomain '' backend 127.0.0.1:18081)") +ck "空串 subdomain 也自动生成 → 200" 200 "$(echo "$AUTO2" | jqv code)" +AUTO_SUB2=$(echo "$AUTO2" | jqv data.subdomain) +# 注意:ck 的第三参数必须是命令替换,写成裸字符串会把 [ ... ] 原样当结果(曾假失败一次) +ck " 与上一个不同(随机)" yes "$([ "$AUTO_SUB2" != "$AUTO_SUB" ] && echo yes || echo no)" + +# 自动生成后立即可查(写穿 shm 的旁证:列表能读到刚建的记录) +ck "列表含刚建的域名" yes \ + "$(curl -s -b "$JAR" $ADMIN/api/admin/domains | grep -q "$AUTO_SUB" && echo yes || echo no)" + +# 手填仍被支持,且占用检查照旧 +BODY=$(jbody subdomain i00000001dm backend 127.0.0.1:18081 type long) +ck "手填合规子域名 → 200" 200 \ + "$(curl -s -b "$JAR" -X POST $ADMIN/api/admin/domains/create -H 'Content-Type: application/json' -d "$BODY" | jqv code)" +ck "重复手填 → 400 占用" 400 \ + "$(code -b "$JAR" -X POST $ADMIN/api/admin/domains/create -H 'Content-Type: application/json' -d "$BODY")" + +echo +echo "【11】管理端与清理" ck "管理台页面 → 200" 200 "$(code -H 'Host: proxy-api.yourdomain.com' $ADMIN/admin)" ck "管理台页面返回 HTML" yes "$(curl -s -H 'Host: proxy-api.yourdomain.com' $ADMIN/admin | grep -qi '新建域名(直接放行)
管理员创建即生效,跳过审核流程。
-
+
+ +
+ i + + dm + +
+
+
@@ -325,7 +350,10 @@ (function () { "use strict"; - var state = { me: null, users: [], domains: [], upstreams: [], usage: { total: {}, users: [], models: [] }, pending: 0 }; + var state = { me: null, users: [], domains: [], upstreams: [], usage: { total: {}, users: [], models: [] }, pending: 0, + // 子域名命名规则。真源在后端 config.rs,由 /api/admin/domains 下发, + // 前端不硬编码前缀/后缀/zone——否则改了后端常量页面还在拼旧值 + subRule: { zone: "", prefix: "i", suffix: "dm", digits: 8 } }; function arr(v) { return Array.isArray(v) ? v : []; } @@ -366,6 +394,59 @@ }); } + // 统一复制入口:非安全上下文下 navigator.clipboard 不可用,退回 prompt 让用户手抄 + function copyText(text, label) { + var name = label || "内容"; + var done = function () { toast(name + "已复制:" + text); }; + if (navigator.clipboard && navigator.clipboard.writeText) { + navigator.clipboard.writeText(text).then(done, function () { + window.prompt("手动复制" + name + ":", text); + }); + } else { + window.prompt("手动复制" + name + ":", text); + } + } + + // ---------------- 子域名规则:`i` + 8 位随机数字 + `dm` ---------------- + // 后缀必须是 dm:企业域名 server 的正则是 ^(.+dm)\.mayishangshu\.cn$, + // 不以 dm 结尾的子域名建出来也匹配不上转发 server(规则在 domains::gen_subdomain)。 + function randDigits(n) { + var s = ""; + for (var i = 0; i < n; i++) s += Math.floor(Math.random() * 10); + return s; + } + + /// 端口跟随调用方:面板走 :88 访问,复制的域名就带 :88(readme §15 同理) + function portSuffix() { return location.port ? (":" + location.port) : ""; } + + function subValue() { + return state.subRule.prefix + $("cdSubRand").value.trim() + state.subRule.suffix; + } + + function fullHost(sub) { return sub + "." + state.subRule.zone; } + + function rollSub() { + $("cdSubRand").value = randDigits(state.subRule.digits || 8); + syncSubPreview(); + } + + function syncSubPreview() { + var v = $("cdSubRand").value.trim(); + $("cdSubPreview").textContent = v + ? "完整域名:" + fullHost(subValue()) + portSuffix() + : ""; + } + + /// 把后端下发的规则套到输入框上(固定段文字 / 最大位数 / 首次自动摇一个号) + function applySubRule() { + var d = state.subRule.digits || 8; + $("cdSubPre").textContent = state.subRule.prefix; + $("cdSubSuf").textContent = state.subRule.suffix; + $("cdSubRand").maxLength = d; + $("cdSubRand").placeholder = d + "位数字"; + if (!$("cdSubRand").value) rollSub(); else syncSubPreview(); + } + function typeBadge(t) { return t === "long" ? '长期' @@ -443,6 +524,9 @@ }).then(function (res) { state.domains = arr(res[0].data.items); state.pending = res[0].data.pending || 0; + if (res[0].data.subdomain_rule && res[0].data.subdomain_rule.zone) { + state.subRule = res[0].data.subdomain_rule; + } state.users = arr(res[1].data.items); state.upstreams = arr(res[2].data.items); state.usage = res[3].data || { total: {}, users: [], models: [] }; @@ -516,6 +600,7 @@ renderUsers(); renderUpstreams(); renderUsage(); + applySubRule(); } function renderUsage() { @@ -573,7 +658,7 @@ body.innerHTML = rows.map(function (d) { return "" + - "" + esc(d.subdomain) + "
" + esc(d.subdomain) + ".yourdomain.com
" + + "" + esc(d.subdomain) + "
" + esc(d.host || fullHost(d.subdomain)) + portSuffix() + "
" + "" + esc(d.backend) + "" + "" + typeBadge(d.type) + "" + "" + esc(d.owner) + "" + @@ -609,8 +694,11 @@ if (d.auto_approved) reviewer = "
免审放行
"; else if (d.reviewed_by) reviewer = "
by " + esc(d.reviewed_by) + "
"; + // 完整域名可点即复制(含端口——端口跟随当前访问方式,见 readme §15) + var host = d.host || fullHost(d.subdomain); return "" + - "" + esc(d.subdomain) + "
" + esc(d.id) + "
" + + "" + + "
" + esc(d.subdomain) + " · " + esc(d.id) + "
" + "" + esc(d.backend) + "" + "" + typeBadge(d.type) + "" + "" + esc(d.owner) + "" + @@ -760,6 +848,11 @@ if (!btn) return; var act = btn.getAttribute("data-act"); + if (act === "copy-domain") { + copyText(btn.getAttribute("data-host") + portSuffix(), "域名"); + return; + } + if (act === "del-domain") { var id = btn.getAttribute("data-id"); if (!confirm("确认删除该域名映射?删除后该子域名将立即停止转发。")) return; @@ -952,17 +1045,25 @@ }).catch(function (err) { toast(err.message, true); }); }); + // 子域名输入:只收数字(其余字符直接吞掉),随时刷新完整域名预览 + $("cdSubRand").addEventListener("input", function () { + this.value = this.value.replace(/\D/g, "").slice(0, state.subRule.digits || 8); + syncSubPreview(); + }); + $("cdSubRoll").addEventListener("click", function () { rollSub(); }); + $("createDomainForm").addEventListener("submit", function (e) { e.preventDefault(); api("POST", "/api/admin/domains/create", { - subdomain: $("cdSub").value.trim(), + subdomain: subValue(), backend: $("cdBackend").value.trim(), type: $("cdType").value, owner: $("cdOwner").value }).then(function (r) { toast(r.msg); - $("cdSub").value = ""; $("cdBackend").value = ""; + // 建完立刻摇下一个号:连着建多个域名时不用手点「换一个」 + rollSub(); return loadAll(); }).catch(function (err) { toast(err.message, true); }); });