# 配置客户端

在使用客户端进行软件包发布、下载、远程管理，或在 Jenkins 流水线中进行自动构建等场景时，需提前完成客户端的相关配置。本文介绍如何设置客户端参数及配置安全证书，以确保功能正常运行与通信安全。

# 操作须知

Armory 客户端默认配置即可满足大多数使用场景，可执行 armory config ls 查看当前配置。以下配置项仅在特定场景下（如自动化构建、证书访问）才需调整，您可按需查阅。

# 前提条件

已 安装客户端。

# 操作步骤

1. 在开始搜索框或任意文件夹地址栏输入“cmd”，打开终端。

2. 在终端执行armory config set命令对客户端进行相关配置。

# 基础推荐配置

• 配置缓存路径（提升下载效率）

  armory config set localRepoCachePath=xxx
  

  配置后下载的软件包将被缓存至指定路径，已缓存内容可直接使用，避免重复下载。默认缓存路径为 ~/.armory/repository（Windows 系统中通常为 C:\Users\Administrator\.armory\repository）。若默认磁盘空间有限，可通过此配置将缓存目录重定向至其他磁盘。系统仅在目标磁盘剩余空间超过 4 GB 时启用缓存写入。若未配置或配置为空，则本地缓存功能将被禁用。

• 设置静默模式（禁用版本提示）

  armory config set silentMode=true
  

  启用后将关闭客户端版本更新提示，适用于 Jenkins 等非交互式场景，避免因提示信息影响任务执行。当不配置或设置为 false 时，将启用更新提示。默认不配置，即启用客户端版本更新提示。

# 高级配置（可选）

• 禁用进度条（适用于自动构建）

  armory config set disableProgressBar=true
  

  禁用后发布或下载软件包时将不显示进度条。推荐在不支持交互式输出的环境（如 Jenkins 流水线）中禁用，避免干扰自动化流程。当不配置或配置为 false 时，将启用进度条。默认不配置，即启用进度条。

• 自动展开文件夹

  armory config set autoExpandFolder=true
  

  启用后 armory.json 中 files 字段指定的文件夹将自动展开为子文件列表并逐一上传。适用于不希望手动配置所有文件时的简化操作。如果不配置或配置为 false，将禁用文件夹自动展开功能，此时 files 字段中指定的文件夹将以 .tar 包形式上传。

# 证书配置（如启用双向认证）

若服务端启用了证书认证机制，客户端需提供有效数字证书以完成身份校验。可通过以下步骤配置：

1. 将申请的数字证书（如 .p12 文件）下载并保存至本地。

2. 进入用户目录下的 .armory 文件夹（如 C:\Users\Administrator\.armory），使用文本编辑器打开 config.json 文件。

   

3. 在文件末尾，添加如下内容，完成证书配置。

     {
      "certs": [
         {
            "repo": "default",          //仓库别名（必填）
            "cert": "./cert/username.p12", //证书文件相对路径（必填）
            "passphrase": ""    //证书密码（可选）
         }
       ]
      }