如何让OpnSense与NameCheap域名配合实现动态DNS?
如何让OpnSense与NameCheap域名配合实现动态DNS?
我之前也踩过这个NameCheap和OpnSense DDNS的坑,看到你报的这个316153错误,大概率是配置里的域名信息没对应上,给你整理了一套一步步解决的方案:
首先先明确你的报错信息,方便对照排查:
日志报错内容:
<ResponseString>Validation error; not found; domain name(s)</ResponseString> <ResponseNumber>316153</ResponseNumber> <Description>Domain name not found</Description>
第一步:确认NameCheap端的域名配置
- 登录NameCheap后台,找到你的目标域名,进入「Advanced DNS」页面
- 先创建好要用来做动态DNS的完整域名记录:比如你想用来访问家里网络的
home.yourdomain.com,新建一条A记录,主机名填home,值暂时随便填一个公网IP,TTL选择「Automatic」 - 找到页面里的「Dynamic DNS」选项,把它开启,然后复制系统生成的动态DNS专用密码(划重点:这个不是你的NameCheap账号密码,是专门给DDNS用的密钥,别搞混了)
第二步:配置OpnSense的动态DNS服务
- 登录OpnSense后台,进入「Services > Dynamic DNS > General」
- 点击「Add」新建一个DDNS条目,重点参数要填对:
- 「Service type」选择「Namecheap」
- 「Interface to monitor」选你的WAN接口(就是用来获取公网IP的那个接口)
- 「Hostname」必须填完整的域名,比如刚才创建的
home.yourdomain.com,不能只填home或者yourdomain.com - 「Username」填你的主域名,比如
yourdomain.com(不要带任何子域名前缀) - 「Password」粘贴刚才从NameCheap复制的动态DNS专用密码
- 其他参数保持默认即可,点击「Save」后记得点击页面上方的「Apply Changes」应用配置
第三步:排查常见问题
如果配置后还是报错,可以从这几个方向检查:
- 域名拼写是否完全一致:虽然域名不区分大小写,但建议和NameCheap后台的记录完全匹配,避免不必要的错误
- 主域名和子域名是否搞混:Username是主域名,Hostname是完整的子域名+主域名,这两个字段很容易填反
- NameCheap的Dynamic DNS是否生效:有时候后台开启后会有1-2分钟的延迟,建议等一会儿再测试OpnSense的配置
- 检查OpnSense的WAN网络:确保WAN口能正常访问外网,DDNS服务需要向NameCheap的API发送请求才能生效
备注:内容来源于stack exchange,提问作者Sled




