配置管理

配置来源

Litefs 支持多种配置来源，按优先级从高到低排列：

代码配置 - 通过代码直接设置配置项
环境变量 - 通过环境变量设置配置（前缀：LITEFS_）
配置文件 - 通过 YAML、JSON 或 TOML 文件设置配置
默认配置 - 系统内置的默认值

配置项

配置项	类型	默认值	说明
`host`	str	`localhost`	服务器监听地址
`port`	int	`9090`	服务器监听端口
`debug`	bool	`false`	调试模式
`log`	str	`./default.log`	日志文件路径
`listen`	int	`1024`	服务器监听队列大小
`max_request_size`	int	`10485760`	最大请求体大小（字节，默认 10MB）
`max_upload_size`	int	`52428800`	最大上传文件大小（字节，默认 50MB）
`config_file`	str	`None`	配置文件路径
`session_backend`	str	`memory`	会话后端（memory/redis/database/memcache）
`session_expiration_time`	int	`3600`	会话过期时间（秒）
`session_name`	str	`litefs_session`	会话 cookie 名称
`session_secure`	bool	`环境感知`	是否使用安全 cookie（生产环境默认 True，开发环境默认 False）
`session_http_only`	bool	`true`	是否仅 HTTP 访问 cookie
`session_same_site`	str	`Lax`	SameSite 策略（Strict, Lax, None）
`cache_backend`	str	`tree`	缓存后端（memory, tree, redis, database, memcache）

环境感知配置

Litefs 支持环境感知配置，根据运行环境自动调整安全设置。

session_secure 配置

session_secure 配置项支持环境感知：

生产环境（debug=False）：默认 True，强制使用 HTTPS
开发环境（debug=True）：默认 False，允许 HTTP（便于本地开发）

from litefs.core import Litefs

# 生产环境 - session_secure 自动设置为 True
app = Litefs(
    host='0.0.0.0',
    port=8080,
    debug=False  # 生产环境
)

# 开发环境 - session_secure 自动设置为 False
app = Litefs(
    host='localhost',
    port=9090,
    debug=True  # 开发环境
)

# 强制指定（不推荐）
app = Litefs(
    host='0.0.0.0',
    port=8080,
    debug=False,
    session_secure=False  # 强制禁用（不安全）
)

安全建议：

生产环境必须使用 HTTPS 并设置 session_secure=True
开发环境可以使用 HTTP 和 session_secure=False
不要在生产环境强制设置 session_secure=False
系统会在不安全配置时发出警告

使用方法

代码配置

from litefs.core import Litefs

app = Litefs(
    host='0.0.0.0',
    port=8080,
    debug=True,
    max_request_size=20971520,
)

app.run()

配置文件

创建 config.yaml：

host: localhost
port: 9090
debug: false
log: ./default.log
listen: 1024
max_request_size: 10485760
max_upload_size: 52428800
session_backend: memory
session_expiration_time: 3600
session_name: my_session
session_secure: false
session_http_only: true
session_same_site: Lax
cache_backend: tree

使用配置文件：

from litefs.core import Litefs

app = Litefs(config_file='config.yaml')
app.run()

环境变量

export LITEFS_HOST=0.0.0.0
export LITEFS_PORT=8080
export LITEFS_DEBUG=true
export LITEFS_MAX_REQUEST_SIZE=20971520

配置管理

配置来源

配置项

环境感知配置

session_secure 配置

使用方法

代码配置

配置文件

环境变量

相关文档