模型基础部署及项目 11

界面焕新，本地智联为本地AI模型构建现代化Web交互界面高职/本科学生人工智能应用实训智能财经学院课程目录四大核心模块：本次实训·全流程概览目01.项目概述|我们的目标与任务02.知识储备|核心概念与技术解析03.任务实施|环境准备与核心操作04.总结与展望|回顾收获与拓展方向🎯明确实训目标，理解项目背景与价值💻掌握关键技术点，完成实操任务📝沉淀经验方法，具备独立复盘能力学习预期：✨期待大家全情投入，在实践中收获成长！项目概述：我们的目标与任务核心价值预期目标关键任务1.完成图形界面原型设计与开发；

2.实现报修流程与后台逻辑的无缝对接；

3.确保界面交互的流畅性与易用性。构建一个直观、易用的报修图形界面，大幅降低师生操作难度，实现报修信息的快速录入与状态实时追踪，全面提升报修效率。提升用户体验，优化信息流转效率，解决传统纯文本或命令行交互的晦涩难懂问题，实现服务的人性化与智能化升级。项目名称：宿舍报修管家—图形化升级项目背景-告别枯燥的命令行核心维度命令行现状（痛点）本项目目标（改进）交互体验纯文本操作，视觉反馈差，枯燥乏味提供图形化界面，交互直观流畅，体验升级操作与记录缺乏历史会话记录，模型切换流程繁琐完整保留历史对话，支持模型一键快速切换使用门槛需记忆各类指令参数，对非技术用户不友好降低使用门槛，实现“所见即所得”的便捷操作最终价值仅能满足基础功能，难以充分发挥模型潜力为强大的本地AI模型，赋能友好、便捷的交互体验项目总结：回顾过往，我们已成功在本地部署AI模型，但命令行交互的体验短板限制了其易用性。本项目旨在解决操作复杂、无记录、切换难等问题，将强大的模型能力与优秀的产品体验结合，打造更易上手的本地化AI交互方案。项目愿景：项目目标—为本地AI穿上“漂亮外衣”直观的文本问答提供简洁的输入框，实现自然语言交互，让用户能够像与人交流一样轻松提问，获得精准回答。可视化对话历史清晰展示所有对话回合，以结构化方式呈现上下文，方便回顾、检索与管理历史对话记录。便捷的模型管理通过友好的操作界面，支持用户轻松切换不同的本地AI模型，灵活适配多样化的任务需求。学习目标：OpenWebUI与Docker实践知识目标KnowledgeGoals理解Web界面在大模型交互中的优势，掌握OpenWebUI的核心功能模块，了解Docker容器化部署的基本概念与工作原理。能力目标SkillGoals能够独立完成OpenWebUI的Docker环境安装与启动配置；掌握连接本地Ollama服务的方法；熟练使用Web界面进行多轮对话、模型切换及基础管理操作。素养目标LiteracyGoals体会图形化界面（GUI）对提升技术易用性的价值；培养“前端交互+后端服务”结合的系统思维能力；激发探索开源项目与动手实践的技术热情。1243任务一：Docker环境准备与OpenWebUI安装任务二：OpenWebUI连接Ollama与模型管理任务四：体验对比与项目总结任务三：流畅对话与参数调优工作任务单知识储备：核心概念与技术解析Web界面与交互OpenWebUI框架Docker容器化将应用及其依赖环境打包为标准化容器，实现跨环境的快速部署、隔离运行与高效管理，是现代开发与运维的基石。基于FastAPI构建的开源WebUI，专为大模型应用设计，支持多模型接入与功能扩展，能快速搭建高可用的AI交互界面。用户与系统交互的可视化窗口，通过浏览器访问实现操作便捷性，整合前端技术，保障系统易用性与交互体验的统一。核心知识概览|三大关键基石知识储备-核心概念概览WebUIOpenWebUIDocker核心定义：WebUserInterface（网页用户界面），是用户与网站或Web应用程序交互的图形化界面。核心定义：一个功能强大、专为本地部署的大型语言模型（LLM）设计的开源Web界面工具。核心定义：一个开源的应用容器引擎，让开发者可以打包应用及其依赖到一个可移植的容器中，实现快速部署。关键价值：优化用户交互体验，降低使用门槛，直观呈现信息与功能，提升操作效率。关键价值：提供直观、易用的交互界面，便于用户在本地快速体验、调试和使用大模型，无需复杂的命令行操作。关键价值：简化环境配置，消除“在我电脑上能运行”的问题，实现应用在不同平台上的快速、一致部署。本章总结：本章将系统学习三大核心概念：WebUI负责通过图形化的界面优化与用户的交互体验；OpenWebUI作为专为本地大模型设计的开源Web界面工具，是我们落地大模型应用的关键入口；Docker则作为容器化技术，帮助我们轻松解决复杂软件环境的部署难题。掌握这三者，是搭建完整本地AI应用服务的基石。Web界面的革命-从CLI到GUI的体验飞跃01命令行界面(CLI)•操作方式：需要记忆和输入大量复杂指令代码，对用户的技术背景有一定要求。•体验痛点：学习门槛高，交互逻辑抽象，视觉反馈不够直观。02WebUI(图形用户界面)•核心优势：实现了“所见即所得”，通过图形化的按钮、菜单和界面进行操作。•价值所在：操作逻辑直观易懂，视觉反馈丰富，极大降低了技术门槛，让普通大众也能轻松上手。关键结论：体验与普及的双重飞跃从晦涩到直观技术民主化WebUI不仅是界面的变革，

更是让技术走出专业领域，

惠及亿万用户的关键力量。OpenWebUI核心功能(1)-直观的聊天与历史记录功能模块核心能力与特性用户价值与体验对话交互界面提供类ChatGPT风格的对话框

完美支持上下文的多轮对话能力交互逻辑符合用户习惯，上手即会

流畅自然的AI沟通体验，无学习成本历史记录管理系统自动持久化保存所有对话记录

侧边栏清晰列表化展示所有历史会话避免信息丢失，支持随时回顾与查找

方便对过往的问答进行管理和分类功能总结：OpenWebUI致力于打造最接近原生体验的AI交互门户。通过提供直观、熟悉的对话框和完整的历史记录管理功能，不仅让技术门槛降到最低，更确保了用户在与AI协作过程中的信息连续性与管理便捷性，是个人与团队部署私有AI的最佳前端选择。OpenWebUI核心功能(2)-便捷的模型管理与切换功能维度OpenWebUI能力实现用户价值与体验模型选择入口集成Ollama模型选择器统一界面管理，无需记忆命令操作便捷性一键切换、直观管理所有本地模型降低技术门槛，大幅提升操作效率任务适配性按需匹配不同类型的AI能力模型灵活应对问答、代码、创意等多场景数据安全性管理本地已下载的Ollama模型数据本地运行，隐私安全有保障OpenWebUI提供直观的模型选择器，让您无需使用复杂的命令行操作，即可轻松管理Ollama中的所有本地模型。这种“所见即所得”的管理方式，不仅简化了模型切换流程，更让用户能够根据当前的具体任务需求，快速调用最合适的AI模型，极大地提升了工作效率。功能亮点总结：OpenWebUI核心功能(3)-强大的参数调优能力调优参数功能定义调整效果Temperature(温度)控制AI生成文本的随机性与创造性程度的关键指标数值越高，回复越具创意与多样性；

数值越低，回复越确定、严谨、不易跑偏。MaxTokens(最大长度)限制AI在单次对话中生成回复的Token数量上限平衡回答的详细程度与资源消耗；

避免生成过长内容导致的截断或效率问题。TopP(TopProbability)控制AI生成时考虑的候选词概率累积和（核采样）通常与温度配合使用，进一步精细化调节

生成文本的多样性与聚焦度。OpenWebUI允许用户直接在Web界面中调整LLM的各种推理参数，无需复杂的代码配置。通过可视化的方式调节温度、最大Token数等关键参数，用户可以灵活控制AI回复的确定性、详细程度与生成风格，从而精准匹配客服问答、创意写作等不同场景的需求。功能优势：Docker是什么？—软件部署的“集装箱”开源容器化平台·实现软件标准化交付Docker是一个用于开发、发布和运行应用程序的开放平台。它能将应用程序与底层的基础设施隔离开来，从而实现快速交付软件。你可以把它理解为现实中的“集装箱”：无论货物是什么（应用）、用什么船运输（操作系统），都能统一标准、安全无损地送达目的地。它将应用程序及其所有依赖项打包到一个独立的轻量级容器中，保证了从开发到生产环境的一致性，极大地简化了部署与运维流程。Core核心优势📦打包标准化|🚀分发自动化|🛡️运行一致性|⚡轻量高性能告别“在我电脑上能运行”的窘境，让软件开发和交付像搭积木一样简单高效。Docker核心优势环境一致性彻底解决“在我机器上能跑，在你机器上就不能跑”的经典问题。通过将应用及其所有依赖打包在容器内，确保了开发、测试和生产环境的完全一致。部署简便用户只需运行一个简单的dockerrun命令即可快速启动复杂应用。无需关心底层环境配置，大大简化了部署流程，提高了效率。资源隔离与高效容器之间相互隔离，避免了应用间的冲突。与虚拟机相比，容器更轻量、启动更快，能更高效地利用系统资源。OpenWebUI架构揭秘-前后端分离与插件机制核心架构模块前后端分离架构可扩展插件机制功能与交互逻辑前端：轻量级静态网页，负责界面展示与交互

后端：负责与Ollama大模型进行通信，处理业务逻辑提供灵活的扩展接口，支持按需安装与卸载插件

无需修改核心代码即可实现功能更新架构核心优势职责清晰，维护便捷

前后端独立部署，性能与稳定性更优打破功能边界，具备极强的适应性

支持社区生态共建，功能持续丰富用户价值提供流畅、响应迅速的操作体验

降低本地部署与维护的技术门槛打造“可生长”的本地AI助手

随需应变，快速适配各类场景需求OpenWebUI巧妙融合了前后端分离与插件机制两大核心优势：●轻量高效：前后端分离保证了系统的轻量级与高效通信，前端展示与后端逻辑互不干扰。●无限可能：插件机制赋予了本地AI助手“可生长”的能力，如同手机安装App般，随时按需扩展新功能。架构核心价值：任务实施核心目标关键步骤学习要点理解容器化技术的核心优势；掌握Docker基础命令的使用；了解镜像与容器的管理逻辑。1.安装DockerEngine与DockerCompose

2.配置国内镜像源以加速下载

3.执行基础命令，验证环境状态完成Docker环境的完整安装与基础配置，确保后续应用容器能稳定运行。任务实施：环境准备DockerInstallation&Configuration任务一：Docker环境准备与安装关键步骤核心依赖技术执行要点与标准环境与版本检测Windows10/11系统确认Win102004+或Win11；开启CPU虚拟化（BIOS）系统组件启用Hyper-V&WSL2控制面板开启Hyper-V功能；安装WSL2并设为默认版本DockerDesktop安装官方安装包配置下载并安装，在设置中确认使用WSL2作为引擎后端环境连通性验证CLICommands执行docker-v检查版本，运行dockerrunhello-world测试💡避坑指南：•若安装失败，先检查BIOS中的IntelVT-x或AMD-V虚拟化技术是否开启。•WSL2与Hyper-V功能需同时启用，DockerDesktop默认推荐使用WSL2引擎以获最佳性能。💡注意事项准备工作(1)-检查Windows版本与虚拟化支持010203检查Windows版本路径：“设置”→“系统”→“关于”要求：确保系统版本为Windows101903或更高版本。检查CPU虚拟化支持路径：“任务管理器”→“性能”→“CPU”要求：查看右下角“虚拟化”状态，必须显示为“已启用”。注意事项若“虚拟化”显示为“已禁用”，请重启电脑并按主板对应按键（通常是F2或Del）进入BIOS设置开启。不同品牌电脑进入BIOS的按键可能不同，请提前确认。系统环境配置检查准备工作(2)-启用WSL与虚拟机平台操作步骤：1.点击开始菜单，搜索PowerShell，选择“以管理员身份运行”。2.在打开的PowerShell窗口中，依次执行下方两条命令。>启用WSL子系统dism.exe/online/enable-feature/featurename:Microsoft-Windows-Subsystem-Linux/all/norestart>启用虚拟机平台dism.exe/online/enable-feature/featurename:VirtualMachinePlatform/all/norestart最后一步：重启计算机执行命令完成后，重启电脑使功能生效，之后就可以安装Linux分发版了。准备工作(3)-开启Windows功能服务关键操作步骤：开启虚拟化与子系统支持01打开功能设置面板打开“控制面板”→进入“程序”→点击“启用或关闭Windows功能”。等待系统加载后，将弹出功能列表窗口。02勾选三项核心功能在列表中找到并勾选以下选项（注意展开Hyper-V的子菜单并全部勾选）：

1.Hyper-V(及其所有子选项)

2.适用于Linux的Windows子系统(WSL)

3.虚拟机平台03确认安装并重启电脑点击窗口右下角的“确定”按钮。系统将自动下载并安装所需文件，完成后会提示重启计算机，请务必重启以确保功能生效。安装DockerDesktopDocker环境搭建第一步：下载、安装与验证01/下载安装程序访问Docker官方网站，根据您的操作系统（Windows或macOS）下载对应的安装包。下载完成后，双击安装文件，遵循向导提示完成安装即可。02/启动与状态验证安装完成后，在应用列表中找到并启动DockerDesktop。查看任务栏右下角的图标，当显示为稳定的鲸鱼图标（无旋转）时，即代表Docker服务已成功运行。💡安装小贴士Windows系统需开启Hyper-V和容器功能；macOS需保证系统版本符合要求。若启动失败，可尝试重启电脑或检查网络连接。常见问题解决：启动Docker提示“WSL2安装不完整”01.检查Windows功能确保Windows功能中的以下选项已勾选：•适用于Linux的Windows子系统

•虚拟机平台可在控制面板-程序-启用或关闭Windows功能中查看。02.安装WSL2内核更新包下载并安装微软官方提供的WSL2Linux内核更新包：https://aka.ms/wsl2kernel这是解决“WSL2安装不完整”报错最常见的方案。安装后需重启电脑。03.重置网络组件若前两步无效，尝试重置Winsock目录：netshwinsockreset1.以管理员身份打开PowerShell或CMD。

2.输入以上命令并回车。

3.执行完成后，务必重启电脑。💡额外建议如果以上步骤仍无法解决，请检查DockerDesktop的设置，确认“使用WSL2替代Hyper-V”选项已开启。同时，确保您的Windows版本已更新到最新。Docker基本操作-镜像与容器的管理关键概念/分类通俗化定义与解释核心命令与实操说明镜像(Image)可以将其理解为程序的安装包，包含了运行应用所需的所有代码、依赖库、配置文件和操作系统快照，是静态的文件。•dockerimages:列出本地主机上已下载的所有镜像•dockerrmi<镜像名/ID>:删除指定的本地镜像文件容器(Container)基于镜像创建的动态运行实例，就像安装包运行起来的软件进程。容器拥有独立的文件系统、网络和进程空间，彼此隔离。•dockerrun[参数]<镜像名>:从指定镜像创建并启动容器（参数如-d后台运行，-p端口映射等）核心

总结记住一个核心类比：

如果把Docker看作一台电脑，那么镜像就是软件的安装光盘，容器就是安装好后正在运行的软件。熟练掌握以上三条命令，就迈出了容器化管理的第一步。任务实施：核心操作步骤一：安装OpenWebUI步骤二：启动并配置服务步骤三：连接Ollama后端在WebUI后台添加Ollama服务器地址，完成前端与本地大模型后端的通信连接，实现问答交互。在浏览器中访问本地端口启动WebUI，进入设置页面配置基础参数，确保服务正常运行并可访问。使用容器化命令（DockerCompose）快速拉取并部署OpenWebUI前端镜像，实现开箱即用的可视化交互界面。核心目标：构建本地可视化LLM交互环境任务二：安装并启动OpenWebUI🎯任务核心目标通过Docker执行一键启动命令，快速部署并运行OpenWebUI服务，无需复杂的环境配置或手动安装依赖，实现开箱即用。📋必须满足的前置条件1.DockerDesktop已成功安装，且目前处于运行状态。

2.Ollama服务端已启动并正常运行，确保本地模型可被调用。💡操作小贴士：在执行Docker命令前，请务必检查Docker图标是否在状态栏正常显示。若遇到连接Ollama失败的情况，请确认Ollama终端窗口未被关闭，且没有被防火墙拦截。1命令执行说明：在命令行终端中直接执行以下指令，Docker将自动完成镜像下载与容器创建。核心指令2dockerrun-d-p8080:8080--add-hosternal:host-gateway\-vopen-webui:/app/backend/data--nameopen-webui--restartalways\ghcr.io/open-webui/open-webui:main3关键参数解析：其中--add-host是连接宿主机Ollama服务的核心配置；-v用于数据持久化，防止重启后配置丢失；--restartalways确保容器随Docker自动启动。效果预览执行命令后，打开浏览器访问http://localhost:8080即可进入OpenWebUI界面。这条命令整合了端口映射、数据卷挂载及服务保活，是生产环境部署的最佳实践。一键启动命令详解：Docker部署OpenWebUI连接Ollama服务-注册与登录010203访问OpenWebUI服务在浏览器的地址栏中输入http://localhost:8080，访问部署好的OpenWebUI应用程序。完成管理员账号注册首次访问时系统会自动进入注册页面，请输入您的名称、邮箱地址，并设置安全的管理员密码，确认后完成账号创建。自动登录并进入主界面管理员账号创建成功后，系统将自动完成登录流程，并直接跳转至应用的主界面，此时您可以开始配置和使用Ollama服务了。STEP访问与配置指引连接Ollama服务·手动配置API地址通常OpenWebUI会自动连接Ollama，若未连接成功，请按照以下步骤操作配置界面示意Settings>ModelsOllamaAPIBaseURLernal:11434STEP01进入设置在OpenWebUI界面中，点击右上角个人头像进入“设置”页面，然后切换到“模型”选项卡。STEP02选择Ollama在“模型提供者”列表中，找到并选择Ollama选项，进入其配置区域。STEP03输入关键地址在“APIBaseURL”输入框中，输入以下地址以连接宿主机服务：

ernal:11434STEP04保存并验证点击“保存”按钮。若地址正确，系统会自动建立连接。返回主页即可选择Ollama模型进行对话。核心原理：ernal是Docker提供的特殊DNS解析地址，专门用于在容器内部访问宿主机上运行的服务，无需配置复杂的端口映射或防火墙规则。模型管理-在Web界面中切换本地模型010203定位入口1.确保回到了应用的主聊天界面。2.在界面顶部导航栏，找到当前正在使用的模型名称。展开列表3.点击模型名称旁的下拉箭头图标，展开本地模型列表。4.列表中会展示所有您之前已下载到本地的可用模型。完成切换5.鼠标点击列表中任意一个模型名称，系统将自动加载并切换到此模型。切换完成后，您可以直接在当前界面与新选择的模型进行对话。任务三：流畅对话与参数调优像使用ChatGPT一样与本地AI交互，探索参数调整的无限可能本地交互无需联网·隐私安全·极速响应01.沉浸式流畅对话现在，你可以在漂亮的网页界面中与你的本地AI进行自然流畅的对话，体验感与ChatGPT无异，但数据完全保存在本地，既安全又快速。无论是日常问答、代码编写还是生活建议，它都能随时响应。参数魔法温度(Temperature)调节掌控回答的风格与性格02.探索温度参数的奥秘🔻调低温度(LowTemp):回答更严谨、聚焦、逻辑一致，适合需要事实准确性的任务，如写报告、回答专业问题。🔺调高温度(HighTemp):回答更具创意、多样性和想象力，适合头脑风暴、写故事、创作诗歌。体验对比-WebUIvs.命令行命令行(CLI)交互方式复杂，需记忆大量专业命令；操作无历史记录回溯困难；模型切换步骤繁琐，且无视觉反馈，整体体验门槛高、不够友好。OpenWebUI(WebGUI)交互直观，完全做到“所见即所得”；自动保存所有对话历史，随时回溯；支持一键快速切换不同AI模型；拥有现代化的视觉设计，使用体验愉悦流畅。核心价值总结从“能用”到“好用