Linux快速部署大语言模型LLaMa3，Web可视化j交互（Ollama+Open Web UI）

本文在个人博客同步发布，前往阅读

1 介绍

本文将介绍使用开源工具Ollama(60.6k⭐)部署LLaMa大模型，以及使用Open WebUI搭建前端Web交互界面的方法。

我们先来过一遍几个相关的概念，对这块比较熟悉的朋友可跳过。

1.1 大规模语言模型

大规模语言模型（Large Language Models, LLMs），顾名思义是指在大量语料数据的基础上训练成的模型，能够模拟人类的语言风格生成较为生动的文本。这类模型的主要特征有：

• 规模大：训练所使用的数据量非常庞大，有时超过1000亿个参数。
• 复杂性高：模型结构比较复杂
• 具有较好的上下文理解能力：大规模语言模型可以理解文本的上下文和细微差别

  1.2 LLaMa

  LLaMA是一种大规模语言模型，由Meta AI基于Transformer深度学习框架开发。该模型旨在生成各种风格的高质量文本（例如创意写作、对话甚至诗歌），能够胜任以下工作：

  • 自然语言处理（NLP）：理解和生成自然语言。
  • 机器学习：根据数据和算法学习新的信息和技能。
  • 对话生成：可以与用户进行对话，并根据情况生成合适的回应。

    1.3 Ollama

    官网：Ollama

    API文档：ollama/docs/api.md at main · ollama/ollama (github.com)

    支持的模型列表：library

    一款可以快速部署大模型的工具。

    1.4 Open WebUI

    官网：Open WebUI

    相关介绍及源码：open-webui/open-webui: User-friendly WebUI for LLMs (Formerly Ollama WebUI) (github.com)

    Open WebUI 是一个可视化的Web交互环境，它拥有清新简约的UI风格，具有可扩展、功能丰富、用户友好、自托管的特点，可以完全离线运行。它支持各种 LLM 运行程序，包括 Ollama 和 OpenAI 兼容的 API。

    2 部署LLM服务

    本文介绍的方法使用于Linux系统，同样适用于Windows系统的WSL（安装方法可参见我的这篇文章）。

    2.1 部署Ollama

    1、下载Ollama

    Linux系统的安装命令如下：

    curl -fsSL https://ollama.com/install.sh | sh
    

    ※此外官方还提供了macOS和Windows的下载方式。

    2、下载llama3模型

    ollama run llama3
    

    ※在这里可以看到该命令的相关介绍。

    上述命令将自动拉取模型，并进行sha256验签。处理完毕后自动进入llama3的运行环境，可以使用中文或英文进行提问，ctrl+D退出。

    3、配置服务

    为使外网环境能够访问到服务，需要对HOST进行配置。

    打开配置文件：vim /etc/systemd/system/ollama.service，根据情况修改变量Environment：

    • 服务器环境下：Environment="OLLAMA_HOST=0.0.0.0:11434"
    • 虚拟机环境下：Environment="OLLAMA_HOST=服务器内网IP地址:11434"

      3、启动服务

      启动服务的命令：ollama serve

      首次启动可能会出现以下两个提示：

      Couldn’t find ‘/home/用户名/.ollama/id_ed25519’. Generating new private key.

      该提示表示文件系统中不存在ssh私钥文件，此时命令将自动帮我们生成该文件，并在命令行中打印相应的公钥。

      Error: listen tcp 127.0.0.1:11434: bind: address already in use

      看到该提示，大概率服务已在运行中，可以通过netstat -tulpn | grep 11434命令进行确认。

      • 若命令输出的最后一列包含“ollama”字样，则表示服务已启动，无需做额外处理。
      • 否则，可尝试执行下列命令重启ollama：

        # ubuntu/debian
        sudo apt update
        sudo apt install lsof
        stop ollama
        lsof -i :11434
        kill 
        ollama serve
        # centos
        sudo yum update
        sudo yum install lsof
        stop ollama
        lsof -i :11434
        kill 
        ollama serve
        

        如果您使用的是MacOS，可在🔗这里找到解决方法。

        4、在外网环境验证连接

        方法一：执行curl http://ip:11434命令，若返回“Ollama is running”，则表示连接正常。

        方法二：在浏览器访问http://ip:11434，若页面显示文本“Ollama is running”，则表示连接正常。

        2.2 Ollama常用命令

        1、进入llama3运行环境：ollama run llama3

        2、启动服务：ollama serve

        3、重启ollama

        systemctl daemon-reload
        systemctl restart ollama
        

        4、重启ollama服务

        # ubuntu/debian
        sudo apt update
        sudo apt install lsof
        stop ollama
        lsof -i :11434
        kill 
        ollama serve
        # centos
        sudo yum update
        sudo yum install lsof
        stop ollama
        lsof -i :11434
        kill 
        ollama serve
        

        5、确认服务端口状态：netstat -tulpn | grep 11434

        3 部署Open WebUI

        1、下载Open WebUI

        Open WebUI基于docker部署，docker的安装方法可以参考这篇知乎文章。

        Open WebUI既可以部署在服务端，也可以部署在客户端：

        # 若部署在客户端，执行：
        docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main
        # 若部署在服务端，执行：
        docker run -d -p 3000:8080 -e OLLAMA_BASE_URL=https://example.com -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main
        

        如果您的机器在国内，建议将--restart的参数值替换为ghcr.nju.edu.cn/open-webui/open-webui:main，下载速度会快非常多（见up主小杨生存日记的这篇文章）。

        2、检查相关配置

        下载完之后，就可以在浏览器访问了，地址为http://loacalhost:3000（客户端部署）或http://服务器ip:3000。

        页面加载完成后（这个过程可能需要一些时间），新注册一个账号并登录。

        登录之后，点击页面顶端的齿轮⚙图标进入设置：

        1. 侧边导航栏-General，将语言设置为中文
        2. 侧边导航栏-连接，若“Ollama 基础 URL”这一项为http://host.docker.internal:11434，则表示ollama服务正常且连接成功；如果是空的，则需要回头检查一下ollama服务了
        3. 侧边导航栏-模型，一般会自动拉取ollama服务上部署好的模型，可选模型参看官方的这篇文档
        4. 其它的项目根据需要设置即可

        3、选择模型

        在顶端下拉框选择好模型，就可以开始提问啦！

        

        参考文章

        • macOS + Ollama + Enchanted，本地部署最新 Llama3 - 掘金 (juejin.cn)
        • 服务器部署开源大模型完整教程 Ollama+Gemma+open-webui - 哔哩哔哩 (bilibili.com)
        • Ollama管理本地开源大模型，用Open WebUI访问Ollama接口 - 知乎 (zhihu.com)