# 开始使用
#### 安全组规则修改（可选）
![](https://support.huaweicloud.com/dify-aislt/public_sys-resources/notice_3.0-zh-cn.png)
- 在RFS资源的页签下，可找到该解决方案对应的安全组，安全组名称默认是解决方案名称，也支持用户自定义。
- 该解决方案使用80端口用来访问Dify，默认全放通，请参考[修改安全组规则](https://support.huaweicloud.com/usermanual-vpc/vpc_SecurityGroup_0005.html)，配置IP地址白名单。
- 该解决方案使用22端口用来以SSH方式远程登录云服务器，若需远程登录云服务器，请参考[修改安全组规则](https://support.huaweicloud.com/usermanual-vpc/vpc_SecurityGroup_0005.html)，配置IP地址白名单，以便能正常访问服务。
 
#### Dify登录
1. 登录开发平台：在浏览器输入堆栈"输出"标签页面中的访问地址"http://IP地址:80"，即可访问Dify的开发平台。首次登录需注册管理员账号，依次填写邮箱、账号、密码。 
   图1设置管理员账户   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002271985836.png "点击放大")
   
   
2. 在登录界面，依次输入上一步骤中的"邮箱"和"密码"登录Dify平台。 
   图2登录Dify平台   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002306562449.png "点击放大")
   图3Dify平台   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002306515589.png "点击放大")
   
   
 
![](https://support.huaweicloud.com/dify-aislt/public_sys-resources/note_3.0-zh-cn.png)
- 以下对接大模型方式[与MaaS服务对接]和[与DeepSeek对接]用户可根据自身情况选择使用。
 
 #### 与MaaS服务对接
1. 访问[MaaS](https://console.huaweicloud.com/modelarts/?locale=zh-cn&region=cn-southwest-2#/model-studio/deployment)控制台在左侧导航栏中，选择"在线推理"，进入"预置服务"服务列表。
   
   图4在线推理   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002662133041.png "点击放大")
   
   
2. 在调用MaaS部署的模型服务时，需要填写API Key用于接口的鉴权认证。在左侧导航栏，单击"API Key管理"（最多可创建30个密钥。**每个密钥仅在创建时显示一次，请确保妥善保存。如果密钥丢失，无法找回，需要重新创建API Key以获取新的访问密钥** ）。
   
   图5API Key管理   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002661973087.png "点击放大")
   
   
3. 在"API Key管理"页面，单击右上角"创建API Key"，填写标签（自定义API Key的标签，标签具有唯一性，不可重复。仅支持大小写英文字母、数字、下划线、中划线，长度范围为1\~100个字符）和描述（自定义API Key的描述）信息后，单击"确定"。标签和描述信息在创建完成后，不支持修改。
   
   图6创建API Key   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002631973828.png "点击放大")
   
   
4. 对接Dify平台。打开您的Dify平台界面，单击右上角"**插件** "按钮。
   
   图7插件安装   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002487277869.png "点击放大")
   
   
5. 单击"**探索Marketplace** "按钮，搜索"Maas"，选择**华为云Maas平台** ，单击**"安装"** 按钮，安装插件。
   
   图8搜索Maas插件   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002487363565.png "点击放大")
   图9安装插件   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002487456005.png "点击放大")
   ![](https://support.huaweicloud.com/dify-aislt/public_sys-resources/note_3.0-zh-cn.png)
   已安装Maas插件，需要**更新MaaS插件至最新版本**。
   
   
6. 单击右上角用户名称，下拉并单击"**设置** "。
   
   图10设置   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002454233736.png "点击放大")
   
   
7. 单击"**模型供应商** "，在右侧模型列表单击"**华为云** **MaaS** **平台** "列表中的"**设置** "。配置模型信息：**"API Key"** 填写[步骤3]中创建的API Key，填写完成后单击"保存"，完成LLM模型的配置。
   
   图11API KEY设置   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002487475925.png "点击放大")
   图12API KEY填写   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002454398820.png "点击放大")
   图13模型列表   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002487484769.png "点击放大")
   
   
 
 #### 与DeepSeek对接
![](https://support.huaweicloud.com/dify-aislt/public_sys-resources/note_3.0-zh-cn.png)
该章节为成功部署[快速搭建DeepSeek推理系统](https://www.huaweicloud.com/solution/implementations/building-a-deepseek-lnference-system.html)解决方案后，将DeepSeek大模型对接至Dify平台时参考使用。
1. 右侧单击用户名称，下拉并单击"设置"。 
   图14设置   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002271882698.png "点击放大")
   
   
2. 单击左侧"模型供应商"，在Ollama下单击"添加模型"。 
   图15添加Ollama模型   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002306562481.png "点击放大")
   
   
3. 模型名称填写[快速搭建DeepSeek推理系统](https://www.huaweicloud.com/solution/implementations/building-a-deepseek-lnference-system.html) 部署指南 [快速部署](https://support.huaweicloud.com/deepseek-aislt/deepseek_05.html) 中选择部署的模型（如："DeepSeek-R1-Distill-Qwen-7B" 此处填写"deepseek-r1:7b"），基础URL填写获取的私网IP地址（如果部署的Dify应用和DeepSeek-R1蒸馏版模型不在同一服务器且不在同一VPC下，需填写DeepSeek-R1蒸馏版模型所在服务器的公网IP），端口号11434（使用公网连接时，模型服务器所在安全组需放通11434端口），单击右下角"保存"并关闭"设置"。
   
   图16模型配置   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002306562469.png "点击放大")
   
   
 
#### 创建知识库
![](https://support.huaweicloud.com/dify-aislt/public_sys-resources/note_3.0-zh-cn.png)
- 开通**Maas平台** bge-reranker-v2-m3和BGE-M3模型可直接创建高质量型知识库，步骤可参考[与MaaS服务对接]；未开通则需要提前添加Embedding和Reranker模型。
- 知识库搜索增强版和CCE容器高可用部署 解决方案一键部署提供可选的Embedding和Reranker模型服务器。登录[Flexus云服务器X实例](https://console.huaweicloud.com/hecsx/?locale=zh-cn&region=cn-north-4#/hecsx/instance/manager/vmList)控制台，找到解决方案创建的Embedding\&Reranker模型服务器，复制私网IP地址。后续步骤可参考[快速部署Embedding及Reranker模型](https://www.huaweicloud.com/solution/implementations/deploying-embedding-and-reranker-models.html)部署指南[开始使用](https://support.huaweicloud.com/derm-aislt/derm_06.html)，服务器URL填写私网IP地址（若不使用本方案部署的Embedding和Reranker模型，请填写公网IP）。
 
1. 创建知识库。在Dify平台页面，依次单击"知识库\>创建知识库"上传文本文件后单击"下一步"。 
   图17创建知识库   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002332693997.png "点击放大")
   图18导入文件   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002332813805.png "点击放大")
   
   
2. （**经济型** ）按需求配置知识库，若没有特殊需求默认即可。单击"保存与处理"，待页面提示嵌入已完成表示配置完成。高质量型请参考以下[步骤3]-[5]。
   
   图19配置经济型索引知识库   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002298734630.png "点击放大")
   图20知识库配置完成   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002298894294.png "点击放大")
   
   
3. （**高质量** ）选择高质量模块，在Embedding模型栏目选择添加模型，在检索设置栏目，选择混合检索（可同时使用向量检索和关键词检索，并控制两者权重），在模型下拉窗口选择添加的bge-reranker-v2-m3模型，在下方开启Score阈值开关，并滑动下方的滑动按钮来选择阈值，推荐0.5，下方还有TOP K的选项，可以控制最终被使用的文档分片的最大数量。
   
   图21配置高质量索引知识库   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002332694005.png "点击放大")
   
   
4. （**高质量** ）继续选择权重设置，调整滑动按钮，推荐选择语义（向量检索）0.5，关键词（关键词检索）0.5，然后单击保存，至此，高质量知识库创建完成。
   
   图22配置语义等   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002332813813.png "点击放大")
   
   
5. （**高质量** ）待显示嵌入已完成，文档对应状态变成绿色对钩，则继续单击"前往文档"，可以看到导入的知识库文档为可用状态。
   
   图23嵌入完成   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002298734638.png "点击放大")
   图24高质量型配置完成   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002298894302.png "点击放大")
   
   
 
![](https://support.huaweicloud.com/dify-aislt/public_sys-resources/note_3.0-zh-cn.png)
如果想要快速体验Dify应用平台，可参考[创建聊天助手]；如果想体验基于知识库检索和联网搜索服务的AI助手可以参考[创建工作流]。
 #### 创建聊天助手
1. 选择"创建空白应用"，单击"聊天助手"并填写"应用名称\&图标"，单击右下角"创建"。 
   图25创建空白应用   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002332010613.png "点击放大")
   图26创建聊天助手   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002332130849.png "点击放大")
   
   
2. 单击"编排"，在右下角"和机器人聊天"中输入内容即可调试预览。 
   图27调试与预览   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002298251100.png "点击放大")
   
   
 
 #### （可选）联网搜索
1. 访问[MaaS](https://console.huaweicloud.com/modelarts/?locale=zh-cn&region=cn-southwest-2#/model-studio/deployment)控制台在左侧导航栏中，选择"应用开发"进入"**MCP** **广场** "。
   
   图28MCP广场   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002631802016.png "点击放大")
   
   
2. 选择**联网增强** **MCP** 。
   
   图29联网增强MCP   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002631962120.png "点击放大")
   
   
3. 依次单击"立即开通"和"确认开通"。 
   图30开通联网增强MCP   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002661964443.png "点击放大")
   
   
4. 服务开通后单击进入**ModelArts Versatile控制台** 。
   
   图31控制台设置   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002662126127.png "点击放大")
   
   
5. 控制台中单击AI工具，选择开通联网增强。 
   图32开通联网增强   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002661970517.png "点击放大")
   
   
6. 确认开通工具。 
   图33确认   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002487515873.png "点击放大")
   
   
7. 单击API调用，查看调用示例。 
   图34API调用   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002661969365.png "点击放大")
   图35调用说明   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002661969967.png "点击放大")
   
   
8. 选择API key列表，单击"**创建API key** "按钮创建对应的API ley。
   
   图36创建API key   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002631809518.png "点击放大")
   
   
 
 #### 创建工作流
1. 单击"工作室"，访问dify平台工作室。 
   图37工作室   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002298146172.png "点击放大")
   
   
2. 导入工作流。在工作室页面，单击"导入DSL文件"，在弹出的页面中选择"URL"，复制下面的地址，粘贴到DSL URL路径里，如下图所示： 
   ```
   https://documentation-samples.obs.cn-north-4.myhuaweicloud.com/solution-as-code-publicbucket/solution-as-code-moudle/building-a-dify-llm-application-development-platform/workflow/%E6%99%BA%E8%83%BD%E5%8A%A9%E6%89%8B.yml
   ```
   图38导入工作流   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002487591029.png "点击放大")
   图39工作流模板   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002487576569.png "点击放大")
   ![](https://support.huaweicloud.com/dify-aislt/public_sys-resources/note_3.0-zh-cn.png)
   - 首次导入，若未安装**华为云Maas平台** 插件，弹窗提示安装插件，单击"**安装**"按钮完成安装。
   
   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002454330580.png "点击放大")
   - 插件配置参考[与MaaS服务对接]中[步骤6-7]进行配置。
    
   
   
3. 配置知识库。添加知识库：单击"知识检索"节点，单击"+"按钮添加知识库，选择知识库，单击"添加"。 
   图40配置知识库   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002454659502.png "点击放大")
   
   
4. 联网搜索配置更改环境变量，"**SEARCH_API_KEY** "更改为编辑填写[（可选）联网搜索]的[步骤8]中的API key。
   
   图41环境变量
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002488561945.png "点击放大")
   
   
5. 调整模型。单击大模型名称，在右侧弹窗继续单击模型名称旁边的下拉列表，继续单击模型名称，在下拉列表中选择一个模型即可。其余大模型按照此步骤重复操作即可。 
   图42替换模型   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002487701073.png "点击放大")
   
   
6. 至此，工作流配置已完成，单击右上角"预览"进行对话。 
   图43联网搜索   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002454549296.png "点击放大")
   图44知识检索   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002487792717.png "点击放大")
   
   
 
#### 发布应用
1. 在工作流页面的右上角单击"发布"按钮，再单击"发布"，即可完成工作流发布。 
   图45工作流列表   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002454715744.png "点击放大")
   图46工作流访问方式   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002487731749.png "点击放大")
   图47聊天应用访问方式   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002332750965.png "点击放大")
   
   
2. 发布完成后就可以使用此Agent应用/工作流，有以下三种使用方式：访问API、直接访问、嵌入网站、在"探索"中打开。 
   图48访问API   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002298466808.png "点击放大")
   图49直接访问   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002454733204.png "点击放大")
   图50嵌入网站   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002454574226.png "点击放大")
   图51"探索"   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002298836198.png "点击放大")
   
   
 
#### Dify配置公网域名
您需要在域名解析系统中，添加一条A记录，值为Dify服务器的公网IP。本文档以华为云[云解析服务 DNS](https://www.huaweicloud.com/product/dns.html)为例。如在华为云购买域名，默认直接添加到公网域名。如果不是通过华为云购买的域名，可参考[创建公网域名](https://support.huaweicloud.com/usermanual-dns/zh-cn_topic_0035467702.html)。
1. 进入[公网域名列表页面](https://console.huaweicloud.com/dns/?#/dns/publiczones)，选择要使用的域名，单击"管理解析"。
   
   图52管理解析   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002271985856.png "点击放大")
   
   
2. 单击"添加记录集"，填写配置信息如下： 
   记录类型："A -- 将域名指向IPv4地址"。
   主机记录：解析域名的前缀。
   例如创建的域名为"example.com"，其"主机记录"设置包括：
   - www：用于网站解析，表示解析的域名为"www.example.com"。
   
   - 空：用于网站解析，表示解析的域名为"example.com"。 主机记录置为空，还可用于为空头域名"@"添加解析。
     
   
   - abc：用于子域名解析，表示解析的域名为"example.com"的子域名"abc.example.com"。
   
   - mail：用于邮箱解析，表示解析的域名为"mail.example.com"。
   
   - \*：用于泛解析，表示解析的域名为"\*.example.com"，匹配"example.com"的所有子域名。
   
   
   记录值：域名对应的IPv4地址。最多可以输入50个不重复地址，多个地址之间以换行符分隔。本文值为Dify的公网ip地址。
   图53添加记录集   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002271882690.png "点击放大")
   
   
3. 登录[Flexus云服务器X实例](https://console.huaweicloud.com/hecsx/?locale=zh-cn&region=cn-north-4#/hecsx/instance/manager/vmList)控制台，选择部署Dify的服务器，单击"远程登录"。选择"VNC登录"，输入服务器密码，登录服务器。
   
   图54远程登录   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002609802575.png "点击放大")
   图55VNC登录   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002271985844.png "点击放大")
   
   
4. 将SSL证书文件命名为**dify.crt、dify.key** 并上传至：**/dify/docker/nginx/ssl**
   
   图56上传SSL证书   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002306562437.png "点击放大")
   
   
5. 修改环境变量，在命令行执行如下命令，解析的域名为步骤二获取，例如**www.example.com** ：
   
   ```
   sh /dify/docker/configure_dify_domain_name.sh ${解析的域名}
   ```
   图57配置环境变量   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002306515597.png "点击放大")
   
   
6. 浏览器即可通过配置的域名访问Dify平台。 
   图58访问Dify平台   
   ![](https://support.huaweicloud.com/dify-aislt/zh-cn_image_0000002271985828.png "点击放大")
   
   
 
![](https://support.huaweicloud.com/dify-aislt/public_sys-resources/note_3.0-zh-cn.png)
拓展应用请参考：
- [华为云ModelArts Studio，助力快速搭建专属大模型](https://bbs.huaweicloud.com/blogs/439531)
- [探索Dify：开启AI应用开发的新篇章](https://bbs.huaweicloud.com/blogs/437113)