Skip to content

域名规划 ​

三个入口 ​

域名角色内容发布目录
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 记录,指向同一台服务器:

主机名类型值用途
@A121.43.28.40主站
wwwA121.43.28.40301 到主域(保留习惯输入)
mA121.43.28.40301 到主域,兼容历史链接
docsA121.43.28.40文档站
blogA121.43.28.40随笔站
bash
dig +short docs.emphant.com
# 121.43.28.40

没有使用 CNAME:子域与主域在同一台机器,A 记录更直观,也不会因为别名解析多一跳。

为什么不放在主域的子目录 ​

emphant.com/docs/ 也能用,但拆子域有三个好处:

  1. 职责隔离:文档与随笔的构建、缓存、证书可以独立发布和回滚,不会误伤工具站;
  2. 技术栈自由:VitePress 与多页 Vite 站的资源路径、404 行为不同,分开 vhost 更简单;
  3. 可迁移:将来文档量变大要上 CDN 或换机器,只改一条 DNS 记录。

新增子域的步骤 ​

  1. DNS 加一条 A 记录指向 121.43.28.40,等解析生效(dig +short 确认);
  2. 在 scripts/deploy.py 的 SUBDOMAIN_CONF 模板里加一个 server 块;
  3. 把子域加入证书(见 HTTPS 证书);
  4. ./deploy.sh sites 应用配置,curl -I https://新子域/ 验证;
  5. 在本文档的表格里补一行。

备案 ​

主域已完成 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 地址。

文档随仓库一起更新,站点内容全部在浏览器本地运行。