宝塔面板一键部署 Dify AI 应用教程,小白也能轻松上手

宝塔面板一键部署 Dify AI 应用教程,小白也能轻松上手

Dify 是一款强大的开源 AIGC 应用平台,支持创建 AI 助手、问答系统等。本教程将带你通过宝塔面板一步步完成 Dify 的部署,零基础也能快速上手!


🚀 宝塔面板一键部署 Dify AI 应用教程【图文版】

Dify 是一款强大的开源 AIGC 应用平台,支持创建 AI 助手、问答系统等。
本教程将带你通过宝塔面板一步步完成 Dify 的部署,零基础也能快速上手!


📋 一、前提条件

在部署 Dify 之前,请确保你的服务器满足以下最低要求:

项目 要求
CPU ≥ 2 核
内存 ≥ 4 GB
系统 Linux(推荐 Ubuntu 20.04+ / CentOS 7+)
面板 宝塔面板 9.2.0 或以上正式版本

👉 宝塔安装教程见官网:
🔗 https://www.bt.cn/new/download.html


📦 二、部署 Dify 步骤详解

✅ Step 1:登录宝塔后台

使用浏览器访问你的宝塔面板地址,输入账号密码登录后台控制面板。


✅ Step 2:安装 Docker 环境

  1. 左侧菜单点击【软件商店】
  2. 搜索 Docker,点击【安装】
  3. 按提示安装 DockerDocker Compose

✅ Step 3:安装 Dify 应用

  1. 在【Docker - 应用商店】中找到 Dify
  2. 点击【安装】
  3. 填写配置信息:
项目 填写说明
名称 默认即可(如:Dify-xxxxx
版本 选择 latest
域名 若使用域名访问,请填写(并提前解析到服务器)
允许外部访问 勾选可用IP:端口访问;若设置了域名,建议取消勾选
端口 默认 8088,可自定义
  1. 点击【提交】,系统会自动拉取镜像并初始化部署,大约 1-3 分钟。

🌐 三、访问 Dify 应用

部署完成后,你可以访问 Dify 来完成管理员账号的设置:

🛠 初始化安装界面:

  • 若使用域名访问:
1
http://yourdomain/install
  • 若使用 IP+端口访问:
1
http://your_server_ip:8088/install

设置完管理员账号后,即可使用完整功能。


🚪 应用首页访问:

  • 域名方式:
1
http://yourdomain/
  • IP+端口方式:
1
http://your_server_ip:8088/

🧠 常见问题提示

  1. 端口被占用?
    → 修改 Dify 启动端口,例如使用 8090 替代 8088

  2. 页面打不开?
    → 确保服务器防火墙 & 云平台安全组已开放对应端口(如 8088)。

  3. 域名无法访问?
    → 确保域名已正确解析至服务器,并没有勾选“允许外部访问”选项。

  4. 想用 HTTPS?
    → 可通过宝塔面板内的【网站】模块为域名申请免费 SSL。


🔗 推荐链接

名称 链接
🏠 Dify 官网 https://dify.ai/
📚 GitHub 项目 https://github.com/langgenius/dify
🐳 宝塔官网 https://www.bt.cn/

以下是适用于 宝塔面板服务器 上的 Dify AI 应用自定义部署脚本,通过 Shell 一键拉取容器、设置环境变量、运行并持久化服务,适用于对宝塔熟悉的用户。


✅ 一键部署 Dify AI 自定义脚本(适用于 Linux + 宝塔)

📁 步骤一:准备工作目录

1
2
mkdir -p /www/server/dify
cd /www/server/dify

🧾 步骤二:创建环境配置文件 .env

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
cat > .env <<EOF
# 数据库配置(使用内置 SQLite,可后续接入外部 MySQL/PostgreSQL)
DATABASE_URL=sqlite:///dify.db

# Redis(如需高性能可改为外部 Redis 服务)
REDIS_URL=redis://redis:6379/0

# 后台管理默认邮箱(第一次启动后可通过 UI 创建管理员)
[email protected]

# App 通信密钥(可随机生成)
APP_SECRET_KEY=$(openssl rand -hex 32)

# 模型服务(OpenAI 等接口密钥后续在网页中设置)
EOF

🧱 步骤三:编写 Docker Compose 文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
cat > docker-compose.yml <<EOF
version: '3.8'
services:
redis:
image: redis:alpine
container_name: dify-redis
restart: always

dify:
image: langgenius/dify:latest
container_name: dify-app
restart: always
env_file:
- .env
ports:
- "8088:80"
depends_on:
- redis
volumes:
- ./dify-data:/data
EOF

▶️ 步骤四:运行容器启动服务

1
docker compose up -d

🔍 步骤五:查看运行日志(可选)

1
docker logs -f dify-app

🌐 访问服务

  • 管理员初始化地址:

    1
    http://你的服务器IP:8088/install
  • 默认首页地址:

    1
    http://你的服务器IP:8088/

📦 额外可选:设置宝塔面板域名反代 + SSL

若你希望用域名访问:

  1. 宝塔 > 网站 > 添加网站 > 填写域名(例如 dify.yourdomain.com)
  2. 设置反向代理,目标地址填:http://127.0.0.1:8088
  3. 开启 SSL(建议使用 Let’s Encrypt 免费证书)

📌 常见命令速查

命令 描述
docker compose up -d 后台启动 Dify 服务
docker compose down 停止并移除容器
docker restart dify-app 重启主容器
docker logs -f dify-app 实时查看 Dify 日志
rm -rf /www/server/dify 删除 Dify 所有文件和配置(谨慎操作)

如果你希望我打包这些文件为 .zip 提供下载或生成适用于宝塔“计划任务”的自动部署任务,也可以告诉我,我可以帮你一键生成。是否还需要我提供Nginx 反代配置模板集成 Cloudflare Proxy 设置