Atoms项目一键部署后加自定义域名

Atoms项目加自定义域名需两步：一是DNS解析（A记录指向服务器IP或CNAME指向平台域名），二是平台侧绑定域名并启用HTTPS；不同部署环境（Vercel、GitHub Pages、云服务器等）配置方式各异，但均无需改代码。

Atoms项目一键部署后加自定义域名，核心在于两步：让域名能解析到服务所在地址，再让服务识别并响应这个域名。不需要改代码，但需确认部署平台类型（如Vercel、GitHub Pages、云服务器或内网环境），不同场景配置方式差异明显。

确认Atoms部署平台类型

Atoms通常指基于Electron或Web技术的桌面/前端项目，一键部署后多托管在静态站点平台或容器服务中。先明确当前部署位置：

1. 若用Vercel、Netlify、Cloudflare Pages等SaaS平台——走CNAME解析 + 平台后台绑定
2. 若部署在GitHub Pages——必须添加CNAME文件 + DNS CNAME记录
3. 若跑在自有云服务器（Nginx/Apache）——配A记录 + 服务端虚拟主机（server_name）
4. 若仅本地运行（如开发调试）——可用hosts文件临时映射，或搭配frp/ngrok做内网穿透

通用DNS解析设置（以主流注册商为例）

登录你的域名管理后台（如阿里云DNSPod、Namecheap），添加对应记录：

1. 根域（example.com）：添加A记录，主机名填@，记录值为服务器IP（仅适用于自有服务器）
2. 子域（www.example.com 或 app.example.com）：添加CNAME记录，主机名填www或app，记录值填平台提供的默认域名（如atoms-user.vercel.app）
3. TTL建议设为600秒，便于后续调试时快速生效
4. 保存后，用dig example.com +short或nslookup www.example.com验证是否返回预期IP或CNAME

平台侧关键配置（按常见情况）

仅配置DNS不够，服务端必须“认得”这个域名：

1. Vercel/Netlify：进项目Settings → Domains → Add Domain，输入www.example.com，平台自动完成验证与HTTPS证书签发
2. GitHub Pages：在项目根目录新建纯文本文件CNAME（全大写、无扩展名），内容只写www.example.com（不带http，不带/），提交后等待1~24小时
3. 云服务器（Nginx）：修改server块，加入server_name www.example.com example.com;，重载Nginx（sudo nginx -s reload）
4. 内网穿透（如frp）：在frpc.ini中设置custom_domains = app.example.com，并在DNS中将该域名CNAME到穿透服务提供的主域名

HTTPS证书与访问验证

域名生效后，务必启用HTTPS：

1. Vercel/Netlify/Cloudflare Pages默认自动申请Let’s Encrypt证书，无需额外操作
2. GitHub Pages绑定自定义域名后，会在几分钟内自动启用HTTPS（需确保CNAME文件存在且DNS已生效）
3. 云服务器建议用Certbot：sudo certbot --nginx -d example.com -d www.example.com
4. 浏览器访问https://www.example.com，检查地址栏锁图标是否正常，避免混合内容警告