IPFS HTTP Server拒绝连接求助：服务器端调用ipfs-http-client失败

1. 修正IPFS守护进程的API监听范围 #

默认ipfs daemon仅监听127.0.0.1:5001，服务器上的应用无法跨进程/跨容器访问。执行以下命令修改配置：

ipfs config Addresses.API /ip4/0.0.0.0/tcp/5001
ipfs daemon --restart

⚠️ 开放0.0.0.0存在安全风险，建议通过防火墙限制仅允许信任IP访问5001端口，或配置API认证。

2. 验证API端口的连通性 #

• 本地测试：在服务器终端执行curl http://localhost:5001/api/v0/version，确认返回节点版本信息
• 跨环境测试：如果应用运行在Docker或其他隔离环境，检查网络连通性，确保容器能访问宿主的5001端口
• 安全组/防火墙检查：确认服务器的安全组、防火墙规则已放行5001端口（若需远程调用）

3. 核对ipfs-http-client初始化配置 #

客户端必须指定服务器的公网/内网IP，不能用默认的localhost：

const { create } = require('ipfs-http-client');
// 替换为你的服务器IP或域名
const ipfs = create({ url: 'http://x.x.x.x:5001' });

若服务器启用了HTTPS或API密钥认证，需同步配置客户端的协议、认证参数。

4. 检查文件与目录权限 #

• 确保运行ipfs daemon的用户和应用进程用户拥有相同的权限，避免存储目录读写失败
• 检查IPFS默认存储目录~/.ipfs的权限，执行ls -ld ~/.ipfs确认权限设置合理

5. 匹配IPFS节点与客户端版本 #

版本不兼容是常见问题：

• 执行ipfs version查看服务器节点版本
• 执行npm list ipfs-http-client查看本地客户端版本
• 尽量保持两者大版本一致，若差异过大，升级或降级其中一方

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