Lazy loaded image
进阶教程
🤖在 Unraid 上打造专属 AI 助手:Open WebUI + DeepSeek + 联网功能
字数 7517阅读时长 19 分钟
2025-2-16
2025-2-22
type
status
date
slug
summary
tags
category
icon
password
由于近期 DeepSeek 的火热程度太高,巨大的流量造成了 DeepSeek 官方服务的不稳定性,尤其是联网功能的频繁失效,很多时候官方的联网功能都会出现服务器繁忙的情况。为此,本教程将手把手教你如何在 Unraid 系统上部署 Open WebUI,结合火山引擎的 DeepSeek API,同时利用 Open WebUI 具备的联网功能,实现在本地 Unraid 系统上搭建可联网搜索的专属 DeepSeek AI 助手,最终效果如下:
具备联网搜索功能
具备联网搜索功能
本文不涉及本地大模型部署,博主认为目前对于大多数用户来说没有必要。一方面家用显卡设备往往无法支撑得了满血的大模型,例如 DeepSeek R1 ;另一方面就算是部署小一点的模型,例如蒸馏版的 DeepSeek R1,其整体效果上也要比满血版要差不少。
因此,综合来说,除非是有特定的目的需要在本地部署大模型之外,一般用户通过调用各家平台的 API 去使用大模型是当下最优选(况且现在各平台都在拉拢新用户,给了我们很多白嫖和体验的机会)。

1. 火山引擎后台配置

火山引擎是字节旗下的云和 AI 服务平台,就我综合使用下来的体验,火山引擎的 DeepSeek R1 回复率、速度和延迟方面的表现都很出色。加上近期新注册用户就送 500 万的 Token(通过邀请链接还可以再获得约 375 万 Token,详见下文),无论是白嫖还是充钱,都比较推荐大家去使用体验。

1.1 创建 DeepSeek R1/V3 接入点并获取调用 API 所需信息

1️⃣ 注册火山引擎账号
如果大家不介意的话,可以通过博主的 👉邀请链接 进行注册,注册后可白嫖 1 张 15 元代金券,约可抵扣 375 万 R1 模型 tokens 。
首先,点击火山引擎的登录界面注册一个账号(有抖音或头条之类的字节系产品账号,可以直接扫扫码登录):
notion image
2️⃣ 创建 DeepSeek R1/V3 接入点
💡 补充:除了接入 DeepSeek R1,建议大家再接入 DeepSeek V3 模型,方法与 R1 接入点一样。
notion image
notion image
notion image
notion image
完成接入:
notion image
在模型广场中找到 DeepSeek-R1 模型,点击 查看详情
notion image
点击 推理
notion image
由于尚未开通此模型,因此先点击 立即开通
notion image
然后实名认证:
建议可通过微信/抖音 APP 扫脸认证
建议可通过微信/抖音 APP 扫脸认证
认证完成后,把所有可选的 DeepSeek 模型勾选开通:
notion image
开通过程不会收费,“后付费“的意思是用多少给多少
开通过程不会收费,“后付费“的意思是用多少给多少
notion image
回到刚刚的接入点界面,此时已经可以点击确认接入:
notion image
notion image
3️⃣ 获取大模型 API Key、模型 ID 及 API 调用地址
这里以获取 R1 的 API Key、模型 ID 及 API 调用地址为例,V3 的获取过程也是一样的,不再赘述。
点击 R1 的接入点名称,进入详细配置界面:
notion image
点击 API调用 标签卡,然后把图片中的 模型ID 以及 API 调用地址 复制下来:
notion image
接下来创建 API 密钥:
notion image
notion image
notion image
把 API Key 复制下来:
notion image
至此,我们分别获得了 R1 的 API Key、模型 ID 以及调用地址,后续我们就可以把这些参数添加到 Open WebUI 中进行调用:
  • API Key
    • 模型 ID :
      • API 调用地址:

        1.2 创建具备联网功能的应用并获取调用 API 所需信息

        火山引擎比较优秀的一个点是,可以为大模型配备联网插件计费说明),创建了联网插件之后就可以为 DeepSeek R1 或 V3 模型赋能联网的能力。
        1️⃣ 创建可联网的 R1 应用
        在 DeepSeek R1 的接入点配置中,点击 关联应用 并创建一个应用:
        notion image
        选择 零代码 并创建:
        notion image
        notion image
        在应用创建界面,输入好名称以及选择 R1 的接入点,随后开通联网插件的功能:
        notion image
        notion image
        notion image
        回到应用的编辑界面,此时可以开启联网功能,我们选择 搜索引擎 一项即可:
        notion image
        2️⃣ 配置联网插件
        高级配置 中,可以配置关于联网插件的一些功能,我的个人配置如下:
        notion image
        • 智能改写:智能改写的作用是结合用户的上下文语境对用户的提问进行改写,如下图所示。
          • notion image
        • 调用方式:我这里选择 强制开启 ,代表只要调用了这个应用进行提问,那么会强制大模型使用联网搜索得到的资料进行回答。根据我自己的使用场景,我不希望在我需要联网搜索的情况下出现没有联网的情况,所以我在这里选了强制开启,保证大模型能够参考互联网的搜索资料进行回答。读者可以根据自身的具体场景进行选择。
        • 参考资料回复:这里我个人习惯选择 参考遵循 ,因为 R1 的推理能力非常强大,即使联网功能失败或无准确内容时,R1 也基本不会凭空胡说八道。读者可以根据实际情况进行调整。
        当你配置好各项应用的参数之后,点击右上角的 发布 完成应用的创建:
        notion image
        发布之后,读者可以在右边的聊天框中进行对话,测试联网功能的效果。
        3️⃣ 获取应用的模型 ID 以及 API 调用地址
        应用发布之后,同样的,我们获取此应用的模型 ID 以及 API 调用地址
        复制模型 ID
        复制模型 ID
        点击 API 调用指南,获取 API 调用地址:
        notion image
        notion image
        • 模型 ID:
          • API 调用地址:
            由于 API Key 是通用的,我们不需要为应用另外配置 API Key,但是如果你希望分开用的话,也可以另外再创建一个 API Key。
            ⚠️ 关于联网插件的信息补充:提问的表达方式会影响联网插件的搜索结果。
            经过博主的测试,提问的表达方式会影响联网插件的搜索结果,比如假设博主通过以下内容提问:
            那么联网插件会搜不到相关的资料,进而让 R1 无法给出我想要的答案:
            联网没有搜索到此问题的相关内容
            联网没有搜索到此问题的相关内容
            但如果说我换一种表达方式,此时联网插件就可以搜索出相关的资料,进而让 R1 给出我想要的答案:
            R1 推理过程
            notion image
            可以看到如果通过“哪吒2当前的票房是多少”此问题进行提问,联网插件可以搜索到相关的信息提供给 R1 进行解答,进而让 R1 回答出我希望得到的内容。
            为了进一步了解火山引擎在开启了联网插件的情况下,是如何给 R1 写提示词的,我通过以下方式获取到了提示词的原始模板,以供大家参考:
            notion image
            推理过程
            获取到的提示词模板

            2. 安装与配置 Open WebUI

            Open WebUI 是一个可扩展、功能丰富且用户友好的自托管 Web 界面,设计为完全离线运行。它支持多种大型语言模型(LLM)运行器,包括 Ollama 和与 OpenAI 兼容的 API。Open WebUI 提供了无缝的安装体验,可以通过 Docker 或 Kubernetes 进行部署,并支持与 Ollama 和 CUDA 标签镜像的集成。此外,它还能够轻松集成 OpenAI 兼容的 API,实现与硅基流动、火山引擎(字节)或其他诸多平台的连接,方便调用外部的大模型应用。
            Open WebUI 可以直接通过 Unraid 的应用市场进行安装:
            notion image
            1️⃣ Unraid 安装 Open WebUI
            由于本文不涉及大模型的本地部署,因此不需要更改原安装模版中的相关变量参数,可以直接点击“应用”进行安装即可:
            如果端口冲突了,记得改一下 WebUI 这一项设置中的端口号,例如把 8080 修改为 8087
            notion image
            Docker 镜像体积较大(1G 多),最好能让 Unraid 走代理去拉取镜像:
            notion image
            安装完成后,稍等片刻,待日志中出现以下提示,即表示初始化完成可通过浏览器访问:
            notion image
            2️⃣ 创建账号、配置界面语言以及主题
            notion image
            进入 WebUI 界面:
            点击 Get Started 初始化
            点击 Get Started 初始化
            分别输入昵称、邮箱和密码创建管理员账号
            分别输入昵称、邮箱和密码创建管理员账号
            notion image
            完成初始化
            完成初始化
            notion image
            我个人习惯用浅色的主题
            我个人习惯用浅色的主题
            notion image
            3️⃣ 添加火山引擎的 DeepSeek 模型(R1、V3 及可联网 R1 模型)
            在前面关于火山引擎的后台配置中,我们已经完成了以下三个 DeepSeek 大模型的创建,并获取了他们对应的模型 ID 、调用地址和通用的 API Key :
            DeepSeek R1(非联网版本)
            • API Key
              • 模型 ID :
                • API 调用地址:
                  DeepSeek V3
                  模型 ID 、调用地址和通用的 API Key 获取方式与 R1 的一致,不清楚的请再重复观看上面的教程。
                  DeepSeek R1 可联网应用
                  • 模型 ID:
                    • API 调用地址:
                      接下来,我们将分别一一将上述三个大模型的调用信息配置到 Open WebUI 中。
                      1️⃣ 添加 DeepSeek R1(非联网版本)
                      由于 R1 是推理型模型,Open WebUI 的默认添加方式添加 R1 模型无法显示思维链内容,因此我们需要借助 Open WebUI 中的函数功能,配合热心网友所提供的函数 Linux.do - openwebui 显示 R1 思维链 [更新硅基流动支持][支持火山引擎][支持腾讯云] 来添加大模并显示 R1 的思维链,具体操作如下:
                      进入管理员面板:
                      notion image
                      新建一个函数:
                      notion image
                      显示 DeepSeek R1 思维链的代码复制到函数文本框中:
                      如果你无法打开网页,可以拷贝这里的代码
                      notion image
                      notion image
                      1. 填写函数名称(随意):DeepSeek R1 ToC
                      1. 输入函数的描述信息(随意):在OpwenWebUI中显示DeepSeek R1模型的思维链
                      1. 最后点击 保存
                      notion image
                      确认后,点击⚙️小齿轮:
                      notion image
                      分别点击 默认 按钮:
                      notion image
                      然后填写火山引擎的调用 DeepSeek R1 的调用地址、API Key 以及模型 ID :
                      notion image
                      点击保存之后会提示 Values Updated successfully
                      notion image
                      然后关闭参数配置窗口,打开右上角的开启按钮:
                      notion image
                      开启之后,函数会自动帮在 设置 - 模型 创建对应的模型:
                      notion image
                      我们可以对模型的名字进行修改,让看起来更舒服一些:
                      notion image
                      配置模型的名称、描述(非必需)和 Logo 图片(非必需):
                      DeepSeek 的 Logo 图片点击这里获取。
                      notion image
                      根据 DeepSeek 官方的建议,把模型的温度设置为 0.6
                      notion image
                      最后保存并更新:
                      notion image
                      notion image
                      新建一个对话,测试新添加的模型:
                      notion image
                      如果配置正确,那么效果如下:
                      notion image
                       
                      2️⃣ 添加 DeepSeek V3
                      由于 DeepSeek V3 并没有推理功能,因此我们不需要按照前面通过函数创建的方式去添加此模型,具体操作步骤如下:
                      notion image
                      进入“设置 - 外部链接“,由于我们并不会使用本地大模型,因此先把 Ollama API 关闭:
                      notion image
                      编辑默认已有的连接配置,将其更改为火山引擎的配置:
                      notion image
                      notion image
                      1. URL:填写 V3 的调用链接,实际上是统一的,配置 R1 时也是一样的地址;
                      1. 密钥:即火山引擎的 API Key;
                      1. 模型 ID:即 V3 的模型 ID,输入后点击右边的 + 号按钮进行添加。
                      最后点击保存:
                      notion image
                      配置完成:
                      notion image
                      在模型设置中可以看到新添加的 V3 模型:
                      notion image
                      我们可以对模型的名称、描述(非必需)和 Logo 图片(非必需)进行修改:
                      notion image
                      根据 DeepSeek 官方的建议,把模型的温度设置为 0.6
                      notion image
                      最后保存并更新:
                      notion image
                      notion image
                      3️⃣ 添加 DeepSeek R1 可联网应用
                      由于 R1 是推理型模型,Open WebUI 的默认添加方式添加 R1 模型无法显示思维链内容,因此我们需要借助 Open WebUI 中的函数功能,配合热心网友所提供的函数 Linux.do - openwebui 显示 R1 思维链 [更新硅基流动支持][支持火山引擎][支持腾讯云] 来添加大模并显示 R1 的思维链,具体操作如下:
                      进入管理员面板:
                      notion image
                      新建一个函数:
                      notion image
                      显示 DeepSeek R1 思维链的代码复制到函数文本框中:
                      如果你无法打开网页,可以拷贝这里的代码
                      notion image
                      notion image
                      1. 填写函数名称(随意):DeepSeek R1 WebSearch ToC
                      1. 输入函数的描述信息(随意):在OpwenWebUI中显示DeepSeek R1模型的思维链
                      1. 最后点击 保存
                      notion image
                      确认后,点击⚙️小齿轮:
                      notion image
                      分别点击 默认 按钮:
                      notion image
                      然后填写火山引擎的调用 DeepSeek R1 的调用地址、API Key 以及模型 ID :
                      应用模型的模型 ID 在开头会带 bot 关键词
                      应用模型的模型 ID 在开头会带 bot 关键词
                      点击保存之后会提示 Values Updated successfully
                      notion image
                      然后关闭参数配置窗口,打开右上角的开启按钮:
                      notion image
                      开启之后,函数会自动帮在 设置 - 模型 创建对应的模型:
                      notion image
                      我们可以对模型的名字进行修改,让看起来更舒服一些:
                      notion image
                      配置模型的名称、描述(非必需)和 Logo 图片(非必需):
                      DeepSeek 的 Logo 图片点击这里获取。
                      notion image
                      根据 DeepSeek 官方的建议,把模型的温度设置为 0.6
                      notion image
                      最后保存并更新:
                      notion image
                      新建一个对话,测试新添加的模型:
                      notion image
                      选择可联网的 R1 模型:
                      notion image
                      联网模型测试正常:
                      notion image

                      3. 使用 Open WebUI 的联网功能

                      前面我们通过使用火山引擎的可联网应用,实现了可联网 DeepSeek R1 模型的调用,这种方式不需要借助 Open WebUI 或第三方的联网功能,通过火山平台自身即可实现联网。但经过博主的一些测试和使用,整体效果不是很理想,你会发现有时间联网插件压根就没有进行联网搜索,自然也就无法提供资料给到大模型进行回答。
                      因此,博主建议大家可以通过 Open WebUI 的联网功能来实现联网。

                      2.1 简单直接且免费:duckduckgo 搜索

                      DuckDuckGo 是一个以隐私保护为核心的搜索引擎,由 Gabriel Weinberg 于 2008 年创立,致力于为用户提供安全、透明的搜索体验。它不会追踪用户的搜索历史、IP 地址或个人信息,也不推送个性化广告,所有搜索请求均通过 HTTPS 加密传输,确保隐私安全。
                      Open WebUI 里面可以调用免费的 duckduckgo 搜索引擎,并且无需配置 API 等参数,较为简单直接,不过在中文资料方面稍差一些,大家也可以对比着体验一下:
                      notion image
                      配置好之后,在聊天界面激活 联网搜索 即可:
                      notion image
                      但从结果上看,搜索的质量相对要差一些,但总体也还可以:
                      notion image

                      2.2 收费但效果好:博查(Bochaai)

                      另外,如果对搜索质量要更高要求,也可以尝试博查(Bochaai)的搜索 API (📑官方文档):
                      博查是一个给 AI 用的搜索引擎,其搜索数据经过专门的处理以方便 AI 大模型使用,可通过 API 调用获取搜索结果。
                      notion image
                      最新的 Open WebUI 中已集成博查 API 功能,在博查后台获取到 API Key 后,即可在 Open WebUI 中配置:
                      创建 API Key
                      创建 API Key
                      配置博查 API Key 参数
                      配置博查 API Key 参数
                      为了对比效果,分别使用博查和 duckduckgo 进行联网搜索,结果如下:
                      duckduckgo
                      duckduckgo
                      博查
                      博查
                      可以看到,博查的联网搜索质量更高,在中文资料上的收录上时效性更强,如果考虑付费提升联网搜索的体验,那么博查是个不错的选择。

                      3.3 其他 AI 联网搜索提供商

                      另外,大家也可以考虑使用 Tavily,注册后每个月免费提供 1000 API 点数(每一次搜索会根据一定的规则计算所消耗的点数,参考这里的 API Credits 官方文档),在英文资料的搜索上效果也不错,并且支持银联卡。
                      notion image
                      除了上述两种搜索引擎之外,Open WebUI 还支持 google 和 bing 这两家目前主流的搜索引擎 API (目前还没集成百度),以及其他更多的、专门针对大模型联网搜索的服务提供商。
                      如果大家有更好的建议,欢迎评论区留言。

                      4. Page Assist:另一种性价比更高的联网方式

                      🚧 正在施工 …

                      5. 常见问题

                      Q:联网搜索出现 Error Searching 问题

                      A:在 “管理员面板 → 设置界面 → 外部模型 ” 中选择一个不是通过函数添加的模型,例如 DeepSeek V3 模型。
                      notion image
                      notion image
                      上一篇
                      Unraid 7.0.1 版本更新说明
                      下一篇
                      iKuai 下的 iStore 虚拟机存储扩容

                      评论
                      Loading...