Windows安装CouchDB后局域网跨机访问失败，改bind_address仍无效

嘿，我之前也碰到过一模一样的情况——改了bind_address到0.0.0.0重启服务后，本地访问正常但局域网其他机器连不上。下面几个排查步骤你可以逐一试试：

• 检查Windows防火墙规则
  Windows默认防火墙会阻止外部机器访问本机端口，这是最常见的原因。你需要手动添加入站规则：

  1. 打开「Windows Defender防火墙」→ 「高级设置」
  2. 右键「入站规则」→ 「新建规则」
  3. 选择「端口」，下一步后输入5984（如果改了CouchDB端口就填对应的），允许连接，然后完成规则创建。

• 确认CouchDB确实监听了所有地址
  修改配置后有时候服务重启不彻底，或者你改的不是正确的local.ini文件。可以在本地执行命令：

  netstat -ano | findstr :5984
  

  看输出里的地址是不是0.0.0.0:5984，如果还是127.0.0.1，说明配置没生效：

  • 确认你修改的是CouchDB安装目录下etc/couchdb/local.ini（比如默认路径C:\Program Files\Apache CouchDB\etc\couchdb）
  • 重启服务时要确保是「Apache CouchDB」服务，而不是其他相关进程，最好在服务管理器里右键重启，而不是仅关闭Fauxton界面。

• 验证局域网基本连通性
  先在另一台机器上执行ping 192.168.25.49，如果ping不通，说明两台机器的网络本身有问题：

  • 检查两台机器是不是在同一个子网（比如都是192.168.25.x段）
  • 确认CouchDB所在机器的IP没有变动（可以在本地用ipconfig查看当前IPv4地址）
  • 排查路由器或交换机有没有开启端口隔离之类的限制

• 检查CouchDB的访问权限配置
  如果你的CouchDB设置了管理员账户，或者配置了访问白名单，可能会阻止外部访问：

  • 打开local.ini，检查[httpd]段有没有allowlist配置，如果有，确保把局域网的IP段加进去（比如allowlist = 127.0.0.1,192.168.25.0/24）
  • 确认没有设置require_valid_user = true之类的强制验证规则（如果设置了，远程访问需要带账号密码，比如curl -X GET http://admin:password@192.168.25.49:5984）

• 换个工具测试访问
  有时候curl没响应可能是工具本身的问题，试试用另一台机器的浏览器访问http://192.168.25.49:5984/_utils/，如果能打开Fauxton界面，说明服务没问题，只是curl的参数或环境有问题；如果浏览器也打不开，再回到前面的防火墙和网络排查。

内容的提问来源于stack exchange，提问作者Ricardo Brandao