Docker 问题

本文档由 AI 自动翻译。如有任何不准确之处，请参考 英文原版。

网络与连接#

502 Bad Gateway#

Nginx 正在转发到错误的容器 IP。获取当前容器 IP：

docker ps -q | xargs -n 1 docker inspect --format '{{ .Name }}: {{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}'

找到这些行：

/docker-web-1: 172.19.0.5/docker-api-1: 172.19.0.7

更新 dify/docker/nginx/conf.d：

• 将 http://api:5001 替换为 http://172.19.0.7:5001
• 将 http://web:3000 替换为 http://172.19.0.5:3000

重启 nginx 或重新加载配置。注意：IP 在容器重启时会发生变化。

无法访问 localhost 服务#

Docker 容器无法通过 127.0.0.1 访问主机服务。请使用你机器的本地网络 IP。

示例：对于在主机上运行的 OpenLLM，使用 http://192.168.1.100:port（你的实际本地 IP）配置 Dify。

页面一直加载并出现 CORS 错误#

域名/URL 更改会导致跨源问题。在 docker-compose.yml 中更新：

• CONSOLE_API_URL - 控制台 API 的后端 URL
• CONSOLE_WEB_URL - 控制台 Web 的前端 URL
• SERVICE_API_URL - 服务 API URL
• APP_API_URL - Web 应用 API 后端 URL
• APP_WEB_URL - Web 应用 URL

挂载与卷#

Nginx 配置挂载失败#

错误信息：

Error mounting "/run/desktop/mnt/host/d/Documents/docker/nginx/nginx.conf" to rootfs at "/etc/nginx/nginx.conf": not a directory

克隆完整项目并从 docker 目录运行：

git clone https://github.com/langgenius/dify.gitcd dify/dockerdocker compose up -d

端口冲突#

端口 80 已被使用？可选择：

1. 停止冲突的服务（通常是 Apache/Nginx）：

   sudo service nginx stopsudo service apache2 stop

2. 或在 docker-compose.yaml 中更改端口映射：

   ports:  - "8080:80"  # 映射到不同端口

容器管理#

查看后台 shell 输出#

列出运行中的 shell：

docker exec -it docker-api-1 ls /tmp/shells/

检查 shell 输出：

docker exec -it docker-api-1 cat /tmp/shells/[shell-id]/output.log

容器重启问题#

系统重启后，容器可能无法连接。确保正确的启动顺序：

docker compose downdocker compose up -d

等待所有服务健康后再访问。

SSRF 代理#

ssrf_proxy 容器防止服务器端请求伪造攻击。

自定义代理规则#

编辑 docker/volumes/ssrf_proxy/squid.conf 添加 ACL 规则：

# 阻止访问敏感内部 IPacl restricted_ip dst 192.168.101.19acl localnet src 192.168.101.0/24http_access deny restricted_iphttp_access allow localnethttp_access deny all

更改后重启代理容器。

为什么需要 SSRF_PROXY？ #

防止服务向内网资源发出未授权请求。代理会拦截并过滤来自沙盒服务的所有出站请求。