如何修改Dify Docker部署的默认端口？

Question

**如何修改Dify Docker部署的默认端口？** 在使用Dify的Docker部署时，默认的Web访问端口为3000。若需修改该端口，需在启动容器时通过`-p`参数映射新的主机端口，例如：`docker run -p 8080:3000`。同时，还需在Dify配置文件中更新`PORT`环境变量以确保应用监听正确的端口。若使用Docker Compose部署，则需修改`docker-compose.yml`文件中的端口映射与服务配置。此外，若涉及前端访问，还需检查并更新前端应用中的API请求地址。完成配置后重启容器使更改生效，并确保防火墙规则允许新端口通信。

Answer 1

如何修改 Dify Docker 部署的默认端口

1. 基础概念与默认配置

Dify 是一个基于 Docker 的低代码开发平台，通常通过容器方式部署。其默认 Web 访问端口为 3000。该端口由容器内部服务监听，并通过 Docker 的端口映射机制暴露给宿主机。

2. 单容器部署修改端口

若使用 docker run 启动容器，可通过 -p 参数指定端口映射：

docker run -d -p 8080:3000 -e PORT=3000 difyapp/dify

• -p 8080:3000：将宿主机的 8080 端口映射到容器的 3000 端口。
• -e PORT=3000：设置环境变量，确保应用监听容器内的正确端口。

3. Docker Compose 部署修改端口

若使用 docker-compose.yml 文件部署，需修改端口映射与环境变量：

version: '3'
services:
  dify:
    image: difyapp/dify
    ports:
      - "8080:3000"
    environment:
      - PORT=3000

上述配置将容器内的 3000 端口映射到宿主机的 8080，并确保服务监听正确端口。

4. 前端访问配置调整

若前端应用通过 API 调用 Dify 服务，需更新 API 请求地址中的端口号，例如将：

http://localhost:3000/api/v1

修改为：

http://localhost:8080/api/v1

确保前后端通信路径一致。

5. 网络与防火墙配置

修改端口后，需检查宿主机或云平台的防火墙规则，确保新端口开放。例如在 Linux 系统中可使用 ufw 或 iptables 添加规则：

sudo ufw allow 8080/tcp

在云平台如 AWS、阿里云中，需在安全组中添加相应端口放行规则。

6. 验证与调试方法

完成配置后，可通过以下方式验证端口是否生效：

• 访问 http://localhost:8080 查看 Dify 界面是否正常加载。
• 使用 curl 或 Postman 发送请求测试 API 接口是否响应。
• 查看容器日志确认服务是否监听正确端口：

docker logs <container_id>

7. 进阶配置与多环境管理

对于多环境部署（如开发、测试、生产），建议使用环境变量文件（如 .env）统一管理端口配置。例如：

PORT=3000
HOST_PORT=8080

在 docker-compose.yml 中引用：

ports:
  - "${HOST_PORT}:3000"

提升部署灵活性与可维护性。

8. 常见问题与排查思路

若修改端口后无法访问，建议按以下顺序排查：

1. 确认容器是否正常运行：docker ps
2. 检查端口映射是否正确：docker inspect
3. 确认应用监听端口是否与配置一致。
4. 查看防火墙是否放行新端口。
5. 检查前端调用地址是否已更新。