主题
域名规划
三个入口
| 域名 | 角色 | 内容 | 发布目录 |
|---|---|---|---|
emphant.com | 主站 | 88 个在线工具 | /var/www/emphant |
docs.emphant.com | 项目文档 | 架构、构建、部署、运维 | /var/www/emphant-docs |
blog.emphant.com | 技术随笔 | 方案取舍、踩坑记录 | /var/www/emphant-blog |
主域下的 /m/ 是手机版入口,不单独开子域:手机用户点分享链接会落在 emphant.com/xxx,由 UA 判定 302 到 /m/,少一次跨域跳转,也不用为手机版单独申请证书。
DNS 记录
全部为 A 记录,指向同一台服务器:
| 主机名 | 类型 | 值 | 用途 |
|---|---|---|---|
@ | A | 121.43.28.40 | 主站 |
www | A | 121.43.28.40 | 301 到主域(保留习惯输入) |
m | A | 121.43.28.40 | 301 到主域,兼容历史链接 |
docs | A | 121.43.28.40 | 文档站 |
blog | A | 121.43.28.40 | 随笔站 |
bash
dig +short docs.emphant.com
# 121.43.28.40没有使用 CNAME:子域与主域在同一台机器,A 记录更直观,也不会因为别名解析多一跳。
为什么不放在主域的子目录
emphant.com/docs/ 也能用,但拆子域有三个好处:
- 职责隔离:文档与随笔的构建、缓存、证书可以独立发布和回滚,不会误伤工具站;
- 技术栈自由:VitePress 与多页 Vite 站的资源路径、404 行为不同,分开 vhost 更简单;
- 可迁移:将来文档量变大要上 CDN 或换机器,只改一条 DNS 记录。
新增子域的步骤
- DNS 加一条 A 记录指向
121.43.28.40,等解析生效(dig +short确认); - 在
scripts/deploy.py的SUBDOMAIN_CONF模板里加一个 server 块; - 把子域加入证书(见 HTTPS 证书);
./deploy.sh sites应用配置,curl -I https://新子域/验证;- 在本文档的表格里补一行。
备案
主域已完成 ICP 备案:京ICP备2026079613号,页脚由 categories.js 的 site.icp 统一注入。子域属于同一主体,不需要单独备案,但页面仍需显示备案号——文档站与随笔站的页脚已带上。
检查清单
bash
for h in emphant.com docs.emphant.com blog.emphant.com; do
printf '%-24s ' "$h"
curl -s -o /dev/null -w '%{http_code} %{redirect_url}\n' "https://$h/"
done期望:三个域名都返回 200,或 301 到自身的 HTTPS 地址。