教程：使用文件系统目录搭建 kmpkg 二进制缓存

你并非只能将默认二进制缓存位置作为唯一的本地二进制缓存，还可以将多个文件系统位置配置为二进制缓存。你甚至可以为特定缓存设置不同的权限，例如只读、只写或读写权限。

所有二进制缓存均通过 KMPKG_BINARY_SOURCES 环境变量配置。该变量的值需遵循特定的配置语法。

前提条件

• 终端
• kmpkg

1 - 创建二进制缓存目录

使用 files 后端时，你可以将文件系统目录（包括网络位置）用于存储二进制包。

本教程中，你将创建两个二进制缓存位置：一个具备读写权限，另一个仅具备只读权限。

创建这两个二进制缓存位置（可替换为任意你选择的路径）：

cmd

mkdir D:\kmpkg\binary-cache
mkdir \\remote\shared\kmpkg\binary-cache

bash

mkdir /home/kmpkg/binary-cache
mkdir /mnt/remote/shared/kmpkg/binary-cache

2 - 配置 KMPKG_BINARY_SOURCES

接下来按如下方式设置 KMPKG_BINARY_SOURCES 的值：

powershell

$env:KMPKG_BINARY_SOURCES="clear;files,\\remote\shared\kmpkg\binary-cache,read;files,D:\kmpkg\binary-cache,readwrite"

cmd

set "KMPKG_BINARY_SOURCES=clear;files,\\remote\shared\kmpkg\binary-cache,read;files,D:\kmpkg\binary-cache,readwrite"

cmd-powershell

该 KMPKG_BINARY_SOURCES 配置包含以下源字符串：

• clear：禁用所有先前配置的二进制缓存，本示例中即禁用默认二进制缓存。
• files,\\remote\shared\kmpkg\binary-cache,read：设置基于 files 文件系统后端的二进制缓存，路径为 \\remote\shared\kmpkg\binary-cache，权限为只读（read 为默认权限）。
• files,D:\kmpkg\binary-cache,readwrite：设置第二个基于文件系统的二进制缓存，路径为 D:\kmpkg\binary-cache，权限为读写（readwrite）。

bash

export KMPKG_BINARY_SOURCES="clear;files,/mnt/remote/shared/kmpkg/binary-cache,read;files,/home/kmpkg/binary-cache,readwrite"

该 KMPKG_BINARY_SOURCES 配置包含以下源字符串：

• clear：禁用所有先前配置的二进制缓存，本示例中即禁用默认二进制缓存。
• files,/mnt/remote/shared/kmpkg/binary-cache,read：设置基于 files 文件系统后端的二进制缓存，路径为 /mnt/remote/shared/kmpkg/binary-cache，权限为只读（read 为默认权限）。
• files,/home/kmpkg/binary-cache,readwrite：设置第二个基于文件系统的二进制缓存，路径为 /home/kmpkg/binary-cache，权限为读写（readwrite）。

后续步骤

基于 NuGet 源搭建二进制缓存

你可尝试完成以下后续操作：

• 修改默认二进制缓存位置
• 基于 NuGet 源搭建二进制缓存
• 在 GitHub Actions 工作流中通过 GitHub Packages 搭建二进制缓存