Peergos项目自托管配置解析：解决IPFS端口冲突问题

项目背景

Peergos是一个基于IPFS的去中心化加密存储系统，它通过区块链技术和端到端加密实现了用户数据的完全自主控制。在自托管部署过程中，系统会默认启动内置的IPFS节点，这可能导致与现有IPFS节点的端口冲突。

核心问题分析

当用户尝试在已运行标准IPFS节点的服务器上部署Peergos时，常见的"Address already in use"错误通常源于以下两个原因：

1. API端口冲突：Peergos默认使用5001端口作为IPFS API端口
2. 网关端口冲突：系统默认的8080网关端口可能被占用

解决方案详解

自定义端口配置

通过命令行参数可以指定Peergos使用非标准端口：

java -jar Peergos.jar daemon \
    -ipfs-api-address /ip4/127.0.0.1/tcp/6001 \
    -ipfs-gateway-address /ip4/127.0.0.1/tcp/9081 \
    -ipfs-swarm-port 7001

参数说明：

• -ipfs-api-address：设置IPFS API监听地址和端口
• -ipfs-gateway-address：配置HTTP网关地址
• -ipfs-swarm-port：指定节点间通信端口

技术要点说明

1. 内置IPFS节点：Peergos使用经过深度定制的IPFS实现，不能与标准IPFS节点共享端口
2. 端口分配原则：建议选择1024-65535范围内的非特权端口
3. 防火墙配置：确保所选端口在防火墙规则中开放

最佳实践建议

1. 生产环境部署前，建议先进行端口扫描确认端口可用性
2. 对于长期运行的实例，建议将端口配置写入启动脚本
3. 多节点部署时，应规划好端口分配方案避免冲突

常见问题排查

若配置后仍出现端口冲突：

1. 检查是否有残留的Peergos进程：ps aux | grep Peergos
2. 验证端口占用情况：netstat -tulnp | grep <端口号>
3. 确保之前的Peergos实例已完全停止

通过合理配置端口参数，用户可以顺利实现Peergos与现有服务的共存部署，充分发挥其去中心化存储的优势。