跳到正文
本页目录

配置

lip 有两个配置文件:用户配置,作用于 lip 为你做的一切;工作区配置,作用于一个工作区。

用户配置

文件位置

平台路径
Windows%APPDATA%\lip\config.toml
Linux / macOS$XDG_CONFIG_HOME/lip/config.toml(通常为 ~/.config/lip/config.toml)

该文件是一个 TOML 1.0 文件,包含 format = 4 和下列配置键的值,由以 TOML 编写的 JSON Schema config.schema.toml 描述;文件中没有的键取默认值,没有默认值时则没有值。首次使用 lip config set 设置值时,lip 会创建该文件:

toml
format = 4
github_proxy = "https://proxy.example.com"

没有 config.toml 时,同一目录中 lip v0.x 的 liprc.json 会被自动转换为 config.toml,随后被删除。

配置键

键类型默认值说明
github_proxystring?无lip 如何访问 GitHub 进行 git 请求与下载(发布资源)。URI,例如 https://proxy.example.com/:lip 通过该代理发送请求,代理请求失败时直接向 github.com 重试。空字符串(lip config set github_proxy ""):lip 直接连接 GitHub。未设置(lip config delete github_proxy):lip 同样直接连接 GitHub,但该键视为未配置。lip config set 会拒绝其他值,含有其他值的 config.toml 无效,此时所有键取默认值。
language"en"、"zh-Hans" 或 "zh-Hant"无交互界面的语言:英文、简体中文或繁体中文。未设置(lip config delete language):界面跟随系统的语言,系统语言既不是英文也不是中文时使用英文。命令始终以英文输出。

包直接从其 git 仓库解析和下载,无需配置任何包注册表或模块代理。

工作区配置

工作区配置是工作区中的 .lip/config.toml,一个包含 format = 4 和下列配置键的 TOML 文件,由 workspace-config.schema.toml 描述。在工作区中使用 lip config --workspace 管理它:

toml
format = 4
restart = "on-failure"

配置键

键类型默认值说明
restart"never" 或 "on-failure""never"工作区的服务器以非零退出码退出时是否重启:on-failure 时在 5 秒后重启,10 分钟内至多 5 次(参见 lip run)。

管理方式

使用 lip config 或交互界面管理配置值:用户配置在其设置页面,restart 在其服务器页面。