# 配置远程地址

在远程计算机上进行软件包管理时，建议先配置目标计算机地址，以便直接执行软件包管理相关命令。

# 操作须知

• 目前仅支持对运行 SylixOS 操作系统的远程计算机上的软件包进行管理。
• 目标计算机必须支持 Telnet 和 FTP 协议，以便进行远程登录和文件传输。

# 前提条件

• 已 安装客户端。
• 已获取目标计算机 IP 地址、登录用户名和密码信息。

# 操作步骤

# 配置远程地址

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

2. 在终端执行如下命令，配置远程计算机地址。可多次执行以添加多个远程地址，并在使用时根据需要切换目标地址。

   armory remote set <alias>=remote://<username>:<password>@<host>[:port][?ftpPort=21][&telnetPort=23]
   

   参数说明如下：

   参数	是否必选	说明
   alias	是	远程计算机别名，可按需自定义，例如 default、dev、test 等
   remote	是	虚拟请求协议，兼容 remote 和 ftp，新版本建议统一使用 remote，实际请求协议为 FTP & Telnet
   username	是	登录远程计算机的用户名
   password	是	登录远端计算机的密码
   host	是	远程计算机的 IP 地址
   port	否	远程计算机的端口号，等价于 ftpPort，不配置时默认为 21
   ftpPort	否	FTP 端口号，等价于 port，不配置时默认为 21
   telnetPort	否	Telnet 端口号，不配置时默认为 23

   此处以配置别名（alias）为“default”的远程计算机进行示例：

   armory remote set default="remote://root:***@10.12.**.**?ftpPort=21&telnetPort=23"
   
   # 回显如下内容，表示配置成功：
   Config added: remote.default = remote://root:cm9vdA***@10.12.**.**?ftpPort=21&telnetPort=23
   
   说明：

   • 如果使用默认端口号，则可以省略端口配置，直接执行armory remote set default=remote://root:***@10.12.**.**。
     也可仅指定 FTP 或 Telnet 端口号，如执行armory remote set default=remote://root:***@10.12.**.**:21或armory remote set default=remote://root:***@10.12.**.**?telnetPort=23。
   • 为确保 URL 可以正常解析，建议配置时将 URL 部分用双引号括起来。

3. 执行如下命令，可以查看所有配置的远程地址。其中激活状态为“active”的地址为当前正在使用的远程地址。

   armory remote ls
   
   

4. 如果要使用其他远程地址，则可以直接执行armory remote use <alias>切换至目标远程地址。或执行如下命令，通过键盘上下键选择目标远程地址，并按“Enter”键完成选择。

   armory remote use
   
   

# 删除远程地址

如果要删除已配置的远程计算机地址，则可以执行如下命令，将其删除。

armory remote rm <alias>

其中 alias 为远程计算机的别名。下面以删除别名为“dev”的远程计算机地址进行示例：

armory remote rm test

# 回显如下内容，表示删除成功：
Config removed remote.test