安装与配置mgwutil-在线迁移服务-阿里云

当您需要使用命令行调用在线迁移服务时，可以使用mgwutil工具。mgwutil支持在Windows、Linux、macOS等系统中运行，您可以根据实际环境下载和安装合适的版本。

安装mgwutil

版本

当前版本： 1.0

下载地址

操作系统	系统架构	下载地址	SHA256校验和
Linux	x86_64	mgwutil-1.0-linux-amd64	9b6bc7f086bf9c562eb626ecd568c440a47857881df76d6263c05cc4a2c6eea9
Linux	arm64	mgwutil-1.0-linux-arm64	a512bf450ef7442d1c65fbbcf408b3d51f1cf9f80974b627ef6ffb109fec1836
macOS	x86_64	mgwutil-1.0-darwin-amd64	7881c32f6e35864a42e006c459354489998bfaf169e98834e95cc8971d13c623
macOS	arm64	mgwutil-1.0-darwin-arm64	aeba4d3082c108a8703e45d4c94c97047e22f781451e3d6b966115768614695b
Windows	x86_64	mgwutil-1.0-windows-amd64	1275e7312f5362f655e83d43a3d2e0cfb87461475f3a908238205986ec248d01
Windows	arm64	mgwutil-1.0-windows-arm64	c0d553239ae204a683d52db41f2a5ac86511c477eb3573e075a22c2161f7f47e

下载并安装mgwutil

Linux

安装mgwutil。

sudo -v ; curl https://gosspublic.alicdn.com/data_online_migration/mgwutil/install.sh | sudo bash

验证是否成功安装mgwutil。
```
mgwutil -h
```
如果在屏幕中输出mgwutil所有支持的命令，则表明已成功安装mgwutil。

Windows

安装mgwutil。
1. 单击下载链接下载Windows安装包。
2. 将工具解压，并双击运行mgwutil.bat文件。

验证是否成功安装mgwutil。

mgwutil -h

如果在屏幕中输出mgwutil所有支持的命令，则表明已成功安装mgwutil。

macOS

安装mgwutil。

sudo -v ; curl https://gosspublic.alicdn.com/data_online_migration/mgwutil/install.sh | sudo bash

验证是否成功安装mgwutil。

mgwutil -h

如果在屏幕中输出mgwutil所有支持的命令，则表明已成功安装mgwutil。

配置mgwutil

通过auth-config命令进行快速配置

Linux

输入配置命令。
```
mgwutil auth-config
```
输入上述命令后屏幕会提示输入以下信息。

please input Access Key (AK): 
please input Secret Key (SK): 
please input Mgw Endpoint: 
please input Primary User ID:

重要

AKSK必须具有AliyunOSSImportFullAccess权限。
Mgw Endpoint 域名需根据各区域的服务接入点文档配置。

请根据提示依次输入相关信息。输入完成后，系统将自动保存配置至 ~/.mgwutilconfig，供后续操作在线迁移服务默认使用。

Windows

输入配置命令。
```
mgwutil auth-config
```
输入上述命令后屏幕会提示输入以下信息
```
please input Access Key (AK): 
please input Secret Key (SK): 
please input Endpoint: 
please input User ID: 
```
重要
AKSK必须具有AliyunOSSImportFullAccess权限。
请根据提示依次输入相关信息。输入完成后，系统将自动保存配置至 C:\\Users\user\.mgwutilconfig，供后续操作在线迁移服务默认使用。

macOS

输入配置命令。
```
mgwutil auth-config
```
输入上述命令后屏幕会提示输入以下信息

please input Access Key (AK): 
please input Secret Key (SK): 
please input Mgw Endpoint: 
please input Primary User ID:

重要

AKSK必须具有AliyunOSSImportFullAccess权限。
Mgw Endpoint 域名各区域请参考服务接入点。

请根据提示依次输入相关信息。输入完成后，系统将自动保存配置至 ~/.mgwutilconfig，供后续操作在线迁移服务默认使用。

通过命令行选项动态配置

除了通过命令配置文件外，您还可以使用命令行参数设置相关的配置。命令行选项的优先级要高于命令配置文件。常用命令行选项如下：

选项	说明	示例代码
-e, --endpoint	服务接入地址。	`mgwutil commandname options -e http://cn-hangzhou.mgw.aliyuncs.com`
-i, --access-key-id	访问密钥 ID。	`mgwutil commandname options -i your_access_key`
-k, --access-key-secret	访问密钥。	`mgwutil commandname options -k your_access_key_secrect`
-u, --userid	在线服务对应的主账号ID。	`mgwutil commandname options -u your_userid`

通过环境变量配置

除了通过配置文件或命令行参数进行动态配置外，您还可以使用环境变量来设置关键参数。

环境变量的优先级在三种配置方式中最低（即：命令行参数 > 配置文件 > 环境变量），仅在未通过更高优先级方式指定时生效。

支持的环境变量列表

环境变量名	说明	示例值
`MGW_USERID`	用户唯一标识（UserID）	`166645905*2`
`MGW_ENDPOINT`	服务接入地址（Endpoint）	`https://cn-hangzhou.mgw.aliyuncs.com`
`MGW_ACCESSKEYID`	访问密钥 ID（AccessKey ID）	`AK*******`
`MGW_ACCESSKEYSECRET`	访问密钥 Secret（AccessKey Secret）	`SK**********`

配置步骤

Linux

在 Shell 中导出环境变量（临时生效）。

export MGW_USERID=<your userid>
export MGW_ENDPOINT=<your endpoint>
export MGW_ACCESSKEYID=<your access key>
export MGW_ACCESSKEYSECRET=<your access key secret>

验证环境变量是否生效。

printenv | grep MGW_

（可选）持久化环境变量。
若需永久生效，可将 export 语句添加到 Shell 配置文件中（谨慎操作，避免泄露密钥）：

# 仅限开发/测试环境！生产环境请使用更安全的方式
echo 'export MGW_ACCESSKEYSECRET="your_secret"' >> ~/.bashrc
source ~/.bashrc

Windows

设置临时环境变量（仅当前 CMD 窗口有效）。

set MGW_USERID=<YOUR-USERID>
set MGW_ENDPOINT=https://cn-hangzhou.mgw.aliyuncs.com
set MGW_ACCESSKEYID=******
set MGW_ACCESSKEYSECRET==******

验证是否生效。

set MGW_

macOS

在 Shell 中导出环境变量（临时生效）。

export MGW_USERID=<your userid>
export MGW_ENDPOINT=<your endpoint>
export MGW_ACCESSKEYID=<your access key>
export MGW_ACCESSKEYSECRET=<your access key secret>

验证环境变量是否生效。

printenv | grep MGW_

（可选）持久化环境变量。
若需永久生效，可将 export 语句添加到 Shell 配置文件中（谨慎操作，避免泄露密钥）：

# 仅限开发/测试环境！生产环境请使用更安全的方式
echo 'export MGW_ACCESSKEYSECRET="your_secret"' >> ~/.bashrc
source ~/.bashrc