设备管理

列出设备

pb devices list / pb devices

列出账户下的所有设备。也可以直接用 pb devices（不带子命令）。

示例：

pb devices

Text

CODE               STATUS         ONLINE   CONNECTED  STARTED_AT
IDY291LX6WW6RCW   running        yes      yes        2025-01-15T08:30:00Z
IDY2A0ZNVOR00ZK   stopped        no       -          -

JSON

{
  "code": 200,
  "data": {
    "devices": [
      {
        "id": "abc123",
        "device_code": "IDY291LX6WW6RCW",
        "plex_status": "running",
        "is_online": true,
        "connected": true,
        "started_at": "2025-01-15T08:30:00Z"
      }
    ]
  },
  "msg": "OK"
}

创建设备

pb devices create

创建新的云设备。

示例：

pb devices create

Text

✓ 设备已创建: IDY291LX6WW6RCW (creating)

JSON

{
  "code": 200,
  "data": {
    "device": {
      "id": "abc123",
      "device_code": "IDY291LX6WW6RCW",
      "status": "creating"
    }
  },
  "msg": "设备已创建"
}

启动设备

pb devices start [device_id]

启动已停止的设备。不传设备 ID 时使用当前连接的或默认设备。

参数	类型	必填	说明
device_id	string	否	设备 ID 或编号。默认使用已连接设备

示例：

pb devices start IDY291LX6WW6RCW

Text

✓ 设备 IDY291LX6WW6RCW: start (task_xxxx)

JSON

{
  "code": 200,
  "data": { "task_id": "task_xxxx" },
  "msg": "设备 IDY291LX6WW6RCW: start"
}

停止设备

pb devices stop [device_id]

停止运行中的设备。

参数	类型	必填	说明
device_id	string	否	设备 ID 或编号。默认使用已连接设备

示例：

pb devices stop IDY291LX6WW6RCW

重启设备

pb devices reboot [device_id] / pb reboot [device_id]

重启设备。也可以用顶级快捷命令 pb reboot [device_id]。

参数	类型	必填	说明
device_id	string	否	设备 ID 或编号。默认使用已连接设备

示例：

pb reboot IDY291LX6WW6RCW

恢复出厂设置

pb devices reset [device_id]

工厂重置设备，清除所有数据并恢复到初始状态。

参数	类型	必填	说明
device_id	string	否	设备 ID 或编号。默认使用已连接设备

DANGER

此操作不可逆。设备上的所有数据（已安装的应用、文件、设置）将被永久删除。

示例：

pb devices reset IDY291LX6WW6RCW

快照恢复

pb devices restore [device_id] --snapshot <snapshot_id>

从快照恢复设备。

参数	类型	必填	说明
device_id	string	否	设备 ID 或编号。默认使用已连接设备
--snapshot	string	是	要恢复的快照 ID

示例：

pb devices restore IDY291LX6WW6RCW --snapshot snap_abc123

Text

✓ 设备已恢复: IDY291LX6WW6RCW (task_xxxx)

JSON

{
  "code": 200,
  "data": { "task_id": "task_xxxx" },
  "msg": "设备已恢复: IDY291LX6WW6RCW"
}

删除设备

pb devices delete <device_id>

永久删除设备。

参数	类型	必填	说明
device_id	string	是	要删除的设备 ID 或编号

DANGER

此操作不可逆。设备及其所有关联数据将被永久删除。

示例：

pb devices delete IDY2A0ZNVOR00ZK

设备详情

pb devices info [device_id]

获取设备的详细信息。

参数	类型	必填	说明
device_id	string	否	设备 ID 或编号。默认使用已连接设备

示例：

pb devices info IDY291LX6WW6RCW

Text

Device:     IDY291LX6WW6RCW
Status:     running
Online:     yes
Started at: 2025-01-15T08:30:00Z
Spec:       4 CPU / 4096 MB RAM / 32768 MB Storage

JSON

{
  "code": 200,
  "data": {
    "id": "abc123",
    "device_code": "IDY291LX6WW6RCW",
    "plex_status": "running",
    "is_online": true,
    "started_at": "2025-01-15T08:30:00Z",
    "spec": { "cpu": 4, "memory": 4096, "storage": 32768 }
  },
  "msg": "OK"
}

任务历史

pb devices tasks [device_id]

查看设备的任务历史。

参数	类型	必填	说明
device_id	string	否	设备 ID 或编号。默认使用已连接设备

示例：

pb devices tasks IDY291LX6WW6RCW