Aliyun ECS 云服务器运维

管理阿里云ECS（弹性计算服务）实例。

首次使用 — 自动设置

当用户首次要求管理阿里云服务器时，按以下流程操作：

步骤 1：检查当前状态

{baseDir}/scripts/setup.sh --check-only

如果输出显示一切 OK（SDK 已安装、config 已配置、ECS 已就绪），跳到「调用格式」。

步骤 2：如果未配置，引导用户提供密钥

告诉用户：

> 我需要你的阿里云 API 密钥来连接 ECS 服务器。请提供：

> 1. AccessKey ID — 阿里云 API 密钥 ID

> 2. AccessKey Secret — 阿里云 API 密钥 Secret

>

> 你可以在 阿里云控制台 > 访问控制 > AccessKey管理 获取。

>

> ⚠️ 建议使用子账号，只授予ECS相关权限（ecs:*）

步骤 3：用户提供密钥后，运行自动设置

{baseDir}/scripts/setup.sh --access-key-id "<用户提供的AccessKeyId>" --access-key-secret "<用户提供的AccessKeySecret>"

脚本会自动：

• 检查并安装阿里云SDK（如未安装）
• 创建 ~/.aliyun/config.json 配置文件
• 写入 ECS 配置和密钥
• 验证连接

设置完成后即可开始使用。

调用格式

所有命令使用以下格式：

aliyun-ecs <command> [options]

或直接使用 Node.js 脚本：

node {baseDir}/src/index.js <command> [options]

工具总览

常用操作

获取地域列表

aliyun-ecs regions

实例管理

# 查询实例列表
aliyun-ecs list --region cn-hangzhou

# 查询指定实例
aliyun-ecs info --region cn-hangzhou --id i-xxxxxxxxxx

# 启动实例
aliyun-ecs start --region cn-hangzhou --id i-xxxxxxxxxx

# 停止实例
aliyun-ecs stop --region cn-hangzhou --id i-xxxxxxxxxx

# 重启实例
aliyun-ecs restart --region cn-hangzhou --id i-xxxxxxxxxx

监控与告警

# 获取监控数据（CPU、内存、网络）
aliyun-ecs monitor --region cn-hangzhou --id i-xxxxxxxxxx --metrics CPUUtilization,MemoryUtilization

# 支持的监控指标:
# CPUUtilization - CPU使用率
# MemoryUtilization - 内存使用率
# InternetInRate - 公网入带宽
# InternetOutRate - 公网出带宽
# DiskReadIOPS - 磁盘读IOPS
# DiskWriteIOPS - 磁盘写IOPS

快照管理

# 创建快照
aliyun-ecs snapshot create --region cn-hangzhou --id i-xxxxxxxxxx --name "backup-20260312"

# 列出快照
aliyun-ecs snapshot list --region cn-hangzhou --id i-xxxxxxxxxx

# 删除快照
aliyun-ecs snapshot delete --region cn-hangzhou --snapshot-id s-xxxxxxxxxx

# 回滚快照
aliyun-ecs snapshot rollback --region cn-hangzhou --id i-xxxxxxxxxx --snapshot-id s-xxxxxxxxxx

安全组（防火墙）

# 查询安全组规则
aliyun-ecs security-group list --region cn-hangzhou --group-id sg-xxxxxxxxxx

# 添加安全组规则（开放80端口）
aliyun-ecs security-group add --region cn-hangzhou --group-id sg-xxxxxxxxxx --port 80 --protocol tcp

# 删除安全组规则
aliyun-ecs security-group remove --region cn-hangzhou --group-id sg-xxxxxxxxxx --port 80 --protocol tcp

远程命令执行 (云助手)

# 在 Linux 实例上执行命令
aliyun-ecs exec --region cn-hangzhou --id i-xxxxxxxxxx --command "uptime && df -h && free -m"

# 在 Windows 实例上执行命令
aliyun-ecs exec --region cn-hangzhou --id i-xxxxxxxxxx --command "Get-Process | Sort-Object CPU -Descending | Select-Object -First 10" --windows

使用规范

1. Region 参数规则: 除 regions 外，所有操作都必须传入 --region 参数
2. 首次使用流程: 先调用 regions 获取地域列表 → 再调用 list 获取实例列表 → 记住 InstanceId 和 Region 供后续使用
3. 危险操作前先确认: 安全组修改、实例停止/重启、快照回滚等，先向用户确认
4. 错误处理: 如果调用失败，先用 setup.sh --check-only 诊断问题
5. 建议子账号: 为了安全，建议用户使用子账号AccessKey，只授予ECS相关权限