Farfalle项目局域网部署问题解决方案

问题背景

在Farfalle项目的本地服务器部署过程中，用户经常遇到无法从局域网内其他设备访问搜索功能的问题。这主要涉及Next.js公共API URL的配置问题，以及跨设备访问时的网络设置。

核心问题分析

当用户尝试将Farfalle部署在本地服务器上，并希望为局域网内所有客户端提供搜索服务时，需要特别注意以下配置项：

1. 环境变量文件(.env)中的API端点配置
2. Docker开发配置文件(docker-compose.dev.yaml)中的服务地址
3. 跨设备访问时的网络连通性

详细解决方案

1. 修改环境变量配置

在项目根目录的.env文件中，需要将以下配置项修改为宿主机的局域网IP地址：

NEXT_PUBLIC_API_URL=http://[宿主IP]:3000/api
SEARXNG_URL=http://[宿主IP]:8080

如果使用远程Ollama服务，同样需要修改对应的Ollama服务地址。

2. 更新Docker开发配置

在docker-compose.dev.yaml文件中，确保所有服务地址都指向宿主机的局域网IP而非localhost或127.0.0.1。特别检查以下服务配置：

services:
  next:
    environment:
      - NEXT_PUBLIC_API_URL=http://[宿主IP]:3000/api
      - SEARXNG_URL=http://[宿主IP]:8080

3. 网络连通性验证

完成上述配置后，需要验证：

1. 宿主机防火墙是否放行了相关端口(通常是3000和8080)
2. 局域网内设备能否ping通宿主机IP
3. 容器网络模式是否正确配置(建议使用bridge模式)

常见错误排查

如果在配置后出现500错误，请检查：

1. 所有配置文件中的IP地址是否一致
2. 服务是否全部正常启动
3. 端口是否有冲突
4. 容器日志是否有报错信息

最佳实践建议

1. 使用固定局域网IP地址而非DHCP分配的地址，避免IP变化导致服务中断
2. 在开发环境中，可以考虑使用docker-compose的host网络模式简化网络配置
3. 对于生产环境，建议配置反向代理和HTTPS加密
4. 定期检查容器日志，监控服务健康状况

通过以上配置调整，Farfalle项目可以顺利在局域网环境中部署，并为所有客户端提供稳定的搜索服务。