@gyro-hosting/cli

中文文档
1.39.0发布于 2026/11/16MPL-2.0零依赖构建来源已验证近 30 天下载 4690

Official command-line interface for Gyro Hosting (cloud servers, containers, DNS, S3 storage, mail, billing).

原始使用文档
文档目录5 节
  1. Install
  2. Getting started
  3. Türkçe
  4. Links
  5. Integrity

@gyro-hosting/cli — the gyro command for Gyro Hosting

gyro is the official command-line interface for Gyro Hosting. Every operation of the Gyro Public API is a command: cloud servers, containers, snapshots, SSH keys, load balancers, domains and DNS, S3 object storage, corporate mail, uptime monitoring, invoices, balance, support tickets and more.

This npm package ships the same signed binary as the GitHub release (Linux, macOS, Windows; x64 and arm64). No install scripts run: npm picks the matching @gyro-hosting/cli-<os>-<arch> package and a small Node launcher starts it.

Install

npm install -g @gyro-hosting/cli     # then: gyro --help
npx @gyro-hosting/cli --version       # run once without installing

Other ways to install:

MethodCommand
Script (Linux/macOS)curl -fsSL https://www.gyrohosting.com/cli/install.sh | sh
Scoop (Windows)scoop bucket add gyro https://github.com/Gyro-Hosting/scoop-bucket && scoop install gyro
Debian / RHEL.deb / .rpm from the release page
Dockerdocker run --rm -e GYRO_TOKEN ghcr.io/gyro-hosting/gyro server list

Getting started

gyro configure            # API key: Client area → account menu (top right) → API Credentials (wck_...)
gyro whoami
gyro plan list
gyro server create web-1 --plan standart-2-4 --region eu-de-1 --image ubuntu-24.04 \
     --ssh-key ~/.ssh/id_ed25519.pub --wait
gyro server list

In CI, set GYRO_TOKEN instead of running gyro configure. Output formats: -o table|json|yaml|text, --query (JMESPath). Money and destructive actions ask for confirmation (--yes in scripts); --dry-run shows the price or the request without changing anything.

Türkçe

npm install -g @gyro-hosting/cli
gyro configure   # API anahtarı: Müşteri paneli → hesap menüsü → API Kimlik Bilgileri
gyro server list

Integrity

Each platform binary is byte-identical to the archive in the GitHub release. The release checksum list gyro_<version>_SHA256SUMS is signed with the Gyro release key E96B E963 5E77 A0D9 119A C8C3 A798 6589 A154 B990, and the npm packages are published from GitHub Actions with npm provenance. Set GYRO_BINARY_PATH to run a binary of your own instead.

License: MPL-2.0

版本与发布记录

@gyro-hosting/cli 共发布 28 个版本,首次发布于 2026/11/14;过去 12 个月发布了 28 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.39.0latest2026/11/161 天前
1.38.02026/11/161 天前
1.37.32026/11/161 天前
1.37.22026/11/152 天前
1.37.12026/11/152 天前
1.37.02026/11/152 天前

关于 @gyro-hosting/cli 的常见问题

@gyro-hosting/cli 是什么?

Official command-line interface for Gyro Hosting (cloud servers, containers, DNS, S3 storage, mail, billing).

如何安装 @gyro-hosting/cli?

在项目目录运行 npm install @gyro-hosting/cli,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 gyro,可以用 npx gyro 直接运行。

@gyro-hosting/cli 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/gyro-hosting__cli 是否存在。

@gyro-hosting/cli 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=16。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@gyro-hosting/cli 可以商用吗?

@gyro-hosting/cli 使用 MPL-2.0 许可。弱 Copyleft:可以商用,也可以和闭源代码一起使用;但如果分发时修改了 MPL 授权的文件,这些文件的修改需以 MPL 开源。以上为概括,不构成法律意见,请以许可原文为准。

@gyro-hosting/cli 的下载量有多少?

根据 npm 官方下载统计,@gyro-hosting/cli 在 2026/10/17 – 2026/11/15 这 30 天内被下载 4,690 次,日均约 156 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gyro-hosting/cli 还在维护吗?

最新版本 1.39.0 发布于 2026/11/16(1 天前);至今共发布 28 个版本,其中过去 12 个月发布了 28 个;首次发布于 2026/11/14。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。