rainyun-cli

A small, automation-safe CLI for RainYun cloud APIs.

Install

npm install -g rainyun-cli

For local development:

bun install
bun run dev -- --help

For a Node-compatible release build:

npm run build
npm link

Authentication

Use an API key from the RainYun console.

rainyun auth login
rainyun auth status

For CI, prefer an environment variable:

RAINYUN_API_KEY=... rainyun rcs list --json

Local config is stored at:

$XDG_CONFIG_HOME/rainyun-cli/config.json

or ~/.config/rainyun-cli/config.json when XDG_CONFIG_HOME is not set.

Commands

Core:

rainyun auth login
rainyun auth status
rainyun config path
rainyun doctor --json
rainyun status --json
rainyun raw GET /product/rcs/

Cloud servers and firewall:

rainyun rcs list
rainyun rcs detail <id>
rainyun rcs plans
rainyun rcs os
rainyun rcs create --file body.json --yes
rainyun rcs reboot <id>
rainyun rcs poweron <id>
rainyun rcs poweroff <id>
rainyun rcs free <id> --yes
rainyun rcs renew <id> --duration 1 --yes
rainyun rcs renew-option <id> --auto true
rainyun rcs firewall list <id>
rainyun rcs firewall add <id> --action ACCEPT --protocol tcp --dest-port 443
rainyun rcs firewall update <id> <rule-id> --action DROP --protocol tcp --dest-port 22
rainyun rcs firewall delete <id> <rule-id> --yes
rainyun firewall list <id>

Cloud Apps:

rainyun rca regions
rainyun rca activate --region-id <id>
rainyun rca projects list
rainyun rca projects create --name <name> --region-id <id> --disk-size 10 --yes
rainyun rca projects detail <id>
rainyun rca projects destroy <id> --yes
rainyun rca projects ip list <id>
rainyun rca projects sftp <id> --username <name> --password <password>
rainyun rca projects backup-target <id> --type local
rainyun rca raindrop balance
rainyun rca raindrop usage
rainyun rca raindrop plans
rainyun rca app-template create --name <name> --title <title> --description <text>

Other product groups:

rainyun rgs list
rainyun rgs detail <id>
rainyun rgs start <id> --yes
rainyun rgs firewall list <id>
rainyun rvh list
rainyun rbm list
rainyun ros instances list
rainyun ros buckets list
rainyun ros buckets create <name> --instance <id>
rainyun cdn list
rainyun domain list
rainyun domain dns add <id> --host @ --type A --value 203.0.113.10
rainyun ssl list
rainyun ssl upload --cert cert.pem --key key.pem
rainyun renew points rcs <id> --days 30 --yes

Add --json to data-returning commands for machine-readable output. Commands backed by uncertain or complex RainYun request bodies use --file body.json or print an explicit raw hint instead of guessing private API behavior.

Environment

• RAINYUN_API_KEY: API key, overrides local config
• RAINYUN_BASE_URL: API base URL, defaults to https://api.v2.rainyun.com
• NO_COLOR: disable ANSI colors