跳转到内容

Filesystem

目录和嵌入式文件系统访问。

Kind描述
fs.directory基于目录的文件系统
fs.embed只读嵌入式文件系统
- name: uploads
kind: fs.directory
directory: "/var/data/uploads"
auto_init: true
mode: "0755"
字段类型默认值描述
directorystringrequired根路径
auto_initboolfalse目录不存在时自动创建
modestring0755Unix 权限模式(八进制)

mode 限制所有文件操作。当存在读取位时,执行位会自动添加。

路径会被规范化和验证。无法访问配置的根目录之外的文件。
- name: static
kind: fs.embed

嵌入式文件系统使用 entry ID 从 pack 资源加载。它们是只读的。

嵌入式文件系统是内部机制。通常不需要手动配置。

两种文件系统类型都实现:

操作目录嵌入式
Open/Read
Stat
ReadDir
OpenFile (write)
Remove
Mkdir

对嵌入式文件系统的写操作会返回错误。

参见 Filesystem 模块 了解文件操作。