Linux Ollama服务配置|常用环境变量参数详解教程

文章会先带你搞懂这些参数到底是干嘛的——比如想改API端口怎么设OLLAMA_HOST，怕别人乱访问怎么用OLLAMA_ORIGINS控制跨域，GPU内存不够用又该怎么调OLLAMA_GPU。从网络配置、资源分配到模型缓存路径、日志输出，每个参数的作用和填多少合适都会讲清楚。

然后是实操环节，不管你是想临时测试参数（终端输一行命令就行），还是想让配置重启后也生效（改profile文件或systemd服务），这里都有 step-by-step 的教程。我还会拿几个常见场景举例子，比如怎么把模型缓存挪到更大的硬盘分区，或者用环境变量让Ollama默认加载你常用的模型，不用每次手动敲命令。

如果你之前配置时踩过坑，或者刚接触Ollama不知道从哪下手，跟着这篇走，保管你半小时内把环境变量配明白，让本地大模型跑起来又稳又快。

改完OLLAMA_HOST端口后，你可以分两步来验证端口到底开没开、能不能访问。先从本地测试开始，打开终端输一行命令：curl http://localhost:[新端口]/api/tags，记得把方括号里的[新端口]换成你刚设的数字，比如你改成了11436，就输curl http://localhost:11436/api/tags。如果终端返回一串带模型名称、版本号的JSON数据，说明本地端口已经通了；要是提示“connection refused”或者“无法连接”，那就是配置没生效，得回头检查环境变量是不是真的保存对了。

本地通了之后，要是想让其他设备也能访问这个Ollama服务，还得做远程测试。先确保服务器的防火墙放行了这个端口，比如用ufw防火墙的话，就输sudo ufw allow [新端口]/tcp，比如开放11436端口就是sudo ufw allow 11436/tcp。然后在另一台电脑或者手机上打开浏览器，输入http://[服务器IP]:[新端口]，比如服务器IP是192.168.1.100，端口11436，就访问http://192.168.1.100:11436。如果能看到Ollama的Web界面（得是Ollama 0.1.26以上版本才支持Web UI），说明远程访问也没问题了。

要是试了上面的方法还是连不上，先看看端口是不是被别的程序占了。终端输netstat -tuln | grep [新端口]，比如查11436端口就输netstat -tuln | grep 11436，如果显示有进程占用，要么换个端口，要么把占用的进程停掉。另外别忘了检查OLLAMA_HOST的配置，正确格式应该是OLLAMA_HOST=0.0.0.0:[端口]，前面的0.0.0.0表示允许所有IP访问，要是写成127.0.0.1:[端口]，就只能本地访问，远程肯定连不上，这点新手很容易踩坑。

配置环境变量后Ollama服务仍未生效，可能是什么原因？

可能是配置方式与启动方式不匹配。如果通过终端临时设置环境变量（如 export OLLAMA_HOST=0.0.0.0:11435），仅对当前终端会话有效，关闭终端或通过systemd服务启动时会失效。若需永久生效，需将变量写入 /etc/profile 或 ~/.bashrc 并执行 source 命令，或在systemd服务文件（如 /etc/systemd/system/ollama.service）的 [Service] 段添加 Environment 配置，修改后需运行 systemctl daemon-reload 重载配置。

如何查看当前Ollama服务正在使用的环境变量参数？

可通过查看Ollama进程的环境变量信息确认。在终端执行 ps aux | grep ollama 获取Ollama进程ID（PID），然后运行 cat /proc/[PID]/environ | tr '' 'n' | grep OLLAMA，即可列出当前生效的所有Ollama相关环境变量。若未显示目标变量，说明配置未成功加载，需重新检查配置文件或启动命令。

设置OLLAMA_GPU参数后GPU资源仍未被调用，可能是什么问题？

首先确认系统已安装GPU驱动和兼容的CUDA环境（NVIDIA用户需确保nvidia-smi命令可正常输出），Ollama默认优先使用GPU，但部分旧版或低配GPU可能不被支持。若驱动正常，可尝试指定具体GPU设备，如 OLLAMA_GPU=0（0为GPU设备索引，多GPU时可指定0-1等范围），或降低GPU内存占用限制（如 OLLAMA_GPU_MEMORY=8gb，根据显卡实际显存调整）。 部分模型（如7b以下小模型）可能默认使用CPU，可尝试加载13b及以上模型测试GPU调用情况。

能否同时配置多个环境变量？如何避免参数冲突？

可以同时配置多个环境变量，临时生效可在终端用空格分隔多个 export 命令，如 export OLLAMA_HOST=0.0.0.0:11435 OLLAMA_ORIGINS=https://example.com；永久配置时，在profile文件或systemd服务中按行或空格分隔添加即可。参数冲突主要需注意同类配置，例如同时在终端临时设置和systemd服务中定义同一变量，以启动时实际加载的配置为准（systemd服务配置优先级高于终端临时变量，但低于启动命令显式指定的参数）。 通过单一方式管理环境变量，并记录配置位置避免重复定义导致混乱。

修改OLLAMA_HOST端口后，如何验证端口是否已成功开放并可访问？

可通过本地和远程两种方式验证端口连通性: 本地测试执行 curl http://localhost:[新端口]/api/tags (替换[新端口]为设置的端口号)，若返回模型列表JSON则说明端口开放成功; 远程测试需确保服务器防火墙允许该端口(如 ufw allow [新端口]/tcp)并在另一设备浏览器访问 http://[服务器IP]:[新端口] Ollama Web UI界面(需Ollama 0.1.26以上版本支持Web UI)。若提示连接超时,检查端口是否被其他服务占用( netstat -tuln | grep [新端口] )或OLLAMA_HOST配置是否包含对外IP( 设为 0:0.0:0:[端口]允许任意IP访问)。

YUANLEISVIP

收藏 链接