配置本地凭证--镜像仓库-火山引擎

文档中心

导航

镜像仓库

配置本地凭证

最近更新时间：2025.07.31 17:50:03首次发布时间：2025.07.31 17:50:03

获取 Maven 制品仓库的永久凭证或临时凭证后，需要将仓库凭证添加至本地环境的setting.xml文件中，才能正常访问制品仓库。本小节以在本地环境中配置永久凭证为例，为您介绍如何在本地的 Maven 配置文件中添加制品仓库的访问凭证。

前提条件

已注册火山引擎账号，并开通制品仓库服务。
已配置制品仓库的永久凭证，详情请参见配置永久访问凭证。
已在本地安装 Maven。

操作步骤

登录本地环境的命令行界面。
执行如下命令，进入 Maven 文件夹。

sudo cd ~/.m2

请将访问凭证复制并添加到settings.xml文件中。其中，<username>和 <password>为制品仓库的用户名和密码。

注意

settings.xml 文件中的一级标签 <settings>只能有 1 个。因此，如果您的 settings.xml 文件中已经有配置，请您仅复制下文中 <servers> </servers> 标记对的内容即可。

<settings>
  <servers>
    <server>
      <id>[REPOSITORY ID]</id>
      <username>[********] </username>
      <password>[********]</password>
    </server>
  </servers>
</settings>

配置项	说明
REPOSITORY ID	配置制品仓库实例的名称。可以在实例列表中查看实例的名称。
username	配置制品仓库实例的用户名。说明制品仓库的用户名为 username@userid 的格式，您可以在配置制品仓库永久凭证处，查看您的用户名。
password	配置制品仓库实例的密码。

保存文件，完成配置。