potofo/dify2openai

dify2openai Docker镜像文档

镜像概述

dify2openai是一个开源工具镜像，由开发者fatwang2基于https://github.com/0w0z/Dify2OpenaiApi%E4%BB%93%E5%BA%93 fork 开发，主要功能是将Dify API转换为与OpenAI API兼容的接口。该项目同时展示了如何通过GitHub Actions实现Docker镜像的自动化构建与发布，并已在DockerHub上发布可用镜像https://hub.docker.com/r/fatwang2/dify2openai%E3%80%82

核心功能与特性

• API转换能力：实现Dify API到OpenAI兼容API的转换，便于将基于OpenAI客户端的应用对接Dify服务。
• GitHub Actions集成：提供完整的GitHub Actions配置示例，演示如何自动化构建、测试和发布Docker镜像。
• 认证问题修复：针对原仓库中存在的“Error: Username and password required”认证问题进行了修复，确保镜像运行稳定性。
• Docker化部署：提供即用型Docker镜像，简化部署流程，支持快速集成到现有系统。

使用场景

• 需要将基于OpenAI API的应用迁移至Dify服务的场景。
• 希望通过GitHub Actions实现Docker镜像自动化构建的开发实践。
• 需要解决Dify API与OpenAI客户端兼容性问题的项目。

使用方法

前提条件

• 已安装Docker环境。
• 拥有Dify服务的访问权限及相关API凭证。

拉取镜像

从DockerHub拉取最新版本镜像：

bash
docker pull fatwang2/dify2openai:latest

运行容器

基本运行命令（具体环境变量需根据实际需求配置）：

bash
docker run -d \
  --name dify2openai \
  -p 8080:8080 \
  -e DIFY_API_KEY="your_dify_api_key" \
  -e OPENAI_COMPATIBLE_PORT=8080 \
  fatwang2/dify2openai:latest

配置说明

目前官方未明确列出所有环境变量，以下为基于功能推测的常用配置项（实际使用时请参考项目GitHub文档）：

• DIFY_API_KEY：Dify服务的API密钥，用于鉴权访问Dify API。
• OPENAI_COMPATIBLE_PORT：服务监听端口，默认可能为8080。
• DIFY_BASE_URL：Dify服务的基础URL，默认为Dify官方服务地址，如需自定义可配置。

验证服务

容器启动后，可通过访问 http://localhost:8080 验证服务是否正常运行，或通过调用兼容OpenAI API格式的接口进行测试。

项目地址

• GitHub仓库：https://github.com/fatwang2/dify2openai
• DockerHub镜像：https://hub.docker.com/r/fatwang2/dify2openai