关于 blink-domains
blink-domains 是用于管理 Blink 项目域名的命令行技能,可添加、列出、验证、移除、搜索和购买域名,并提供 DNS 指引及 DNS 生效后的自动 SSL 配置。
主要功能
- 01添加、列出、验证和移除域名
- 02搜索并购买域名
- 03提供 DNS 配置说明
- 04检查 SSL 证书状态
- 05配置顶级域名到 www 的重定向
适用场景
- 01为项目绑定自定义域名
- 02检查域名的 DNS 和 SSL 状态
- 03查找或购买可用域名
- 04将顶级域名重定向到 www
MCP 相关
它提供用于添加、列出、验证、移除、搜索和购买域名的 MCP 工具。MCP 客户端可通过这些工具管理 Blink 项目域名。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ blink-new/ blink-plugin --skill blink-domains安装后在 Claude Code 中输入/blink-domains确认已加载。
详细介绍
MCP 工具
blink_domains_add · blink_domains_list · blink_domains_verify · blink_domains_remove · blink_domains_search · blink_domains_purchase
快速入门
# Add a custom domain to your project
blink domains add myapp.com
# Check domain status and DNS instructions
blink domains list
# Verify DNS is configured (domain_id from `blink domains list` or `blink domains add`)
blink domains verify <domain_id>
添加自定义域名
blink domains add myapp.com
CLI 会输出需要配置的 DNS 记录:
Configure these DNS records at your registrar:
Type Name Value
CNAME @ cname.blink.new
CNAME www cname.blink.new
After configuring DNS, run: blink domains verify <domain_id>
DNS 配置
| 域名类型 | 记录类型 | 名称 | 值 |
|---|---|---|---|
根域名(myapp.com) | CNAME 或 A | @ | cname.blink.new |
子域名(www) | CNAME | www | cname.blink.new |
| 通配符 | CNAME | * | cname.blink.new |
根域名 + www:添加这两条记录。Blink 会为两者自动配置 SSL。
SSL 验证
DNS 传播后,系统会自动配置 SSL 证书。验证状态:
# domain_id comes from `blink domains list` or `blink domains add` response
blink domains verify <domain_id>
# → SSL: active | pending | error
DNS 传播可能需要 1–48 小时。大多数服务商会在 10 分钟内完成传播。
域名搜索与购买
# Search for available domains
blink domains search myapp
# Purchase a domain (if available)
blink domains purchase myapp.com
购买的域名会自动配置,无需手动设置 DNS。
管理域名
# List all domains on current project
blink domains list
# Remove a domain (use domain_id, not domain name)
blink domains remove <domain_id>
根域名 → www 重定向
对于无法使用 CNAME 记录的根域名(部分注册商不支持),Blink 支持自动将根域名重定向到 www:
blink domains add myapp.com --redirect-www
这会存储一条重定向规则,通过 301 将 myapp.com 重定向到 www.myapp.com。
完整设置流程
# 1. Deploy your app first
blink deploy ./dist --prod
# 2. Add domain
blink domains add myapp.com
# 3. Configure DNS at registrar (follow output instructions)
# 4. Verify (use domain_id from step 2)
blink domains verify <domain_id>
# 5. Done — site is live at myapp.com with SSL
常见问题
| 问题 | 解决方法 |
|---|---|
| SSL 待处理 | 等待 DNS 传播(最长 48 小时) |
| CNAME 冲突 | 删除同名的现有 A/AAAA 记录 |
| 不支持根域名 CNAME | 使用 A 记录或启用 www 重定向 |
| 域名无法解析 | 使用 dig myapp.com 验证记录 |
评论
支持 Markdown