# KKFileView 局域网部署环境变量配置示例 # # 使用场景:KKFileView 和 Dify 部署在同一局域网的不同机器上 # # 配置说明: # 1. 复制此文件到 .env:cp kkfileview-lan.env.example .env # 2. 根据你的网络环境修改以下配置 # 3. 运行 docker-compose up -d 重启服务 # ============================================ # KKFileView 配置 # ============================================ # KKFileView 服务地址(浏览器访问) # 示例:如果 KKFileView 部署在 192.168.1.101:8012 KKFILEVIEW_URL=http://192.168.1.101:8012 # ============================================ # Dify API 局域网访问地址 # ============================================ # 重要:此地址用于 KKFileView 下载文件 # 必须是 KKFileView 服务器能够访问到的 Dify API 地址 # # 格式:http://: # 示例:如果 Dify 部署在 192.168.1.100,API 端口是 5001 INTERNAL_FILES_URL=http://192.168.1.100:5001 # 或者如果使用 Nginx 反向代理(80端口) # INTERNAL_FILES_URL=http://192.168.1.100 # 或者如果配置了内网域名 # INTERNAL_FILES_URL=http://dify.internal.lan:5001 # ============================================ # 其他常用配置 # ============================================ # Console API URL(可选,通常不需要设置) # 如果设置了,会优先使用 INTERNAL_FILES_URL CONSOLE_API_URL= # Console Web URL(可选) CONSOLE_WEB_URL= # ============================================ # 配置验证 # ============================================ # # 在应用配置前,请验证网络连通性: # # 1. 在 KKFileView 服务器上测试 Dify API 是否可访问: # curl http://192.168.1.100:5001/health # # 2. 在 Dify 服务器上测试 KKFileView 是否可访问: # curl http://192.168.1.101:8012 # # 3. 确保防火墙已开放必要端口: # - Dify 服务器:5001 (API) # - KKFileView 服务器:8012 # # ============================================ # 完整配置示例 # ============================================ # # 网络拓扑: # ┌─────────────────────────────────────────┐ # │ 局域网 (192.168.1.0/24) │ # │ │ # │ ┌──────────────────────────────────┐ │ # │ │ Dify 服务器 (192.168.1.100) │ │ # │ │ - Nginx: 80 │ │ # │ │ - API: 5001 │ │ # │ │ - Web: 3000 │ │ # │ └──────────────────────────────────┘ │ # │ │ # │ ┌──────────────────────────────────┐ │ # │ │ KKFileView (192.168.1.101) │ │ # │ │ - Port: 8012 │ │ # │ └──────────────────────────────────┘ │ # │ │ # └─────────────────────────────────────────┘ # # 对应的环境变量: # KKFILEVIEW_URL=http://192.168.1.101:8012 # INTERNAL_FILES_URL=http://192.168.1.100:5001 # # ============================================ # 故障排查 # ============================================ # # 问题:预览时提示"文件下载失败" # # 检查步骤: # 1. 确认 INTERNAL_FILES_URL 配置正确(不能是 localhost) # 2. 在 KKFileView 服务器上测试: # curl http://192.168.1.100:5001/health # 3. 检查 Dify 日志: # docker-compose logs -f api # 4. 检查 KKFileView 日志 # 5. 确认防火墙规则允许访问