必须配置私有dns解析机制才能通过自定义域名访问workbuddy内网服务,具体路径有三:一、修改本地hosts文件强制映射;二、在内网dns服务器添加a记录;三、部署dnsmasq等轻量级dns代理服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您已完成WorkBuddy部署,但需在企业内网或本地测试环境中通过自定义域名(如workbuddy.local)访问其内部服务端点,则必须配置私有DNS解析机制。WorkBuddy自身不内置DNS服务,其Web UI、MCP Server及OpenClaw插件路由依赖于客户端可解析的稳定域名。以下是实现该目标的具体操作路径:
一、修改本地hosts文件强制映射
该方法适用于单机调试或小规模终端环境,无需额外服务组件,直接绕过公共DNS查询链路,将指定域名指向WorkBuddy所在服务器的内网IP。
1、确认WorkBuddy服务实际监听地址:在服务器上执行netstat -tuln | grep :3000(默认Web端口)或检查config.yaml中server.host与server.port字段,获取其绑定的内网IP(如192.168.3.15)。
2、以管理员身份打开本地hosts文件:Windows路径为C:\Windows\System32\drivers\etc\hosts;macOS/Linux路径为/etc/hosts。
3、在文件末尾新增一行,格式为:192.168.3.15 workbuddy.local,确保IP与域名间用制表符或空格分隔,无多余符号。
4、保存文件后,在命令行执行ipconfig /flushdns(Windows)或sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder(macOS)清空本地DNS缓存。
5、在浏览器中访问https://workbuddy.local:3000,验证是否成功加载WorkBuddy登录页。
二、在内网DNS服务器添加A记录
该方法适用于已部署企业级DNS基础设施(如Windows Server DNS、BIND或云厂商私有DNS)的场景,可实现全网终端统一解析,避免逐台维护hosts文件。
1、登录内网DNS服务器管理界面:Windows Server用户打开“DNS管理器”,BIND用户编辑/var/named/zone文件目录下的正向解析区域文件(如workbuddy.internal.db)。
2、在对应正向查找区域中新增标准A记录:Windows DNS控制台右键区域→“新建主机(A或AAAA)”,主机名为workbuddy,IP地址填入WorkBuddy服务所在服务器内网IP;BIND环境下在区域文件中追加一行:workbuddy IN A 192.168.3.15。
OpenClaw 水产市场(openclawmp.cc)平台操作指南。Agent 在水产市场上注册、登录、浏览资产、安装技能、发布作品、参与社区互动的完整手册。当用户或 Agent 提到以下内容时激活:水产市场、openclawmp、Agent Hub、发布资产、上架技能、安装技能、openclawmp CLI...
3、若需支持HTTPS证书校验,同步添加一条CNAME记录指向主域名,例如:*.workbuddy IN CNAME workbuddy(仅当使用通配符证书时必需)。
4、保存配置后,在DNS服务器上执行重新加载操作:Windows DNS中右键服务器→“重新加载”;BIND中执行rndc reload。
5、在任一内网客户端执行nslookup workbuddy.workbuddy.internal(或您配置的实际域名),确认返回值为预期内网IP且无超时。
三、部署轻量级本地DNS代理服务
该方法适用于无集中DNS服务器、但需多终端一致解析的中小团队环境,通过dnsmasq等工具在WorkBuddy服务器本机提供DNS转发与静态解析能力,降低运维复杂度。
1、在WorkBuddy所在服务器安装dnsmasq:Ubuntu/Debian执行sudo apt install dnsmasq;CentOS/RHEL执行sudo yum install dnsmasq;macOS执行brew install dnsmasq。
2、编辑dnsmasq配置文件:Ubuntu路径为/etc/dnsmasq.conf,追加两行:address=/workbuddy.local/192.168.3.15与server=114.114.114.114(后者为上游公共DNS,确保非本地域名仍可解析)。
3、重启dnsmasq服务:执行sudo systemctl restart dnsmasq,并验证状态为active (running)。
4、将内网所有客户端的DNS服务器地址手动设置为WorkBuddy服务器的IP(即192.168.3.15),覆盖DHCP分配的默认DNS。
5、在客户端执行nslookup workbuddy.local,确认响应来自192.168.3.15且返回正确A记录。










