Ollama 服务管理器

Windows 系统托盘 GUI 工具，用于管理本地 Ollama 服务的启动、停止、重启及日志查看。

功能特性

• 服务管理：一键启动/停止/重启 Ollama Serve 服务
• 系统托盘：关闭窗口自动最小化到托盘，右键菜单快捷操作
• 开机自启动：勾选即可注册到 Windows 启动项，静默启动不弹窗
• 日志查看：实时显示 Ollama 服务运行日志，支持右键清空/复制
• 状态监控：通过状态指示灯和 API 检测确认服务是否就绪
• 连接信息提示：显示 Base URL、OpenAI 兼容地址、API Key 说明和常用端点，支持一键复制
• 首次启动自检：启动时自动检测 Ollama，未安装时提示并支持一键下载并运行官方 Windows 安装器
• 单实例保护：防止重复运行，已运行时会弹出提示
• PyInstaller 打包：支持编译为独立 .exe 文件，方便分发

环境要求

• Windows 10 / 11
• Python 3.10+
• 已安装 Ollama，或在首次启动时按提示一键安装

快速开始

# 1. 安装依赖
pip install -r requirements.txt

# 2. 正常启动（显示窗口）
python ollama_gui.py

# 3. 静默启动（仅托盘，不弹窗口）
python ollama_gui.py --hidden

也可双击 start_silent.vbs 实现无控制台窗口的静默启动。

依赖项

包名	版本	用途
pystray	>=0.19.0	系统托盘图标与菜单
Pillow	>=10.0.0	托盘图标绘制

打包为 EXE

pip install pyinstaller
pyinstaller OllamaGUI.spec

打包产物在 dist/OllamaGUI.exe，双击即可运行。

注意事项

• 默认 Ollama 安装路径为 C:\Users\<用户名>\AppData\Local\Programs\Ollama\ollama.exe，如路径不同请修改 ollama_gui.py 中的 OLLAMA_EXE 常量
• 程序会优先从 PATH 查找 ollama.exe，再检查默认安装目录；一键安装会多通道下载官方 OllamaSetup.exe 并启动安装器，自动下载失败时会打开官方下载页
• 本地 Ollama 默认不需要 API Key；使用 OpenAI SDK 兼容接口时可填 ollama 作为占位 Key
• 启动服务前若发现 11434 端口已有 ollama.exe 占用，会先停止旧进程，再由本程序重新启动服务
• 开机自启动写入当前用户注册表 HKCU\Software\Microsoft\Windows\CurrentVersion\Run，通常不需要管理员权限；程序启动时会自动修复旧路径
• 退出应用时会同时停止 Ollama 服务，请确认无正在进行的模型推理
• 静默自启动使用 pythonw.exe，不会弹出控制台窗口

项目结构

ollama后台/
├── ollama_gui.py       # 主程序
├── requirements.txt    # Python 依赖
├── OllamaGUI.spec      # PyInstaller 打包配置
├── install_deps.bat    # 依赖一键安装脚本
├── start_silent.vbs    # 静默启动 VBS 脚本
├── ollama_icon.ico     # 应用图标
└── README.md