# GasFlux INI Configuration Guide

GasFlux 现在支持使用 INI 配置文件来管理路径和网络设置，提供更灵活的部署选项。

## 配置文件位置

GasFlux 会按以下顺序查找配置文件：
1. `gasflux.ini` (当前目录)
2. `config.ini` (当前目录)
3. `gasflux.ini` (项目根目录)

如果找不到配置文件，将使用默认值和环境变量。

## 配置示例

复制 `gasflux.ini.example` 为 `gasflux.ini` 并根据需要修改：

```ini
[server]
# 服务器配置
host = 0.0.0.0
port = 5000
debug = false
base_url = http://localhost:5000

[paths]
# 目录路径配置（相对于项目根目录或绝对路径）
uploads = ./web_api_data/uploads
outputs = ./web_api_data/outputs

[limits]
# 文件大小限制
max_content_length = 104857600  # 100MB

[logging]
# 日志配置
level = INFO
file = logs/gasflux_api.log

[security]
# 安全设置
admin_bootstrap_key = your_secret_key_here

[cleanup]
# 任务清理设置
task_cleanup_interval = 3600  # 1小时
max_task_age = 86400  # 24小时
janitor_dry_run = false

[performance]
# 性能调优
threads = 8
connection_limit = 100
channel_timeout = 300

[database]
# 数据库配置
path =

[api_keys]
# API密钥持久化设置
persist_backend = sqlite
```

## 配置说明

### [server] 服务器配置
- `host`: 服务器监听地址 (默认: 0.0.0.0)
- `port`: 服务器监听端口 (默认: 5000)
- `debug`: 调试模式 (默认: false)
- `base_url`: 对外访问的基础URL (默认: http://localhost:5000)

### [paths] 路径配置
- `uploads`: 上传文件存储目录 (默认: ./web_api_data/uploads)
- `outputs`: 计算结果输出目录 (默认: ./web_api_data/outputs)

路径可以是：
- 相对路径（相对于项目根目录）
- 绝对路径
- 支持 `~` 展开用户主目录

### [limits] 限制配置
- `max_content_length`: 最大文件上传大小，字节 (默认: 104857600 = 100MB)

### [logging] 日志配置
- `level`: 日志级别 (DEBUG, INFO, WARNING, ERROR, CRITICAL)
- `file`: 日志文件路径 (默认: logs/gasflux_api.log)

### [security] 安全配置
- `admin_bootstrap_key`: 管理员引导密钥，用于初始创建API密钥

### [cleanup] 清理配置
- `task_cleanup_interval`: 任务清理检查间隔，秒 (默认: 3600)
- `max_task_age`: 任务最大保留时间，秒 (默认: 86400)
- `janitor_dry_run`: 清理程序干运行模式，只记录不实际删除 (默认: false)

### [performance] 性能配置
- `threads`: 服务器线程数 (默认: 8)
- `connection_limit`: 连接限制 (默认: 100)
- `channel_timeout`: 通道超时，秒 (默认: 300)

### [database] 数据库配置
- `path`: SQLite数据库文件路径，为空则使用默认位置

### [api_keys] API密钥配置
- `persist_backend`: 任务持久化后端 (json/sqlite/both，默认: sqlite)

## 环境变量兼容性

所有配置项都可以通过环境变量覆盖，格式为 `GASFLUX_{SECTION}_{KEY}`，例如：
- `GASFLUX_SERVER_HOST=127.0.0.1`
- `GASFLUX_PATHS_UPLOADS=/custom/uploads`

环境变量优先级高于 INI 文件配置。

## 路径处理逻辑

1. **全局目录**: `uploads` 和 `outputs` 目录由 INI 配置决定
2. **任务子目录**: 每个任务在这些目录下创建 `{task_id}` 子目录
3. **YAML 配置**: 上传的 YAML 配置文件中的 `output_dir` 仍然可以覆盖全局设置

## 启动验证

启动时会显示配置信息：
```
Configuration loaded from: /path/to/gasflux.ini
Directories initialized - Upload: /path/to/uploads, Output: /path/to/outputs
```

## 示例配置

### 开发环境
```ini
[server]
host = 127.0.0.1
port = 5000
debug = true

[paths]
uploads = ./dev_uploads
outputs = ./dev_outputs

[logging]
level = DEBUG
```

### 生产环境
```ini
[server]
host = 0.0.0.0
port = 80
debug = false
base_url = https://api.example.com

[paths]
uploads = /data/gasflux/uploads
outputs = /data/gasflux/outputs

[logging]
level = INFO
file = /var/log/gasflux/api.log

[security]
admin_bootstrap_key = your_production_bootstrap_key
```