首次登录初始化 + 国内大模型接入教程
-
- 一、前言
- 二、Dify后台初始化流程
-
- [1. 访问后台地址](#1. 访问后台地址)
- [2. 创建管理员账号](#2. 创建管理员账号)
- [3. 后台核心界面说明](#3. 后台核心界面说明)
- 三、国内大模型接入通用教程
-
- [1. 前置说明](#1. 前置说明)
- [2. 通用接入步骤](#2. 通用接入步骤)
- 四、新手推荐优先接入模型（免费好用）
- 五、常见接入问题排查
-
- [1. 测试连接失败](#1. 测试连接失败)
- [2. 模型添加成功，对话无响应](#2. 模型添加成功，对话无响应)
- [3. 响应缓慢、超时](#3. 响应缓慢、超时)
一、前言
上一篇我们完成了Dify私有化Docker部署，但需注意，部署完成后的Dify服务未内置任何大模型。若想正常使用AI对话、知识库、工作流等核心功能，必须手动接入外部大模型。本篇将详细讲解Dify后台初始化全流程、大模型配置通用方法，并以国内免费易申请的大模型为例，帮助零基础用户完成模型接入实操。
二、Dify后台初始化流程
1. 访问后台地址
在浏览器地址栏输入部署好的Dify服务地址：
首次访问时，页面会自动跳转至安装初始化界面，无需手动操作。
2. 创建管理员账号
填写以下信息完成管理员账号创建（注意信息规范）：
- 邮箱：支持自定义填写（无需绑定真实邮箱，格式正确即可，如admin@dify.local）
- 用户名：建议设置为易记且辨识度高的名称（如DifyAdmin）
- 密码：务必设置高强度密码（包含大小写字母、数字、特殊符号），并做好记录保存
填写完毕后，点击"创建账号"按钮，即可进入Dify工作台。
3. 后台核心界面说明
初始化完成后，工作台核心功能模块如下：
- 应用：支持可视化创建聊天助手、工具类AI应用等各类定制化应用
- 知识库：可上传文档、搭建私有知识库，实现RAG（检索增强生成）能力
- 工作流：通过拖拽式操作编排复杂AI流程，满足多场景业务需求
- 模型供应商：集中管理所有接入大模型的API密钥、调用参数等配置
- 设置：涵盖团队管理、权限分配、系统参数配置等基础运维功能
三、国内大模型接入通用教程
1. 前置说明
Dify原生兼容主流国内外大模型，国内常用的包括：通义千问、DeepSeek、智谱GLM、文心一言、讯飞星火，以及Ollama本地部署模型等。所有模型的接入逻辑一致，仅需按厂商要求填写对应配置即可。
2. 通用接入步骤
步骤1：进入模型配置页面
登录Dify后台后，点击左侧侧边栏【设置】→ 选择【模型供应商】选项，进入模型管理配置页。
步骤2：选择目标模型厂商
在模型供应商列表中，选择需要接入的厂商（如：通义千问 / DeepSeek / 智谱GLM）。
步骤3：获取并填入API密钥
需提前在对应厂商官网完成API Key申请（附核心厂商申请地址）：
- 阿里云：通义千问（https://dashscope.aliyun.com/）
- 深度求索：DeepSeek（https://platform.deepseek.com/）
- 百度智能云：文心一言（https://cloud.baidu.com/product/wenxinworkshop）
申请完成后，复制生成的API Key，粘贴至Dify对应厂商的密钥输入框中（注意去除首尾空格）。
步骤4：保存配置并测试连通性
填入密钥后，开启"启用"开关，点击"测试连接"按钮。若提示"测试成功"，则该模型已可正常调用；若测试失败，可参考下文"常见问题排查"定位问题。
四、新手推荐优先接入模型（免费好用）
| 模型名称 | 核心优点 | 适配场景 |
|---|---|---|
| DeepSeek | 个人免费额度充足、响应速度快、调用限制宽松 | 日常对话交互、学习调试、轻量级文本生成 |
| 通义千问 | 中文语义理解能力强、服务稳定性高、适配多行业场景 | 文案创作、知识库问答、企业级文本处理 |
| 智谱GLM | 逻辑推理能力优秀、代码生成准确率高 | 代码编写、数学推理、结构化数据输出 |
五、常见接入问题排查
1. 测试连接失败
- 排查点1：API Key填写错误（如字符缺失、多余空格、大小写错误）
- 排查点2：厂商账号未完成实名认证（多数国内厂商要求实名认证后才可调用API）
- 排查点3：账号免费额度已耗尽（可登录厂商控制台查看额度使用情况）
2. 模型添加成功，对话无响应
- 排查点1：部署Dify的服务器无法访问外网（需确保服务器能正常访问模型厂商API域名）
- 排查点2：服务器防火墙/安全组拦截出站请求（需放行模型API的端口，如443）
3. 响应缓慢、超时
- 优化方案：优先更换国内低延迟模型节点，推荐选择阿里云（通义千问）、深度求索（DeepSeek）的国内节点；
- 辅助操作：可在模型配置页调整超时时间参数，适配网络环境。