Ollama-UI 使用教程:1 条命令在浏览器里对话本地大模型
【免费下载链接】ollama-uiSimple HTML UI for Ollama项目地址: https://gitcode.com/gh_mirrors/ol/ollama-ui
你装好了 Ollama,但每次都要在终端里敲 ollama run 这样的命令,参数输错就得重来,聊完的内容也没有地方存。Ollama-UI 就是为了解决这个问题:它给 Ollama 套了一个浏览器网页,你在页面里选模型、打字、看回答,还能把聊天记录存下来反复查看。整个项目只有十几个静态文件,不需要安装任何依赖。
📌 一句话认识它
Ollama-UI 是一个用纯 HTML、CSS、JavaScript 写的静态网页,没有构建步骤,也没有后端代码,它直接调用 Ollama 官方 API 拉取模型列表、流式接收回答。核心逻辑集中在 chat.js(界面与对话流程)和 api.js(与 Ollama 通信)两个文件里。它适合已经在本机跑起 Ollama、但不想天天碰终端的人。
💬 它能帮你做什么
浏览器里如何切换 Ollama 模型
页面打开后,右上角的 Model 下拉框会自动列出 Ollama 里已下载的全部模型,选哪个就用哪个。切换后模型名会同步写进网址的 ?model= 参数,把这条网址分享给同事,对方打开后默认就是同一个模型。
Ollama-UI 如何保存和找回聊天历史
聊到有价值的内容时,点右上角 Save 按钮,起个名字,这段对话连同上下文、系统提示词和模型一起写进浏览器 localStorage。之后在 History 下拉框里选中名字即可原样恢复,不需要的记录用 Delete 清掉。
如何输入多行提示词并随时停止生成
底部输入框会随内容自动加高(最高 200 像素),贴长提示词不会挡住聊天区。生成过程中 Send 按钮旁会出现一个红色 Stop 按钮,随时可以中断输出;回答结束后还会多出一个复制按钮,整段内容一键拷走。
⚡ 装好并跑起来
一条命令最快启动 Ollama-UI
拿到项目代码后(克隆方法见下一条路径),在项目目录执行:
./run-locally.sh脚本会先下载 Bootstrap、marked、DOMPurify、jQuery 这 4 个依赖库到 resources 目录,然后用 python3 在 127.0.0.1 的 8000 端口起一个静态服务器,浏览器打开 http://localhost:8000 就能用。想换端口就给它传一个数字参数。
手动部署 Ollama-UI 的 4 个步骤
- 克隆仓库:
git clone https://gitcode.com/gh_mirrors/ol/ollama-ui- 进入目录并执行 make:
cd ollama-ui && makemake 会下载依赖库、用 SHA-256 校验文件完整性,然后同时拉起静态服务器和 ollama serve(要求本机已安装 Ollama)。 3. 浏览器打开 http://localhost:8000,确认模型下拉框里能列出你的模型。
🖱️ 第一次上手体验
- 打开页面先看右上角:Hostname 输入框默认填了 Ollama 的默认地址 http://localhost:11434,Model 下拉框已列好模型,System Prompt 一栏可以填一句"你是一个……"来设定角色。
- 在底部输入框敲一句问题,按 Ctrl+Enter(Mac 上是 Cmd+Enter)或点 Send:你的消息立刻出现在聊天区,回答随后逐字流式输出,页面会自动滚动跟到最新内容。
- 回答出完后点复制按钮拷走全文;想留住这次对话就点 Save,起个名字,它随即出现在 History 下拉框里,下次选它就能接着聊。
🎨 改一改,变成自己的
- 改 chat.css:界面的配色、聊天气泡和输入区样式都定义在这里,比如把深色主题调成浅色、改输入框默认高度,保存后刷新页面即生效。
- 改 api.js:开头的默认 Ollama 地址 http://localhost:11434 可以改成你内网的服务器地址,团队共用一台推理机时,每个人打开页面就不用手动填 Hostname 了。
❓ 常见问题
打开页面弹窗提示无法访问 Ollama 服务器怎么办
先确认 Ollama 服务在运行(终端执行 ollama serve),再检查 Hostname 里填的地址是否可达。如果网页是从别的域名或 IP 访问的,Ollama 默认只放行本机来源,需要用 OLLAMA_ORIGINS=你的来源 的方式启动 ollama serve,页面内置的错误弹窗里也写了这条说明。
模型下拉框是空的
说明 Ollama 里还没有模型,先在终端执行 ollama pull 加模型名(比如 llama2:13b)下载一个,完成后刷新页面,下拉框里就会出现。
按回车为什么没有发送
Enter 键在输入框里是用来换行的,发送需要按 Ctrl+Enter 或 Cmd+Enter,这也是多行输入的前提。
如果你已经在本地跑起 Ollama、又不想依赖终端和第三方应用,Ollama-UI 是成本最低的一条路;更完整的启动说明见 README.md。
【免费下载链接】ollama-uiSimple HTML UI for Ollama项目地址: https://gitcode.com/gh_mirrors/ol/ollama-ui
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考