feat(domains): 子域名规则固化为 i + 8 位随机数 + dm

管理台「新建域名(直接放行)」的子域名不再是自由输入,改为三段拼装:
固定 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 的 `^(?<subdomain>.+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 补本条目。
This commit is contained in:
admin committed 2026-09-12 15:43:12 +08:00
1 parent 82ca6a6302
commit e14d2c6512
10 files changed
+355 -35

No files matched your search

+9 -4
View File
@@ -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 ~^(?<subdomain>.+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,随时可删** |
**两条不许破的线**:
+51 -6
View File
@@ -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:<slot>`,无需常驻探测进程);
状态码从 `$upstream_status` 变量读(`r->upstream` 在上游 finalize 时已置空)。
+10
View File
@@ -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(""),
+20
View File
@@ -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 ~^(?<subdomain>.+dm)\.mayishangshu\.cn$;`
/// 改这里必须同步改那条正则(反之亦然)。
pub const ENTERPRISE_ZONE: &str = "mayishangshu.cn";
/// 自动生成子域名的形状:`<前缀><N 位随机数字><后缀>` —— 例如 `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 的手滑)
+75 -11
View File
@@ -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<String, String> {
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) -> Result<DomainEntry, String
Ok(updated)
}
/// 管理员直接创建并放行(等价于「我替你建好并批准」)
/// 管理员直接创建并放行(等价于「我替你建好并批准」)。
///
/// `subdomain` **留空即自动生成** `i<8位随机数字>dm`(见 `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<DomainEntry, String> {
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<DomainEntry, String> {
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,
+34
View File
@@ -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
}
// ===========================================================================
// 摘要与口令
// ===========================================================================
+4 -4
View File
@@ -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**;`/<slot>/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 |
+44 -3
View File
@@ -1,6 +1,6 @@
#!/bin/bash
# ============================================================================
# 域名网关 · 端到端回归(55 条断言)
# 域名网关 · 端到端回归(90 条断言)
#
# 一般不用直接跑,走统一入口: bash tests/run.sh gateway
# 直接跑需自行保证 nginx 已按 tests/gateway/nginx.conf.in 渲染并启动,且
@@ -9,7 +9,8 @@
# JAR=<cookie 文件路径> PY=<python3 路径>
#
# 覆盖:鉴权与会话 / 账号管理 / 账号态 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 '<!DOCTYPE html' && echo yes || echo no)"
ck "purge → 200" 200 "$(code -b "$JAR" -X POST $ADMIN/api/admin/purge)"
+1 -1
View File
@@ -3,7 +3,7 @@
# 本机回归 · 统一入口
#
# bash tests/run.sh # 跑全部(域名网关 + LLM 代理)
# bash tests/run.sh gateway # 只跑域名网关(55 条断言)
# bash tests/run.sh gateway # 只跑域名网关(90 条断言)
# bash tests/run.sh llm # 只跑 LLM 代理
#
# 前置:本机 nginx 已编译好(默认 /Users/xs/Desktop/workspace/iPass/build/ngxbuild/nginx-1.30.4/objs/nginx),
+107 -6
View File
@@ -107,6 +107,22 @@
.b-blue{background:#e6efff;color:#1d4ed8}
.row-actions{display:flex;gap:6px;flex-wrap:wrap}
/* 「i + 8位随机数 + dm」拼装式子域名输入:视觉上是一个整体,
固定段用灰底窄块,中间是可编辑的数字段,右侧跟「换一个」 */
.sub-build{display:flex;align-items:center;gap:0;max-width:340px}
.sub-build .seg{background:#eef2f7;border:1px solid var(--border);color:var(--muted);
font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:13px;
padding:9px 10px;line-height:1.2;user-select:none}
.sub-build .seg:first-child{border-radius:var(--radius) 0 0 var(--radius);border-right:0}
.sub-build .seg:nth-of-type(2){border-radius:0 var(--radius) var(--radius) 0;border-left:0}
.sub-build input{flex:1;min-width:0;border-radius:0;border-left:0;border-right:0;
font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;
letter-spacing:1px;text-align:center}
.sub-build .btn-sm{margin-left:8px;flex:none}
/* 域名可点即复制:看起来像链接,但仍是按钮(键盘可达) */
button.host-copy{background:none;border:0;padding:0;font:inherit;font-weight:600;color:var(--accent);
cursor:pointer;text-align:left;text-decoration:underline dotted;text-underline-offset:3px}
button.host-copy:hover{text-decoration:underline solid}
.key-cell{display:flex;align-items:center;gap:6px}
.muted{color:var(--muted)}
.nowrap{white-space:nowrap}
@@ -203,7 +219,16 @@
<h2 data-page-node-id="lFAUoYK7j5H6bQuHMHvd6h">新建域名(直接放行)</h2>
<div class="desc" data-page-node-id="HzhBXBCdB20XnBH42GrBkJ">管理员创建即生效,跳过审核流程。</div>
<form id="createDomainForm" class="grid-form" data-page-node-id="osoHuJEEqbu7RIv3i0oIzt">
<div data-page-node-id="E4KRl6E3eqQXHO0K6ELPy3"><label for="cdSub" data-page-node-id="2KuUlpjaVxMgddUvW4Rt6m">子域名</label><input id="cdSub" type="text" placeholder="demo" required data-page-node-id="jJcqx6CY7JL0eBrG48jXjR"></div>
<div data-page-node-id="E4KRl6E3eqQXHO0K6ELPy3">
<label for="cdSubRand" data-page-node-id="2KuUlpjaVxMgddUvW4Rt6m">子域名</label>
<div class="sub-build" data-page-node-id="s1aQ7p7Vv2mKq0Nn4ZwLbC">
<span class="seg" id="cdSubPre" data-page-node-id="b7Yx4Hh6k3Uu9Ld2RwQnEa">i</span>
<input id="cdSubRand" type="text" inputmode="numeric" autocomplete="off" spellcheck="false" maxlength="8" placeholder="8位数字" required data-page-node-id="jJcqx6CY7JL0eBrG48jXjR">
<span class="seg" id="cdSubSuf" data-page-node-id="u3Kd8Pz5c1Vv7Bf6TmHsNq">dm</span>
<button type="button" class="btn-sm" id="cdSubRoll" title="重新生成 8 位随机数" data-page-node-id="r9Me2Tw4x6Qq1Jh8LpZvGs">换一个</button>
</div>
<div class="muted mono" id="cdSubPreview" style="font-size:12px;margin-top:5px" data-page-node-id="h5Nt3Cv8j0Ww6Sd4KqXmEr"></div>
</div>
<div data-page-node-id="BiBIz7nwYzxEakNcdcwoGl"><label for="cdBackend" data-page-node-id="6dIQm87yfJIHmdjC3S04gD">后端地址</label><input id="cdBackend" type="text" placeholder="192.168.1.7:89" required data-page-node-id="BuoYZGgFP4BA9HoQ6MbxHF"></div>
<div data-page-node-id="rybpnuVb7EBAKrRXQqUbsN">
<label for="cdType" data-page-node-id="Z2KFqgRTkUpMOKPlKnSgQ8">类型</label>
@@ -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"
? '<span class="badge b-blue">长期</span>'
@@ -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 "<tr>" +
"<td><b>" + esc(d.subdomain) + "</b><div class='muted nowrap'>" + esc(d.subdomain) + ".yourdomain.com</div></td>" +
"<td><b>" + esc(d.subdomain) + "</b><div class='muted nowrap'>" + esc(d.host || fullHost(d.subdomain)) + portSuffix() + "</div></td>" +
"<td class='mono'>" + esc(d.backend) + "</td>" +
"<td>" + typeBadge(d.type) + "</td>" +
"<td>" + esc(d.owner) + "</td>" +
@@ -609,8 +694,11 @@
if (d.auto_approved) reviewer = "<div class='muted'>免审放行</div>";
else if (d.reviewed_by) reviewer = "<div class='muted'>by " + esc(d.reviewed_by) + "</div>";
// 完整域名可点即复制(含端口——端口跟随当前访问方式,见 readme §15)
var host = d.host || fullHost(d.subdomain);
return "<tr>" +
"<td><b>" + esc(d.subdomain) + "</b><div class='muted' style='font-size:12px'>" + esc(d.id) + "</div></td>" +
"<td><button type='button' class='host-copy' data-act='copy-domain' data-host='" + esc(host) + "' title='点击复制完整域名'>" + esc(host) + portSuffix() + "</button>" +
"<div class='muted' style='font-size:12px'>" + esc(d.subdomain) + " · " + esc(d.id) + "</div></td>" +
"<td class='mono'>" + esc(d.backend) + "</td>" +
"<td>" + typeBadge(d.type) + "</td>" +
"<td>" + esc(d.owner) + "</td>" +
@@ -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); });
});