feat(auth): 注册页人机验证 + 邮箱验证码；品牌标识去 DeepSeek（附域名迁移线 序㊿ 补提交）
三条线合并入库 —— 均已完成并上线（源码与生产一致，此前只部署未入仓）。 ⚠️ 其中域名迁移线为**另一会话**产出，本会话只做入库、**未复验其正确性**（它自报零回归）。 【档案 134 · 注册页人机验证 + 邮箱验证码】 - DB 迁移 v10：users.email（唯一索引 LOWER(email)）+ email_codes 事件表（2 索引） - 新增模块 src/web/{register-guard,mail,turnstile,email-code}.ts - routes/auth.ts：新增 GET /api/auth/register/config、POST /api/auth/register/email-code； 注册接口加人机验证与验证码校验；config.ts 新增 12 项配置（默认空 ⇒ 不配 = 老行为） - 邮件走**可插拔驱动**（brevo/http/log），发件人 [email protected]（Brevo 域名已认证 + DKIM + SPF） - 防爆破：三层配额（邮箱 6/h、8/天；IP 20/h；全局 200/h）+ 递增冷却阶梯 （60→60→180→300→900→1800s）+ 试错 5 次作废 + 码只存哈希 + 单次使用 + 与用户名绑定 - Turnstile 服务端校 **success + action + hostname 三项**：sitekey 是公开的， 只校 success 时"拿我们的 sitekey 在自己站点替真人取合法 token 再打我们接口"这条路是通的 - 新增 test/register-guard.test.mjs（19 用例） 【档案 137 · 品牌标识改造 — 去 DeepSeek 图形】 - login/register/admin 页头：删 DeepSeek 鲸鱼图标 + 「DeepSeek」文字图形 → 平台标识（中文「能力枢纽」／英语及其他语言「CapabilityNet」，走 i18n 词条 brand.name） - portal 顶栏换图标（页面名「管理门户」保留） - 新建 web/favicon.svg（平台自有 hub 图标，避开 DeepSeek 蓝）+ 四页 favicon 指向它 - 新增 test/i18n-brand.test.mjs（node:vm 跑真实 i18n.js，六条语言路径断言渲染结果） - scripts/verify-static.mjs 新增 SVG 段：XML 注释不得含 ASCII 双连字符（否则整份 SVG 解析失败、图标静默不显示 —— 实际踩到过） - 🔴 会话页面（实例内官方 dsh 界面）的标识**按用户要求未动**（也受 R2 约束） 【档案 135/136 · 域名迁移线（另一会话产出）】 - 域名收敛为 ai1net.com；旧域 alotbuy.com 降级为 301 过渡装置 - src/net/relay/{addr-override,directory,rendezvous,switcher}.ts 种子与候选链更新； src/web/server.ts、src/worker/relay-tunnel.ts、scripts/verify-cluster-domain.mjs - 档案 136 = 控制面按两台中继取并集（**已立项、未落地**） 验证（本会话两条线）：新增单测 21 条全通过｜全量 221 pass / 0 fail / 1 skipped｜ verify-static 全合格｜其余 10 个 verify 脚本全 OK｜线上实测：Turnstile 假 token 403、 发码 delivered、四页 deepseek 命中 0、favicon 200。
This commit is contained in:
admin committed
1 parent
d2ef362a98
commit
971ccc3703
56 files changed
+3498
-193
No files matched your search
+181
@@ -0,0 +1,181 @@
|
||||
/**
|
||||
* 注册验证码的外发邮件层。
|
||||
*
|
||||
* 为什么做成"驱动 + 通用 HTTP 兜底"而不是直接写死某家 SDK：
|
||||
* ① 平台目前**没有**任何邮件基础设施（全库 grep `smtp|nodemailer|mail` = 0 命中），
|
||||
* 而注册是**唯一**必须先发信才能完成的功能 ⇒ 它是外部依赖最重的一环，必须能换；
|
||||
* ② 换供应商时**只改 env、不动代码**（`http` 驱动连 body 结构都能由配置给出），
|
||||
* 这对"以后可能要接别的邮件服务"是硬需求 —— 不必为了换家再走一次发布；
|
||||
* ③ 不引第三方依赖：`fetch` + JSON 就够，少一个供应链面。
|
||||
*
|
||||
* 驱动：
|
||||
* · `brevo` —— Brevo（原 Sendinblue）事务邮件 API：`POST /v3/smtp/email`，头 `api-key`。
|
||||
* 本机已有可用凭据（见档案），因此作为默认驱动。
|
||||
* · `http` —— **任意** JSON HTTP 接口：URL / 鉴权头 / body 模板全部由 env 给，
|
||||
* body 里可用 `{{to}} {{code}} {{subject}} {{text}} {{from}} {{fromName}}` 占位。
|
||||
* · `log` —— 不真发信，只把验证码交给调用方（由路由写 journald）。**仅供开发/断网排障**，
|
||||
* 显式选它才会生效（不选=不发日志，避免验证码进日志）。
|
||||
*
|
||||
* 纪律：**失败即失败**（返回 `{ok:false}`），不重试 —— 重试会造成"用户点一次收两封"，
|
||||
* 且与 `email_codes` 的事件计数（= 防爆破的判据）对不上。
|
||||
* @module dshs/web/mail
|
||||
*/
|
||||
|
||||
/** 邮件通道的运行时配置（由 `config.ts` 从 env 组装后传入，本模块不读 env）。 */
|
||||
export interface MailSettings {
|
||||
driver: MailDriver
|
||||
/** 服务端点（`brevo` 驱动留空则用官方默认）。 */
|
||||
apiUrl: string
|
||||
apiKey: string
|
||||
/** `http` 驱动的鉴权头名（留空 + 有 apiKey ⇒ 用 `Authorization: Bearer`）。 */
|
||||
authHeader: string
|
||||
/** 发件地址（**必须**是该服务里已验证过的发件人，否则上游直接拒收）。 */
|
||||
from: string
|
||||
fromName: string
|
||||
/** `http` 驱动的 JSON body 模板（支持占位符）。 */
|
||||
bodyTemplate: string
|
||||
timeoutMs: number
|
||||
}
|
||||
|
||||
export type MailDriver = 'brevo' | 'http' | 'log'
|
||||
|
||||
export interface VerificationMail {
|
||||
to: string
|
||||
code: string
|
||||
ttlMinutes: number
|
||||
/** 展示给收件人的站点名（如 `AI1NET`）。**为空则整句退化成"你的验证码"**，绝不回落到平台内部名。 */
|
||||
brand?: string
|
||||
}
|
||||
|
||||
export interface MailResult {
|
||||
ok: boolean
|
||||
/** 失败原因（**不含**验证码本身），供审计与界面提示。 */
|
||||
error: string | null
|
||||
/** 上游返回的状态码（有则记），便于区分"配错了"与"上游抽风"。 */
|
||||
status?: number
|
||||
}
|
||||
|
||||
/** 该驱动是否具备发信条件（缺关键项 ⇒ 视为未配置，路由据此回退/报错）。 */
|
||||
export function mailConfigured(settings: MailSettings): boolean {
|
||||
if (settings.driver === 'log') return true
|
||||
if (settings.from === '') return false
|
||||
if (settings.driver === 'brevo') return settings.apiKey !== '' || settings.apiUrl !== ''
|
||||
return settings.apiUrl !== ''
|
||||
}
|
||||
|
||||
/**
|
||||
* 渲染主题与正文（中英双语：平台默认语言是英语，运营方是中文，两者都照顾到）。
|
||||
* ⚠️ `brand` 为空时**不能**回落到任何内部名（邮件是给终端用户的，平台内部名不该出现在里面）——
|
||||
* 此时整句退化为"你的验证码是"。
|
||||
*/
|
||||
export function renderVerificationMail(mail: VerificationMail): { subject: string; text: string } {
|
||||
const brand = (mail.brand ?? '').trim()
|
||||
const name = brand === '' ? '' : ` ${brand}`
|
||||
const subject = brand === '' ? `${mail.code} is your verification code` : `${mail.code} is your ${brand} verification code`
|
||||
const text = [
|
||||
`Your${name} verification code is: ${mail.code}`,
|
||||
`It expires in ${mail.ttlMinutes} minutes. If you did not request this, just ignore this e-mail.`,
|
||||
'',
|
||||
`你的${name}验证码是：${mail.code}`,
|
||||
`有效期 ${mail.ttlMinutes} 分钟。若非本人操作，请忽略本邮件。`,
|
||||
...(brand === '' ? [] : ['', `— ${brand}`]),
|
||||
].join('\n')
|
||||
return { subject, text }
|
||||
}
|
||||
|
||||
/** 占位符替换：值按 JSON 字符串转义后**只保留内容**，以便安全地嵌进 body 模板的引号内。 */
|
||||
function applyTemplate(template: string, values: Record<string, string>): string {
|
||||
return template.replace(/\{\{\s*([a-zA-Z]+)\s*\}\}/g, (match, key: string) => {
|
||||
const value = values[key]
|
||||
if (value === undefined) return match
|
||||
// slice(1,-1) 去掉 JSON.stringify 加的两端引号：调用方的模板里自己带引号。
|
||||
return JSON.stringify(value).slice(1, -1)
|
||||
})
|
||||
}
|
||||
|
||||
/** 发一封验证码邮件。永不抛异常 —— 失败以 `{ok:false}` 返回，由调用方决定如何记事件。 */
|
||||
export async function sendVerificationCodeMail(
|
||||
settings: MailSettings,
|
||||
mail: VerificationMail,
|
||||
): Promise<MailResult> {
|
||||
const { subject, text } = renderVerificationMail(mail)
|
||||
|
||||
if (settings.driver === 'log') return { ok: true, error: null }
|
||||
|
||||
if (!mailConfigured(settings)) {
|
||||
return { ok: false, error: 'mail_not_configured' }
|
||||
}
|
||||
|
||||
try {
|
||||
if (settings.driver === 'brevo') {
|
||||
return await sendViaBrevo(settings, { ...mail, subject, text })
|
||||
}
|
||||
return await sendViaHttp(settings, { ...mail, subject, text })
|
||||
} catch (e) {
|
||||
// AbortSignal.timeout 抛的是 TimeoutError；其它是网络/解析错误。
|
||||
const message = e instanceof Error ? e.message : String(e)
|
||||
return { ok: false, error: message.slice(0, 200) }
|
||||
}
|
||||
}
|
||||
|
||||
async function sendViaBrevo(
|
||||
settings: MailSettings,
|
||||
mail: VerificationMail & { subject: string; text: string },
|
||||
): Promise<MailResult> {
|
||||
const url = settings.apiUrl === '' ? 'https://api.brevo.com/v3/smtp/email' : settings.apiUrl
|
||||
const headers: Record<string, string> = { 'content-type': 'application/json', accept: 'application/json' }
|
||||
if (settings.apiKey !== '') headers['api-key'] = settings.apiKey
|
||||
const body = {
|
||||
sender: { email: settings.from, name: settings.fromName === '' ? undefined : settings.fromName },
|
||||
to: [{ email: mail.to }],
|
||||
subject: mail.subject,
|
||||
textContent: mail.text,
|
||||
}
|
||||
const res = await fetch(url, {
|
||||
method: 'POST',
|
||||
headers,
|
||||
body: JSON.stringify(body),
|
||||
signal: AbortSignal.timeout(settings.timeoutMs),
|
||||
})
|
||||
if (!res.ok) {
|
||||
// 上游会回一段 JSON（{code,message}）—— 它不含验证码，可以安全地截断留证。
|
||||
const detail = (await res.text().catch(() => '')).slice(0, 200)
|
||||
return { ok: false, error: `brevo_http_${res.status}${detail === '' ? '' : `: ${detail}`}`, status: res.status }
|
||||
}
|
||||
return { ok: true, error: null, status: res.status }
|
||||
}
|
||||
|
||||
async function sendViaHttp(
|
||||
settings: MailSettings,
|
||||
mail: VerificationMail & { subject: string; text: string },
|
||||
): Promise<MailResult> {
|
||||
const headers: Record<string, string> = { 'content-type': 'application/json' }
|
||||
if (settings.apiKey !== '') {
|
||||
if (settings.authHeader !== '') headers[settings.authHeader] = settings.apiKey
|
||||
else headers.authorization = `Bearer ${settings.apiKey}`
|
||||
}
|
||||
const values: Record<string, string> = {
|
||||
to: mail.to,
|
||||
code: mail.code,
|
||||
subject: mail.subject,
|
||||
text: mail.text,
|
||||
from: settings.from,
|
||||
fromName: settings.fromName,
|
||||
}
|
||||
const body =
|
||||
settings.bodyTemplate === ''
|
||||
? JSON.stringify({ from: settings.from, to: mail.to, subject: mail.subject, text: mail.text })
|
||||
: applyTemplate(settings.bodyTemplate, values)
|
||||
|
||||
const res = await fetch(settings.apiUrl, {
|
||||
method: 'POST',
|
||||
headers,
|
||||
body,
|
||||
signal: AbortSignal.timeout(settings.timeoutMs),
|
||||
})
|
||||
if (!res.ok) {
|
||||
const detail = (await res.text().catch(() => '')).slice(0, 200)
|
||||
return { ok: false, error: `mail_http_${res.status}${detail === '' ? '' : `: ${detail}`}`, status: res.status }
|
||||
}
|
||||
return { ok: true, error: null, status: res.status }
|
||||
}
|
||||
Reference in new issue
Block a user