1panel自定义模型设置方法教程详解
1Panel 是一款功能强大的 Linux 服务器管理面板，支持快速部署、监控运维、短信告警等功能，支持多端操作。它更偏向把系统状态查看和常用调节动作放在一起，适合需要持续观察和微调设备状态的场景。
学习在 1Panel 中设置自定义 AI 模型。涵盖进入模型管理、创建账号、配置 Base URL 与 API Key、维护模型池及验证连接的完整步骤，确保智能体正确调用外部或本地模型服务。
在 1Panel 面板中集成外部 AI 服务或本地推理引擎，能让智能体和 AI 搜索功能直接调用你指定的模型资源。这种设置方式将连接信息与具体应用解耦，一旦配置完成，所有支持该模型账号的功能模块都能即时使用，无需重复输入凭证。
1Panel 左侧菜单 AI 下的模型管理入口及标签页布局
配置的核心在于准确填写服务端的接口地址和认证信息，并确保模型 ID 与服务端实际提供的名称一致。只要网络可达且协议兼容，无论是云服务商的兼容接口，还是自建 Ollama、vLLM 服务，都能通过统一入口接入。
1. 进入 AI 模型管理
登录 1Panel 面板后，在左侧导航栏找到并点击【AI】菜单，随后选择子菜单中的【模型】。页面加载后，你会看到顶部有【模型账号】和【本地模型】两个标签页。自定义外部接口或通用兼容服务的配置应在【模型账号】标签下进行，这里集中管理所有连接凭证。
2. 创建模型账号
在【模型账号】列表页面的右上角，点击【创建】按钮。弹出的表单中，首先填写【账号名称】。这个名称仅用于在 1Panel 内部识别，建议采用“服务商-用途”的格式，例如“内部推理-测试”，避免直接使用敏感信息作为名称。
2. 创建模型账号
3. 选择自定义提供商
在【模型提供商】下拉菜单中，根据目标服务类型进行选择。如果对接的是标准 OpenAI 兼容接口或其他通用 API，选择【自定义】；如果是本地部署的 Ollama 或 vLLM 服务，则直接选择对应的【Ollama】或【vLLM】选项。选择后，下方表单会根据提供商类型动态显示所需的配置字段。
4. 填写 API Key 和 Base URL
根据上一步的选择，填写必要的连接信息。对于【自定义】类型，通常需要填写【API Key】和【Base URL】。API Key 是服务端颁发的访问令牌，请确保复制完整且无多余空格。Base URL 应填写服务文档提供的 API 根地址，例如 https://api.example.com/v1，不要随意追加额外的路径参数，除非服务端明确要求。
若选择 Ollama 或 vLLM，系统可能会自动填充默认的本地地址（如 http://127.0.0.1:11434），此时只需确认端口是否正确即可。
5. 选择 API 类型
在【API 类型】选项中，确认服务端支持的协议标准。大多数自定义服务兼容 OpenAI 格式，但部分私有部署可能使用特定版本或变种。务必与服务端管理员确认支持的 API 类型，错误的协议选择会导致后续连接验证失败或消息发送异常。
5. 选择 API 类型
6. 维护模型池
【模型池】区域用于定义该账号下可用的具体模型。点击添加模型，填写【模型 ID】，这必须与服务端实际接受的模型名称完全一致，区分大小写。【显示名称】可以设置为中文或更易读的标识，方便在智能体中选择。同时，根据服务端限制，合理设置【Context Window】（上下文窗口）和【Max Tokens】（最大输出令牌数），这些参数会影响对话的长度和成本。
7. 保存并验证连接
检查所有填写项无误后，点击底部的【保存】按钮。返回模型账号列表，找到刚才创建的账号，点击操作列中的【验证连接】按钮。系统会尝试向 Base URL 发送请求以检查连通性和凭证有效性。如果显示“连接成功”，说明配置正确；若失败，请依次检查网络防火墙、API Key 有效性及 Base URL 格式。
8. 在智能体和 AI 搜索中选择模型
配置验证通过后，该模型账号即可被其他功能模块调用。进入【智能体】或【AI 搜索】的设置页面，在模型选择下拉列表中，你应该能看到新添加的账号及其下的模型 ID。选中它并进行一次简单的对话测试，确保实际业务流中能正常接收回复。
在智能体设置中调用已验证通过的自定义模型账号
9. 配置 Ollama 或 vLLM 本地模型
如果使用本地服务，需确保对应应用已在 1Panel 应用商店中安装并处于运行状态。对于 vLLM，部分高级功能可能需要专业版或企业版许可证支持。请注意，1Panel 的模型管理仅负责记录连接信息和模型元数据，不会自动下载或托管实际的模型权重文件，模型文件的管理仍需通过 Ollama 或 vLLM 自身的命令行或界面完成。
10. 检查凭证和权限
API Key 属于高敏感凭证，建议仅授予受信任的管理员角色访问【AI】>【模型】菜单的权限。在团队协作环境中，普通用户可能无法看到模型配置入口，这是由 1Panel 的角色权限控制决定的。定期轮换 API Key 并在更换后及时更新 1Panel 中的配置，能进一步提升安全性。
模型账号列表中显示验证通过的状态标识
完成上述步骤后，你的自定义模型已正式接入 1Panel。后续如需调整模型参数或切换服务端地址，只需回到模型账号编辑页面修改即可，所有关联的智能体将自动继承新的配置，无需逐个重新设置。
Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件，支持 Windows、macOS 和 iPad 等平台，广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。
Blender 是一款免费开源、跨平台的专业 3D 创作软件，集建模、动画、渲染、视频编辑与视觉合成等功能于一体，广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎，并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统，安装包轻巧、运行流畅，依托活跃的全球开发者社区持续更新，是从初学者到专业创作者都值得选择的正版 3D 创作工具。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件，支持 Windows、macOS 和 iPad 等平台，广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。
Blender 是一款免费开源、跨平台的专业 3D 创作软件，集建模、动画、渲染、视频编辑与视觉合成等功能于一体，广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎，并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统，安装包轻巧、运行流畅，依托活跃的全球开发者社区持续更新，是从初学者到专业创作者都值得选择的正版 3D 创作工具。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。