zededa/zcli

ZEDEDA Command Line Interface (CLI) 是与ZEDEDA边缘计算平台交互的命令行工具，支持边缘设备管理、应用部署、监控及配置操作，提供便捷的命令行操作界面。

0 次下载activezededa镜像

ZEDEDA Command Line Interface 镜像文档

镜像概述

ZEDEDA Command Line Interface (CLI) 镜像提供了与ZEDEDA边缘计算平台交互的命令行工具，旨在简化边缘设备管理、应用部署、资源监控和配置管理等操作。通过该镜像，用户可在命令行环境中高效管理边缘计算资源，无需图形界面即可完成复杂操作。

核心功能与特性

设备全生命周期管理：支持边缘设备注册、激活、状态查询、远程控制及固件更新
应用部署与管理：提供应用打包、部署至指定边缘设备、版本控制及卸载功能
实时监控与日志：获取设备性能指标（CPU/内存/网络）、应用运行状态及系统日志
配置管理：支持设备和应用配置文件的创建、更新、备份与恢复
安全认证集成：与ZEDEDA平台认证机制无缝对接，支持API令牌和OAuth2.0认证

使用场景

边缘运维人员：日常管理边缘设备集群，执行设备状态巡检、故障排查及批量操作
开发人员：测试边缘应用部署流程，验证应用在边缘环境中的运行效果
自动化流程集成：嵌入Shell/Python脚本，实现边缘资源管理的自动化（如定时备份配置、异常设备自动告警）

使用方法

前提条件

已注册ZEDEDA平台账号并获取API访问凭证（令牌或用户名/密码）
本地环境已安装Docker Engine（20.10+版本）

获取镜像

bash
docker pull zededa/cli:latest

初始化配置

首次使用需配置ZEDEDA平台连接信息，配置文件将保存在本地目录（建议持久化存储）：

bash
# 挂载本地目录存储配置文件，避免重复配置
docker run --rm -v ~/.zededa:/root/.zededa zededa/cli configure

根据交互提示输入以下信息：

ZEDEDA API端点URL（默认：[***]
认证方式（API令牌或用户名/密码）
可选：设置默认设备组、输出格式（json/table）

常用命令示例

1. 设备管理

bash
# 列出所有边缘设备
docker run --rm -v ~/.zededa:/root/.zededa zededa/cli device list

# 查看指定设备详情
docker run --rm -v ~/.zededa:/root/.zededa zededa/cli device get <device-id>

# 远程重启设备
docker run --rm -v ~/.zededa:/root/.zededa zededa/cli device reboot <device-id>

2. 应用部署

bash
# 部署应用至指定设备
docker run --rm -v ~/.zededa:/root/.zededa zededa/cli app deploy \
  --device <device-id> \
  --app-name edge-iot-demo \
  --version 1.2.0 \
  --image registry.zededa.com/iot-demo:1.2.0

# 查看设备上运行的应用
docker run --rm -v ~/.zededa:/root/.zededa zededa/cli app list --device <device-id>

3. 监控与日志

bash
# 获取设备CPU/内存使用率
docker run --rm -v ~/.zededa:/root/.zededa zededa/cli metrics get <device-id> --metrics cpu,memory

# 查看应用运行日志（最近100行）
docker run --rm -v ~/.zededa:/root/.zededa zededa/cli logs get <device-id> --app <app-name> --tail 100

环境变量配置

通过环境变量覆盖默认配置，适用于非交互式场景：

环境变量	描述	默认值
`ZEDEDA_API_URL`	ZEDEDA平台API端点URL	[***]
`ZEDEDA_TOKEN`	API认证令牌（优先级高于配置文件）	无
`ZEDEDA_CONFIG`	配置文件路径	/root/.zededa/config.yaml
`OUTPUT_FORMAT`	命令输出格式（json/table）	table

示例：使用环境变量直接执行命令（无需预配置）

bash
docker run --rm \
  -e ZEDEDA_API_URL=[***] \
  -e ZEDEDA_TOKEN=your-auth-token \
  -e OUTPUT_FORMAT=json \
  zededa/cli device list

持久化配置

为避免每次运行容器重新配置，建议通过挂载本地目录持久化配置文件：

bash
# 创建本地配置目录
mkdir -p ~/.zededa

# 后续所有命令均挂载该目录
docker run --rm -v ~/.zededa:/root/.zededa zededa/cli <command>

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

5

"Docker加速体验非常流畅，大镜像也能快速完成下载。"

常见问题

Q1:轩辕镜像免费版与专业版有什么区别？

免费版仅支持 Docker Hub 加速，不承诺可用性和速度；专业版支持更多镜像源，保证可用性和稳定速度，提供优先客服响应。

Q2:轩辕镜像免费版与专业版有分别支持哪些镜像？

免费版仅支持 docker.io；专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。

Q3:流量耗尽错误提示

当返回 402 Payment Required 错误时，表示流量已耗尽，需要充值流量包以恢复服务。

Q4:410 错误问题

通常由 Docker 版本过低导致，需要升级到 20.x 或更高版本以支持 V2 协议。

Q5:manifest unknown 错误

先检查 Docker 版本，版本过低则升级；版本正常则验证镜像信息是否正确。

Q6:镜像拉取成功后，如何去掉轩辕镜像域名前缀？

使用 docker tag 命令为镜像打上新标签，去掉域名前缀，使镜像名称更简洁。

查看全部问题→

轩辕镜像下载加速使用手册

探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式

登录仓库拉取

通过 Docker 登录认证访问私有仓库

Linux

在 Linux 系统配置镜像加速服务

Windows/Mac

在 Docker Desktop 配置镜像加速

Docker Compose

Docker Compose 项目配置加速

K8s Containerd

Kubernetes 集群配置 Containerd

宝塔面板

在宝塔面板一键配置镜像加速

群晖

Synology 群晖 NAS 配置加速

飞牛

飞牛 fnOS 系统配置镜像加速

极空间

极空间 NAS 系统配置加速服务

爱快路由

爱快 iKuai 路由系统配置加速

绿联

绿联 NAS 系统配置镜像加速

威联通

QNAP 威联通 NAS 配置加速

Podman

Podman 容器引擎配置加速

Singularity/Apptainer

HPC 科学计算容器配置加速

其他仓库配置

ghcr、Quay、nvcr 等镜像仓库

专属域名拉取

无需登录使用专属域名加速

需要其他帮助？请查看我们的常见问题或官方QQ群: 13763429

zcli Docker 镜像下载 - 轩辕镜像

zcli 镜像详细信息和使用指南

zcli 镜像标签列表和版本信息

zcli 镜像拉取命令和加速下载

zcli 镜像使用说明和配置指南

Docker 镜像加速服务 - 轩辕镜像平台

国内开发者首选的 Docker 镜像加速平台

极速拉取 Docker 镜像服务

相关 Docker 镜像推荐

热门 Docker 镜像下载

zcli 镜像详细信息

zcli 镜像标签列表

zcli 镜像使用说明

zcli 镜像拉取命令

Docker 镜像加速服务

轩辕镜像平台优势

镜像下载指南