John/system-design
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

IT系统

Browse Source
This commit is contained in:
jiahong
2026-03-21 14:54:46 +08:00
parent 5248e94cac
commit e6db29485b
1 changed files with 367 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
IT服务平台/ICT服务平台/互联网服务体系的建设.md
+367
View File
@@ -0,0 +1,367 @@
# 自然写科技互联网服务体系规划建设
## 一、域名定位
自然写科技拥有四个域名，各自承担明确的角色分工：
| 域名 | 角色 | 说明 |
|------|------|------|
| **yink.ai** | **品牌主域 / 全球前端** | 解析到香港服务器，对外统一宣传，所有营销材料、名片、包装统一使用此域名 |
| writech.ai | 品牌辅助域 | 与 yink.ai 指向同一站点，301 跳转至 yink.ai，保留完整品牌名的可达性 |
| writech.cn | 大陆数据服务 | ICP 备案，承载 API、存储、AI 处理，所有用户数据留存于大陆 |
| writech.hk | 备用 / 香港节点 | 可作 yink.ai 的 CNAME 或香港 CDN 源站备用入口 |
**为什么选择 yink.ai 作为品牌主域**：
- **更简洁**：yink.ai 仅 7 个字符（writech.ai 为 10 个字符），输入更快，记忆更容易
- **品牌基因一致**：yink 延续 ink 系列命名基因（Y 可代表 "Your ink"），与硬件产品（Bink / Cink / Mink / Tink …）的命名体系高度统一
- **视觉友好**：短域名在二维码、产品丝印、名片、APP 启动页等印刷空间受限场景下显示效果更佳
- **域名后缀**：.ai 后缀体现公司 AI 智能教育的技术定位
**writech.ai 的辅助角色**：writech.ai 保留不弃用，所有通过 writech.ai 的访问自动 301 永久跳转至 yink.ai，确保历史链接和搜索引擎收录不失效，同时将 SEO 权重集中到 yink.ai。
**核心设计原则**：品牌形象与数据服务解耦。对外统一用 yink.ai 呈现品牌（writech.ai 自动跳转至 yink.ai），用户实际的数据读写全部落在 writech.cn 的大陆服务器上，符合数据安全合规要求。
---
## 二、网站与 API 架构
### 2.1 首页（yink.ai）
- 部署于香港云服务器（阿里云 HK / 腾讯云 HK），并接入 **Cloudflare** 全球 CDN
- 页面为纯静态（HTML / CSS / JS），内容基本不变，CDN 全球缓存后访问极快
- 大陆用户访问 yink.ai 属于"浏览境外网站"，只要页面不含敏感内容，一般可正常访问（与 GitHub Pages、Notion 等性质相同）
- 访问 writech.ai 自动 301 跳转至 yink.ai，两个域名共享同一香港源站
- **首页服务器不存放任何用户数据**，仅作品牌展示与产品介绍
### 2.2 大陆数据服务（writech.cn）
独立 ICP 备案，部署于大陆云服务器（阿里云 / 腾讯云），承载全部后端业务：
- 用户账号注册 / 登录 / 认证（OAuth2 / JWT）
- 智能笔笔迹数据上传 / 下载
- AI 手写识别推理（OCR、笔顺评分、数学识别）
- 文件对象存储（OSS / COS）
- MQTT / WebSocket 实时数据通道（笔迹实时同步）
- 设备管理、OTA 升级
大陆端 APP、SDK、设备固件的 API BaseURL 统一配置为：
```
https://api.writech.cn/v1/
```
### 2.3 前后端跨域调用（CORS）
yink.ai 首页中的前端 JS 调用大陆 API 涉及跨域，通过标准 CORS 机制解决：
```
yink.ai 前端 JS
└─ fetch("https://api.writech.cn/v1/...")
└─ 大陆 API 服务端响应头配置：
Access-Control-Allow-Origin: https://yink.ai
Access-Control-Allow-Credentials: true
Access-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS
```
配套要点：
- 大陆 API 网关（Nginx / API Gateway）统一拦截并注入 CORS 响应头，允许 `yink.ai` 和 `writech.ai` 两个来源，无需每个服务单独配置
- 用户 Token 使用 `Authorization: Bearer <token>` Header 方式传递，避免跨域 Cookie 的复杂性
- 敏感操作（注册、实名认证、支付）建议直接跳转至 `writech.cn` 页面完成，减少跨域风险面
### 2.4 海外数据服务（按需扩展）
当海外业务增长到需要独立节点时，通过 Cloudflare Worker 实现地区智能路由，无需改动客户端代码：
```
用户访问 yink.ai 首页
└─ Cloudflare Worker 检测用户 IP 所在地区
├─ 大陆用户 → API BaseURL = https://api.writech.cn
└─ 海外用户 → API BaseURL = https://api-sg.yink.ai（新加坡）
或 https://api-us.yink.ai（美西）
```
- 海外 API 节点部署于新加坡 / 美西云服务器，用户数据按所在地合规存储
- Cloudflare Worker 提供 `/geo` 接口，前端 JS 首次加载时调用一次，缓存地区信息后动态切换 API BaseURL
- 海外节点与大陆节点通过消息队列异步同步必要的公共数据（如产品目录、固件版本），用户私有数据不跨境传输
### 2.5 DNS 规划
| 记录 | 类型 | 指向 | 用途 |
|------|------|------|------|
| **yink.ai** | **A / Proxied** | **Cloudflare CDN → 香港源站** | **品牌主域首页** |
| www.yink.ai | CNAME | yink.ai | 带 www 访问 |
| api.yink.ai | CNAME / Worker | Cloudflare Worker | 预留，可转发至 api.writech.cn |
| api-sg.yink.ai | A | 新加坡服务器 | 海外 API（按需） |
| writech.ai | A / Proxied | Cloudflare CDN → 同一香港源站 | 辅助域，301 跳转至 yink.ai |
| www.writech.ai | CNAME | writech.ai | 301 跳转至 yink.ai |
| writech.cn | A | 大陆云服务器 | 主备案域 |
| api.writech.cn | A | 大陆 API 服务器 | 大陆数据 API |
| writech.hk | CNAME | yink.ai | 香港备用入口 |
---
## 三、电子邮件服务规划
### 3.1 可行性结论
**完全可行，推荐统一使用 `xxx@yink.ai`**。
电子邮件走 SMTP / IMAP 协议，与网站是否在大陆 ICP 备案没有任何关系。只要 yink.ai 域名的 DNS MX 记录指向合规的企业邮件服务器，全体员工和所有客服地址均可统一使用 `@yink.ai` 后缀，国内外用户侧完全一致，品牌形象统一。
> **备注**：如有历史 `@writech.ai` 邮箱地址在外部流通，可同步在 writech.ai 域名下配置 MX 记录，将 `xxx@writech.ai` 来信转发到对应的 `xxx@yink.ai` 邮箱，确保过渡期不丢信。
### 3.2 推荐方案
**方案 A — Cloudflare Email Routing（免费，适合早期）**
```
yink.ai DNS 托管于 Cloudflare
└─ 开启 Cloudflare Email Routing（免费功能）
└─ MX 记录自动指向 Cloudflare 邮件路由服务器
└─ 将 xxx@yink.ai 转发到员工实际收件邮箱
├─ 个人员工：转发到各自的 Gmail / QQ 邮箱
└─ 客服角色：转发到飞书群邮箱 / 企业微信
└─ 发件配置：在 Gmail / Outlook 中添加"以其他地址发送"
配置 SMTP 凭据，对外显示 xxx@yink.ai 发出
```
优点：完全免费，5 分钟配置完成，无需购买额外服务
适合：公司初创期，人员 20 人以内
---
**方案 B — 腾讯企业邮箱（推荐，国内访问最稳定）**
```
yink.ai MX 记录 → 腾讯企业邮箱 MX 服务器（exmail.qq.com）
└─ 管理后台统一分配 xxx@yink.ai 邮箱账号
└─ 支持 Web 端、Outlook、iPhone / Android 原生邮件 APP
└─ 大陆访问极速稳定，海外员工同样可用
```
- 费用约 **8 元/人/月**，腾讯企业邮箱明确支持 `.ai` 后缀域名
- 提供邮件归档、反垃圾、大附件等企业级功能
- 适合团队规模 10 人以上，长期使用推荐此方案
---
**方案 C — Google Workspace（国际形象，大陆需 VPN）**
```
yink.ai MX 记录 → Google MX 服务器
└─ 全员 Google 账号，收发地址均为 xxx@yink.ai
└─ 大陆员工需通过 VPN 访问，不适合全员在国内的团队
```
适合：海外团队为主，或公司已有 VPN 基础设施
### 3.3 功能邮箱规划
| 用途 | 邮件地址 | 说明 |
|------|----------|------|
| 客户服务 | support@yink.ai | 统一对外，国内外用户均用此地址联系 |
| 商务合作 | bd@yink.ai | 渠道合作、商务洽谈 |
| 技术支持 | tech@yink.ai | 开发者、SDK 集成客户 |
| 媒体公关 | pr@yink.ai | 媒体采访、公关事务 |
| 管理员 | admin@yink.ai | 系统通知，内部使用 |
客服邮箱**国内外统一，不做地区区分**，后台由客服管理系统（如飞书、Zendesk）按用户语言或地区自动路由分派给对应客服人员处理。
### 3.4 必须配置的 DNS 邮件记录
邮件送达率依赖以下四类 DNS 记录，缺少任何一项都会导致邮件被对方标记为垃圾邮件：
```dns
# ===== yink.ai 主邮件域 =====
# 1. MX 记录 — 指定收件服务器（按选定方案填写）
yink.ai. MX 10 exmail.qq.com. # 腾讯企业邮箱示例
# 2. SPF — 声明授权发件服务器，防伪造发件人
yink.ai. TXT "v=spf1 include:spf.mail.qq.com ~all"
# 3. DKIM — 邮件内容数字签名，防篡改
selector._domainkey.yink.ai. TXT "v=DKIM1; k=rsa; p=<公钥由邮件服务商提供>"
# 4. DMARC — 声明 SPF/DKIM 验证失败时的处理策略
_dmarc.yink.ai. TXT "v=DMARC1; p=quarantine; rua=mailto:admin@yink.ai"
# ===== writech.ai 辅助邮件域（过渡期接收转发）=====
writech.ai. MX 10 exmail.qq.com. # 同一邮件服务商
writech.ai. TXT "v=spf1 include:spf.mail.qq.com ~all"
```
> **说明**：以上记录中的具体值（MX 主机名、SPF include、DKIM 公钥）在选定邮件服务商后，由服务商管理后台提供，按实际值填写到 Cloudflare DNS 即可。writech.ai 辅助域的 MX 配置确保历史 @writech.ai 邮件可正常接收并转发至对应 @yink.ai 邮箱。
---
## 四、SSL / TLS 证书规划
全站 HTTPS 是安全底线，四个域名及其子域均须配置 SSL 证书，且需兼顾成本、自动续期和多域名管理的便捷性。
### 4.1 各域名证书方案
| 域名 / 子域 | 推荐方案 | 证书类型 | 费用 | 有效期 / 续期 |
|------------|---------|---------|------|---------------|
| yink.ai / www / api.yink.ai | Cloudflare Universal SSL | DV 通配符 | 免费 | 自动续期，无需人工介入 |
| writech.ai / www.writech.ai | Cloudflare Universal SSL | DV 通配符 | 免费 | 自动续期，与 yink.ai 同一 Cloudflare 账户 |
| writech.cn / api.writech.cn | 云厂商免费证书（阿里云 / 腾讯云）| DV 单域名 | 免费 | 1 年，到期前自动或手动续期 |
| writech.hk | 随 yink.ai 走 Cloudflare | DV | 免费 | 自动 |
| 未来海外节点 api-sg / api-us | Let's Encrypt + Certbot 自动化 | DV 通配符 | 免费 | 90 天，cron 自动续期 |
> **DV**（Domain Validation）= 域名验证型证书，签发快、免费，满足绝大多数场景。若未来需要在浏览器地址栏显示企业名称（绿色标识），可升级为 OV/EV 证书。
### 4.2 Cloudflare 侧（yink.ai / writech.ai）
yink.ai 和 writech.ai 两个域名均托管到 Cloudflare 后，各自自动获得以下两层 TLS：
```
用户浏览器 ←─ Cloudflare Universal SSL（自动签发）─→ Cloudflare CDN 边缘节点
│
Cloudflare 边缘节点 ←─ Origin Certificate（15年有效）─→ 香港源站服务器
```
- **前端（浏览器 → CDN）**：Cloudflare 自动签发 Universal SSL 证书，覆盖 `yink.ai` 及 `*.yink.ai`（同理 `writech.ai` 及 `*.writech.ai`）所有子域，零配置
- **回源（CDN → 源站）**：在 Cloudflare 控制台生成 Origin Certificate（免费，最长 15 年有效），安装到香港源站 Nginx，确保回源链路也加密
- **SSL 模式设为 Full (Strict)**：强制双向验证，杜绝中间人攻击
### 4.3 大陆侧（writech.cn）
大陆 API 服务器不经过 Cloudflare，需独立申请和管理证书：
**方案 A — 云厂商免费证书（推荐）**
- 阿里云 / 腾讯云均提供 **免费 DV 证书**（每年可申请 20 张）
- 在控制台申请 → DNS 验证 → 自动签发 → 下载部署至 Nginx / API 网关
- 到期前云厂商会邮件提醒，可设置自动续期
**方案 B — Let's Encrypt + Certbot 自动化**
```bash
# 安装 Certbot（以 Ubuntu + Nginx 为例）
sudo apt install certbot python3-certbot-nginx
# 申请证书（含 writech.cn 和 api.writech.cn）
sudo certbot --nginx -d writech.cn -d api.writech.cn
# 自动续期已默认配置，验证：
sudo certbot renew --dry-run
```
- 完全免费，90 天有效期，Certbot cron 任务自动续期
- 适合自建服务器（非云厂商托管）场景
### 4.4 Nginx HTTPS 配置模板
大陆 API 服务器的 Nginx 推荐配置：
```nginx
server {
listen 80;
server_name api.writech.cn writech.cn;
return 301 https://$host$request_uri; # HTTP 强制跳转 HTTPS
}
server {
listen 443 ssl http2;
server_name api.writech.cn;
ssl_certificate /etc/ssl/certs/writech_cn.pem;
ssl_certificate_key /etc/ssl/private/writech_cn.key;
# TLS 安全加固
ssl_protocols TLSv1.2 TLSv1.3; # 禁用 TLS 1.0/1.1
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256;
ssl_prefer_server_ciphers on;
# HSTS — 告诉浏览器此后只允许 HTTPS 访问（建议上线稳定后开启）
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
# CORS 头（允许 yink.ai 和 writech.ai 前端跨域调用）
# 生产环境建议通过 Nginx map 动态匹配多个 Origin
add_header Access-Control-Allow-Origin "https://yink.ai" always;
add_header Access-Control-Allow-Methods "GET, POST, PUT, DELETE, OPTIONS" always;
add_header Access-Control-Allow-Headers "Authorization, Content-Type" always;
location / {
proxy_pass http://127.0.0.1:8080; # 后端服务
}
}
```
### 4.5 证书监控与告警
证书过期是生产事故高频原因之一，建议配置监控：
| 方式 | 说明 |
|------|------|
| Cloudflare 仪表盘 | yink.ai / writech.ai 证书由 CF 自动管理，可在 SSL/TLS 页面查看状态 |
| 云厂商短信/邮件提醒 | 阿里云 / 腾讯云证书到期前 30 天自动通知 |
| Certbot renew cron | Let's Encrypt 证书自动续期，配合 `--deploy-hook` 重载 Nginx |
| 外部监控（推荐） | 使用 [UptimeRobot](https://uptimerobot.com)（免费）监控各域名 HTTPS 可用性，到期前自动邮件告警 |
---
## 五、整体架构
```
┌─────────────────────────────────┐
│ 用户（大陆 / 海外） │
└─────────────────┬───────────────┘
│ HTTPS
▼
┌─────────────────────────────────┐
│ yink.ai（主）/ writech.ai（301跳转） │
│ Cloudflare CDN · 香港源站 │
│ 静态首页 / 品牌落地页 / 文档 │
└──────────┬──────────────┬────────┘
│ CORS API │ CORS API
▼ ▼
┌───────────────────┐ ┌──────────────────────┐
│ api.writech.cn │ │ api-sg.writech.ai │
│ （大陆·ICP备案） │ │ （新加坡·按需上线） │
│ 阿里云 / 腾讯云 │ │ 海外云服务器 │
│ │ │ │
│ · 用户认证 │ │ · 海外用户数据 │
│ · 笔迹数据存储 │ │ · 独立合规存储 │
│ · AI 手写识别 │ │ · 公共数据同步 │
│ · MQTT 实时通道 │ │ │
│ · OTA 固件升级 │ └──────────────────────┘
└───────────────────┘
┌─────────────────────────────────┐
│ 企业邮件（@yink.ai 统一域名） │
│ MX → 腾讯企业邮箱 / CF Routing │
│ SPF + DKIM + DMARC 全配置 │
└─────────────────────────────────┘
```
---
## 六、实施路线图
| 阶段 | 任务 | 预计周期 |
|------|------|----------|
| **第一阶段** | writech.ai + yink.ai 域名托管至 Cloudflare，DNS 全面配置 | 第 1 周 |
| **第一阶段** | 香港源站服务器搭建，静态首页上线 | 第 1-2 周 |
| **第一阶段** | writech.cn ICP 备案（若未完成），大陆 API 服务器上线 | 同步进行 |
| **第一阶段** | 企业邮箱开通（腾讯企业邮箱），SPF / DKIM / DMARC 配置，分配员工邮箱 | 第 1 周 |
| **第二阶段** | 大陆 APP / SDK / 固件 API BaseURL 统一切换至 `api.writech.cn` | 第 3-6 周 |
| **第二阶段** | 大陆 API 网关配置 CORS，允许 yink.ai / writech.ai 前端跨域调用 | 同步 |
| **第二阶段** | Cloudflare Worker 实现 `/geo` 地区检测接口 | 第 4 周 |
| **第三阶段** | 海外 API 节点上线（新加坡），前端智能路由切换 | 按业务需求 |
| **第三阶段** | 数据合规审查，确认海外数据不跨境传输 | 配套进行 |
---
## 七、关键注意事项
1. **ICP 备案是底线**：writech.cn 必须完成 ICP 备案才能在大陆正常提供服务，备案期间（约 20 个工作日）可先用香港服务器临时承载
2. **yink.ai 首页内容合规**：首页面向全球，避免涉及敏感词汇，确保大陆用户可正常访问
3. **数据主权**：大陆用户产生的数据必须存储于 writech.cn 大陆服务器，不得将用户数据同步至香港或海外节点，符合《数据安全法》和《个人信息保护法》
4. **邮件发件域名一致性**：所有系统通知邮件（注册验证码、订单确认等）的发件地址统一使用 `noreply@yink.ai`，避免用 writech.cn 发信造成品牌形象分裂
5. **HTTPS 全站强制**：yink.ai、writech.ai 和 writech.cn 所有端点必须强制 HTTPS，Cloudflare 可免费提供 TLS 证书
6. **writech.ai → yink.ai 301 跳转**：writech.ai 所有路径统一 301 永久跳转至 yink.ai 对应路径，集中 SEO 权重；确保历史链接、搜索引擎索引不失效