配置

vfox 允许你修改一些配置, 所有配置信息都存放在$HOME/.version-fox/config.yaml文件中。

注意

如果你是首次运行vfox, 则会自动创建一个空的 config.yaml 文件。

兼容版本文件 >= 0.4.0

插件 支持 读取其他版本管理器的配置文件, 例如: Nodejs 的nvm的.nvmrc文件, Java 的SDKMAN的.sdkmanrc文件等。

此能力默认是关闭的, 如果你想开启, 请按照以下方式配置:

legacyVersionFile:
  enable: true

WARNING

1. 如果目录里同时存在.tool-versions和其他版本管理器的配置文件(.nvmrc, .sdkmanrc等), vfox 优先加载.tool-versions文件.
2. 开启此功能可能会导致vfox刷新环境变量时略微变慢, 请根据自己的需求开启。

代理设置

注意

当前仅支持 http(s)代理协议

格式: http[s]://[username:password@]host:port

proxy:
  enable: false
  url: http://localhost:7890

存储路径

vfox默认将 SDK 缓存文件存储在$HOME/.version-fox/cache目录下。

!!!

在配置之前， 请确保vfox有文件夹的写权限。⚠⚠⚠

storage:
  sdkPath: /tmp

插件注册表地址

vfox默认从vfox-plugins.lhan.me检索插件。

如果你想要使用自己的索引仓库或第三方镜像仓库,可以按照以下方式配置:

registry:
  address: "https://vfox-plugins.lhan.me"

可用镜像

• https://gitee.com/version-fox/vfox-plugins/raw/main/plugins
• https://cdn.jsdelivr.net/gh/version-fox/vfox-plugins/plugins
• https://rawcdn.githack.com/version-fox/vfox-plugins/plugins

缓存 >= 0.5.0

vfox 默认会缓存search命令的结果, 以减少网络请求次数。默认缓存时间为12h。

特殊值

• -1: 永不过期
• 0: 不进行缓存

cache:
  availableHookDuration: 12h # s 秒, m 分钟, h 小时

缓存文件路径

$HOME/.version-fox/plugins/<plugin-name>/available.cache

Config 命令 >= 0.4.0

设置，查看配置

用法

vfox config [<key>] [<value>]

vfox config proxy.enable true
vfox config proxy.url http://localhost:7890
vfox config storage.sdkPath /tmp

key：配置项，以.分割。 value：不传为查看配置项的值。

选项

• -l, --list：列出所有配置。
• -un, --unset：删除一个配置。