DreamFactory

适用于DreamFactory 7.x的Docker容器，基于Ubuntu 24.04、PHP 8.3和NGINX。

入门指南 ∙ 在线试用 ∙ 贡献代码 ∙ 社区支持 ∙ 文档

目录

• 前提条件
• 安装
• DreamFactory授权版本
• 数据持久化
• 测试数据
• 文档
• 商业许可
• 反馈与贡献

前提条件

安装Docker

• 参见：[***]

安装Docker Compose

• 参见[***]

安装DreamFactory Docker容器

配置DreamFactory应用最简单的方法是使用docker-compose。这将自动启动4个容器：DreamFactory应用、系统数据库的MySQL容器、缓存的Redis容器，以及一个Postgres数据库（预配置了超过10万条记录用于测试）。

1) 克隆df-docker仓库

cd ~/repos（或任何你想存放仓库克隆的位置） git clone [***] cd df-docker

2) 编辑docker-compose.yml（可选）

3) 构建镜像

docker compose build

4) 启动容器

docker compose up -d

注意：会创建卷df-storage:/opt/dreamfactory/storage来存储DreamFactory的所有基于文件的数据（应用、日志等）。这主要将DreamFactory写入的数据（位于/opt/dreamfactory/storage目录）存储在df-storage卷中。这样，即使删除DreamFactory容器，只要不删除df-storage卷，数据就会保留。

要停止并删除所有容器，可以使用以下命令：

    docker compose down

要停止并删除所有容器及卷，使用：

    docker compose down -v

5) 访问管理界面

在浏览器中访问127.0.0.1。构建完成后需要一些时间，之后会提示创建第一个管理员用户。

运行授权实例

1) 将许可证文件添加到df-docker目录

2) 取消注释Dockerfile的第25行和第36行

3) 在Dockerfile的第36行添加许可证密钥

4) 构建镜像

docker compose build

5) 启动容器

docker compose up -d

6) 访问应用

在浏览器中访问127.0.0.1。构建完成后需要一些时间，之后会提示创建第一个管理员用户。

持久化系统数据库配置

启动DreamFactory实例后，从/opt/dreamfactory目录下的.env文件中获取APP_KEY值。可通过以下命令执行： docker-compose exec web cat .env | grep APP_KEY

将此值设置为docker-compose.yml文件（第28行）中的APP_KEY值，用单引号括起来，以避免在需要重建实例时出现“The MAC is invalid”错误。

测试数据

我们挂载了一个包含超过10万条记录的Postgres容器，用于在不连接自己数据集的情况下进行测试。要使用该容器，需使用以下连接详情：

主机：可通过运行以下Docker命令找到主机：docker inspect <container-id> | grep "IPAddress" 端口：5432 数据库名称：dellstore 用户名：postgres 密码：root_pw

这将从Postgres容器生成一个完整文档化且安全的API。

文档

通过阅读我们的入门指南了解DreamFactory的更多功能。更多平台文档可在DreamFactory Wiki上找到。

商业许可

需要***技术支持？希望访问SQL Server、Oracle、SOAP的REST API生成器或移动推送通知？需要API限流和/或审计？请与我们的团队安排演示！

反馈与贡献

欢迎在我们的论坛上提供反馈，或通过拉取请求和/或issue的形式。贡献应遵循《“为项目贡献”》“Contributing to a project”中概述的策略。