dify-1.8.1/docker/kkfileview-lan.env.example

# 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服务器IP>:<API端口>
# 示例：如果 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. 确认防火墙规则允许访问