Ollama 在不同操作系统下的日志查看方法、LLM 库的选择与强制指定、环境变量的配置以及常见故障的排查方案。内容涵盖 Mac、Linux、Docker 及 Windows 平台的日志获取，CPU 指令集检测，NVIDIA GPU 容器运行时的驱动与权限问题，以及网络端口和模型管理的注意事项。通过系统化的步骤指导，帮助用户快速定位并解决 Ollama 启动失败、模型加载错误及性能异常等问题。
在使用 Ollama 运行本地大语言模型时，可能会遇到各种启动失败、模型加载错误或性能问题。本文详细整理了不同操作系统下的日志查看方法、LLM 库选择、环境配置及常见硬件兼容性问题的排查步骤。
日志是定位 Ollama 问题的首要途径。根据运行环境的不同，日志的获取方式有所差异。
在 macOS 上，可以通过终端命令直接读取服务器日志文件：
cat ~/.ollama/logs/server.log
如果日志文件不存在或为空，建议先尝试重启 Ollama 服务以生成新的日志记录。
对于使用 systemd 管理服务的 Linux 发行版，可以使用 journalctl 命令查看系统级日志：
journalctl -u ollama
若要实时跟踪日志输出，可添加 -f 参数：
journalctl -u ollama -f
当 Ollama 运行在 Docker 容器中时，日志会直接输出到容器的标准输出（stdout）和标准错误（stderr）。
docker ps
docker logs <container-name>
docker logs -f <container-name>
如果在终端中手动运行 ollama serve，日志将直接显示在该终端窗口中。
Windows 上的日志位置较为分散，可通过资源管理器访问以下路径：
Win + R 输入 explorer %LOCALAPPDATA%\Ollama 查看日志。explorer %LOCALAPPDATA%\Programs\Ollama 浏览二进制文件。explorer %HOMEPATH%.ollama 查看模型和配置文件。explorer %TEMP% 查看临时可执行文件。为了更详细的排查信息，可以在 PowerShell 中设置环境变量并启动应用：
$env:OLLAMA_DEBUG="1"
& "ollama app.exe"
这将输出更详尽的调试日志，有助于定位底层错误。
Ollama 内置了多个针对不同 GPU 和 CPU 向量特性编译的大语言模型（LLM）库。系统通常会自动检测并选择最合适的库。如果自动检测失效或出现 GPU 崩溃，可以手动指定。
在服务器日志中，通常会看到类似以下的动态库列表：
Dynamic LLM libraries [rocm_v6 cpu cpu_avx cpu_avx2 cuda_v11 rocm_v5]
可以通过设置 OLLAMA_LLM_LIBRARY 环境变量来绕过自动检测。例如，强制使用 CPU AVX2 库：
OLLAMA_LLM_LIBRARY="cpu_avx2" ollama serve
在 Linux 上，可以通过以下命令查看 CPU 支持的标志位：
cat /proc/cpuinfo | grep flags | head -1
确认是否包含 avx2 等关键字，以决定使用哪个库。
在 Linux 上，如果需要安装旧版本或预发布版本，可以在安装脚本中指定版本号：
curl -fsSL https://ollama.com/install.sh | OLLAMA_VERSION="0.1.29" sh
如果系统的 /tmp 目录被挂载为 noexec（禁止执行），Ollama 可能无法运行临时可执行文件。此时需要设置 OLLAMA_TMPDIR 指向一个可写的用户目录：
export OLLAMA_TMPDIR=/usr/share/ollama/
确保该目录存在且当前用户有写入权限。
Ollama 默认监听 11434 端口。如果遇到连接超时或无法访问的问题，请检查以下内容：
127.0.0.1。如需远程访问，需设置 OLLAMA_HOST=0.0.0.0。https://ollama.com/library。在 Docker 容器中运行 Ollama 时，GPU 初始化失败是常见问题。常见的错误代码包括：
3：未初始化46：设备不可用100：无设备999：未知错误验证容器运行时：
docker run --gpus all ubuntu nvidia-smi
如果此命令不返回 GPU 信息，Ollama 将无法识别显卡。
检查驱动加载： 确保 UVM 驱动已加载：
sudo nvidia-modprobe -u
尝试重新加载驱动：
sudo rmmod nvidia_uvm
sudo modprobe nvidia_uvm
更新驱动：确保使用的是最新的 NVIDIA 驱动程序。
查看详细日志： 设置环境变量以获取更深层的诊断信息：
export CUDA_ERROR_LEVEL=50
ollama serve
系统日志检查： 查看内核日志中是否有相关错误：
dmesg | grep -i nvrm
dmesg | grep -i nvidia
如果模型加载报错，可能是模型文件不完整或损坏。可以尝试删除对应模型后重新拉取：
ollama rm <model-name>
ollama pull <model-name>
如果显存或内存不足，模型可能无法加载。建议：
Ollama 的故障排查主要围绕日志分析、环境配置、硬件兼容性及网络连接展开。大多数问题可以通过查看日志、调整环境变量或更新驱动解决。对于复杂的 GPU 容器问题，建议逐步验证驱动状态和容器运行时配置。保持 Ollama 更新至最新版本也有助于减少已知 Bug 的影响。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online