Ollama项目：如何自定义客户端连接端口配置

在使用Ollama项目时，开发者可能会遇到需要修改服务端口的情况。当服务端口被修改后，本地执行ollama run命令时会出现连接失败的错误提示。这是因为客户端默认会尝试连接标准端口，而不知道服务已经运行在其他端口上。

端口配置的核心原理

Ollama客户端与服务端通信时，默认使用预设的连接配置。当服务端端口被修改后，客户端需要明确知道新的连接端点才能建立通信。这与许多客户端-服务器架构的应用类似，都需要保持两端配置的一致性。

解决方案：环境变量配置

Ollama提供了通过环境变量OLLAMA_HOST来指定连接端点的功能。这个环境变量可以包含主机名和端口号，格式为host:port。设置这个变量后，客户端会自动使用指定的连接参数，而不再使用默认配置。

具体实施步骤

1. 确定服务端运行端口：首先确认Ollama服务实际监听的端口号
2. 设置环境变量：
   • 在Linux/macOS系统中，可以在终端执行：

     export OLLAMA_HOST=127.0.0.1:自定义端口号
     

   • 在Windows系统中，可以通过命令提示符执行：

     set OLLAMA_HOST=127.0.0.1:自定义端口号
     

3. 验证配置：执行ollama run命令测试连接是否正常

持久化配置建议

为了使配置在系统重启后仍然有效，建议将环境变量设置添加到系统配置文件中：

• Linux/macOS：添加到~/.bashrc或~/.zshrc文件
• Windows：通过系统属性中的环境变量设置进行永久配置

故障排查技巧

如果设置后仍然无法连接，可以检查：

• 服务是否确实运行在指定端口
• 防火墙是否允许该端口的通信
• 环境变量是否设置正确（可通过echo $OLLAMA_HOST或Windows的echo %OLLAMA_HOST%验证）

通过正确配置OLLAMA_HOST环境变量，开发者可以灵活地管理Ollama客户端与服务的连接方式，满足各种定制化部署需求。