必须配置私有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。
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记录。
