### Dify Docker 配置连接宿主机上的 MySQL 数据库 当使用 Docker 部署 Dify 应用程序时，通常会将数据库服务也容器化。然而，如果希望 Dify 容器连接到宿主机上安装的 MySQL 数据库，则需要特别配置网络和地址映射。 #### 1. 确定宿主机的 IP 地址 在 Linux 和 macOS 上，Docker 容器可以通过 `host.docker.internal` 来访问宿主机的服务。而在 Windows 上，这个域名也可以正常工作[^2]。因此，在大多数情况下，可以直接使用 `host.docker.internal` 作为 MySQL 主机名。 对于其他操作系统或者特定版本的 Docker，可能需要获取宿主机的实际 IP 地址，并将其传递给 Dify 容器。可以运行以下命令来查找宿主机的 IP 地址： ```bash ip addr show docker0 | grep inet | awk '{print $2}' | cut -d '/' -f1 ``` #### 2. 修改 `docker-compose.yml` 文件 编辑用于启动 Dify 的 `docker-compose.yml` 文件，更新其中的数据库 URL 参数以指向宿主机上的 MySQL 实例。例如： ```yaml version: '3' services: dify: image: difyai/dify:latest container_name: dify-app ports: - "80:3000" # 映射 Web UI 到宿主机端口 80 environment: - DB_URL=mysql://dify_user:dify_password@host.docker.internal:3306/dify_db # 使用 host.docker.internal 指向宿主机 - REDIS_URL=redis://redis:6379/0 depends_on: - redis volumes: - ./data:/data # 持久化存储数据 redis: image: redis:6-alpine volumes: - ./redis_data:/data ``` 在此配置中，`DB_URL` 已经更改为指向宿主机上的 MySQL 数据库实例。这里假定 MySQL 在宿主机上监听标准端口 `3306`，并且已经创建了一个名为 `dify_db` 的数据库以及具有适当权限的用户 `dify_user`[^2]。 #### 3. 更新防火墙规则 确保宿主机上的防火墙允许来自 Docker 容器的流量到达 MySQL 服务器。可以在 MySQL 所属的安全组或 iptables 中添加一条规则，开放必要的端口（通常是 `3306`）。例如： ```bash sudo ufw allow 3306/tcp ``` 另外，还需要确认 MySQL 配置文件 `/etc/mysql/my.cnf` 或者 `/etc/my.cnf` 中没有绑定仅限本地回环接口 (`bind-address = 127.0.0.1`)。如有必要，应将其更改为主机实际的 IP 地址或 `0.0.0.0` 表示接受任何来源的请求[^4]。 #### 4. 测试连接 完成以上步骤之后，重启所有相关的服务并测试连接是否成功： ```bash docker-compose down docker-compose up -d ``` 接着，通过浏览器访问 Dify 的前端界面（默认为 http://localhost），尝试执行一些操作触发后台 API 请求，观察是否存在异常情况。若有问题发生，可利用日志功能诊断具体原因： ```bash docker logs dify-app ``` --- ### 示例代码片段 下面提供一段简单的 Python 脚本用来验证从 Dify 容器内部能否顺利抵达宿主机上的 MySQL 数据库： ```python import pymysql.cursors connection = pymysql.connect( host='host.docker.internal', port=3306, user='dify_user', password='dify_password', database='dify_db', cursorclass=pymysql.cursors.DictCursor ) try: with connection.cursor() as cursor: sql = "SELECT VERSION()" cursor.execute(sql) result = cursor.fetchone() print(result) finally: connection.close() ``` --- ### 注意事项 - 如果仍然遇到连接失败的问题，请仔细核查 MySQL 用户权限设置是否正确授予远程客户端访问权利。 - 对于生产环境而言，强烈建议加密传输通道并通过 SSL/TLS 加固安全性[^4]。