Runpodctl 命令行工具：管理 GPU 容器、无服务器端点和 AI 模型部署

runpodctl by runpod/skills

216 周安装量

6 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/runpod/skills --skill runpodctl

AI/机器学习云服务命令行工具

🇨🇳中文介绍

Runpodctl

管理 GPU 容器、无服务器端点、模板、存储卷和模型。

拼写： "Runpod"（R 大写）。命令是 runpodctl（全小写）。

安装

# 任何平台（官方安装程序）
curl -sSL https://cli.runpod.net | bash

# macOS (Homebrew)
brew install runpod/runpodctl/runpodctl

# macOS (手动 — 通用二进制文件)
mkdir -p ~/.local/bin && curl -sL https://github.com/runpod/runpodctl/releases/latest/download/runpodctl-darwin-all.tar.gz | tar xz -C ~/.local/bin

# Linux
mkdir -p ~/.local/bin && curl -sL https://github.com/runpod/runpodctl/releases/latest/download/runpodctl-linux-amd64.tar.gz | tar xz -C ~/.local/bin

# Windows (PowerShell)
Invoke-WebRequest -Uri https://github.com/runpod/runpodctl/releases/latest/download/runpodctl-windows-amd64.zip -OutFile runpodctl.zip; Expand-Archive runpodctl.zip -DestinationPath $env:LOCALAPPDATA\runpodctl; [Environment]::SetEnvironmentVariable('Path', $env:Path + ";$env:LOCALAPPDATA\runpodctl", 'User')

确保 ~/.local/bin 在你的 PATH 环境变量中（将添加到或）。

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

794,900 周安装

Azure Data Explorer (Kusto) 查询技能：KQL数据分析、日志遥测与时间序列处理

107,900 周安装

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

107,800 周安装

Azure RBAC 权限管理工具：查找最小角色、创建自定义角色与自动化分配

104,600 周安装

runpodctl pod list                                    # 列出运行中的容器（默认，类似 docker ps）
runpodctl pod list --all                              # 列出所有容器，包括已退出的
runpodctl pod list --status exited                    # 按状态过滤（RUNNING, EXITED 等）
runpodctl pod list --since 24h                        # 过去 24 小时内创建的容器
runpodctl pod list --created-after 2025-01-15         # 在指定日期之后创建的容器
runpodctl pod get <pod-id>                            # 获取容器详细信息（包含 SSH 信息）
runpodctl pod create --template-id runpod-torch-v21 --gpu-id "NVIDIA GeForce RTX 4090"  # 从模板创建
runpodctl pod create --image "runpod/pytorch:1.0.3-cu1281-torch291-ubuntu2404" --gpu-id "NVIDIA GeForce RTX 4090"  # 使用镜像创建
runpodctl pod create --compute-type cpu --image ubuntu:22.04  # 创建 CPU 容器
runpodctl pod start <pod-id>                          # 启动已停止的容器
runpodctl pod stop <pod-id>                           # 停止运行中的容器
runpodctl pod restart <pod-id>                        # 重启容器
runpodctl pod reset <pod-id>                          # 重置容器
runpodctl pod update <pod-id> --name "new"            # 更新容器
runpodctl pod delete <pod-id>                         # 删除容器（别名：rm, remove）

列表标志： --all / -a, --status, --since, --created-after, --name, --compute-type 获取标志： --include-machine, --include-network-volume

创建标志： --template-id（如果没有 --image 则必需）, --image（如果没有 --template-id 则必需）, --name, --gpu-id, --gpu-count, --compute-type, --ssh（默认 true）, --container-disk-in-gb, --volume-in-gb, --volume-mount-path, --network-volume-id, --ports, --env, --cloud-type, --data-center-ids, --global-networking, --public-ip

列表标志： --include-template, --include-workers 更新标志： --name, --workers-min, --workers-max, --idle-timeout, --scaler-type (QUEUE_DELAY 或 REQUEST_COUNT), --scaler-value 创建标志： --name, --template-id, --gpu-id, --gpu-count, --compute-type, --workers-min, --workers-max, --network-volume-id, --data-center-ids

runpodctl template list                               # 官方 + 社区（前 10 个）
runpodctl template list --type official               # 所有官方模板
runpodctl template list --type community              # 社区模板（前 10 个）
runpodctl template list --type user                   # 你自己的模板
runpodctl template list --all                         # 所有内容，包括用户模板
runpodctl template list --limit 50                    # 显示 50 个模板
runpodctl template search pytorch                     # 搜索 "pytorch" 模板
runpodctl template search comfyui --limit 5           # 搜索，限制为 5 个结果
runpodctl template search vllm --type official        # 仅搜索官方模板
runpodctl template get <template-id>                  # 获取模板详细信息（包含 README, env, ports）
runpodctl template create --name "x" --image "img"    # 创建模板
runpodctl template create --name "x" --image "img" --serverless  # 创建无服务器模板
runpodctl template update <template-id> --name "new"  # 更新模板
runpodctl template delete <template-id>               # 删除模板

列表标志： --type (official, community, user), --limit, --offset, --all 创建标志： --name, --image, --container-disk-in-gb, --volume-in-gb, --volume-mount-path, --ports, --env, --docker-start-cmd, --docker-entrypoint, --serverless, --readme

🇺🇸English

Runpodctl

Manage GPU pods, serverless endpoints, templates, volumes, and models.

Spelling: "Runpod" (capital R). Command is runpodctl (lowercase).

Install

# Any platform (official installer)
curl -sSL https://cli.runpod.net | bash

# macOS (Homebrew)
brew install runpod/runpodctl/runpodctl

# macOS (manual — universal binary)
mkdir -p ~/.local/bin && curl -sL https://github.com/runpod/runpodctl/releases/latest/download/runpodctl-darwin-all.tar.gz | tar xz -C ~/.local/bin

# Linux
mkdir -p ~/.local/bin && curl -sL https://github.com/runpod/runpodctl/releases/latest/download/runpodctl-linux-amd64.tar.gz | tar xz -C ~/.local/bin

# Windows (PowerShell)
Invoke-WebRequest -Uri https://github.com/runpod/runpodctl/releases/latest/download/runpodctl-windows-amd64.zip -OutFile runpodctl.zip; Expand-Archive runpodctl.zip -DestinationPath $env:LOCALAPPDATA\runpodctl; [Environment]::SetEnvironmentVariable('Path', $env:Path + ";$env:LOCALAPPDATA\runpodctl", 'User')

Ensure ~/.local/bin is on your PATH (add export PATH="$HOME/.local/bin:$PATH" to ~/.bashrc or ~/.zshrc).

Quick start

runpodctl doctor                    # First time setup (API key + SSH)
runpodctl gpu list                  # See available GPUs
runpodctl template search pytorch   # Find a template
runpodctl pod create --template-id runpod-torch-v21 --gpu-id "NVIDIA GeForce RTX 4090"  # Create from template
runpodctl pod list                  # List your pods

API key: https://runpod.io/console/user/settings

Commands

Pods

runpodctl pod list                                    # List running pods (default, like docker ps)
runpodctl pod list --all                              # List all pods including exited
runpodctl pod list --status exited                    # Filter by status (RUNNING, EXITED, etc.)
runpodctl pod list --since 24h                        # Pods created within last 24 hours
runpodctl pod list --created-after 2025-01-15         # Pods created after date
runpodctl pod get <pod-id>                            # Get pod details (includes SSH info)
runpodctl pod create --template-id runpod-torch-v21 --gpu-id "NVIDIA GeForce RTX 4090"  # Create from template
runpodctl pod create --image "runpod/pytorch:1.0.3-cu1281-torch291-ubuntu2404" --gpu-id "NVIDIA GeForce RTX 4090"  # Create with image
runpodctl pod create --compute-type cpu --image ubuntu:22.04  # Create CPU pod
runpodctl pod start <pod-id>                          # Start stopped pod
runpodctl pod stop <pod-id>                           # Stop running pod
runpodctl pod restart <pod-id>                        # Restart pod
runpodctl pod reset <pod-id>                          # Reset pod
runpodctl pod update <pod-id> --name "new"            # Update pod
runpodctl pod delete <pod-id>                         # Delete pod (aliases: rm, remove)

List flags: --all / -a, --status, --since, --created-after, --name, --compute-type Get flags: --include-machine, --include-network-volume

Create flags: --template-id (required if no --image), --image (required if no --template-id), --name, --gpu-id, --gpu-count, --compute-type, --ssh (default true), --container-disk-in-gb, --volume-in-gb, , , , , , , ,

Serverless (alias: sls)

runpodctl serverless list                             # List all endpoints
runpodctl serverless get <endpoint-id>                # Get endpoint details
runpodctl serverless create --name "x" --template-id "tpl_abc"  # Create endpoint
runpodctl serverless update <endpoint-id> --workers-max 5       # Update endpoint
runpodctl serverless delete <endpoint-id>             # Delete endpoint

List flags: --include-template, --include-workers Update flags: --name, --workers-min, --workers-max, --idle-timeout, --scaler-type (QUEUE_DELAY or REQUEST_COUNT), --scaler-value Create flags: --name, --template-id, --gpu-id, , , , , ,

Templates (alias: tpl)

runpodctl template list                               # Official + community (first 10)
runpodctl template list --type official               # All official templates
runpodctl template list --type community              # Community templates (first 10)
runpodctl template list --type user                   # Your own templates
runpodctl template list --all                         # Everything including user
runpodctl template list --limit 50                    # Show 50 templates
runpodctl template search pytorch                     # Search for "pytorch" templates
runpodctl template search comfyui --limit 5           # Search, limit to 5 results
runpodctl template search vllm --type official        # Search only official
runpodctl template get <template-id>                  # Get template details (includes README, env, ports)
runpodctl template create --name "x" --image "img"    # Create template
runpodctl template create --name "x" --image "img" --serverless  # Create serverless template
runpodctl template update <template-id> --name "new"  # Update template
runpodctl template delete <template-id>               # Delete template

List flags: --type (official, community, user), --limit, --offset, --all Create flags: --name, --image, --container-disk-in-gb, --volume-in-gb, --volume-mount-path, --ports, --env, , , ,

Network Volumes (alias: nv)

runpodctl network-volume list                         # List all volumes
runpodctl network-volume get <volume-id>              # Get volume details
runpodctl network-volume create --name "x" --size 100 --data-center-id "US-GA-1"  # Create volume
runpodctl network-volume update <volume-id> --name "new"  # Update volume
runpodctl network-volume delete <volume-id>           # Delete volume

Create flags: --name, --size, --data-center-id

Models

runpodctl model list                                  # List your models
runpodctl model list --all                            # List all models
runpodctl model list --name "llama"                   # Filter by name
runpodctl model list --provider "meta"                # Filter by provider
runpodctl model add --name "my-model" --model-path ./model  # Add model
runpodctl model remove --name "my-model"              # Remove model

Registry (alias: reg)

runpodctl registry list                               # List registry auths
runpodctl registry get <registry-id>                  # Get registry auth
runpodctl registry create --name "x" --username "u" --password "p"  # Create registry auth
runpodctl registry delete <registry-id>               # Delete registry auth

Info

runpodctl user                                        # Account info and balance (alias: me)
runpodctl gpu list                                    # List available GPUs
runpodctl gpu list --include-unavailable              # Include unavailable GPUs
runpodctl datacenter list                             # List datacenters (alias: dc)
runpodctl billing pods                                # Pod billing history
runpodctl billing serverless                          # Serverless billing history
runpodctl billing network-volume                      # Volume billing history

SSH

runpodctl ssh info <pod-id>                           # Get SSH info (command + key, does not connect)
runpodctl ssh list-keys                               # List SSH keys
runpodctl ssh add-key                                 # Add SSH key

Agent note: ssh info returns connection details, not an interactive session. If interactive SSH is not available, execute commands remotely via ssh user@host "command".

File Transfer

runpodctl send <path>                                 # Send files (outputs code)
runpodctl receive <code>                              # Receive files using code

Utilities

runpodctl doctor                                      # Diagnose and fix CLI issues
runpodctl update                                      # Update CLI
runpodctl version                                     # Show version
runpodctl completion                                  # Auto-detect shell and install completion

URLs

Pod URLs

Access exposed ports on your pod:

https://<pod-id>-<port>.proxy.runpod.net

Example: https://abc123xyz-8888.proxy.runpod.net

Serverless URLs

https://api.runpod.ai/v2/<endpoint-id>/run        # Async request
https://api.runpod.ai/v2/<endpoint-id>/runsync    # Sync request
https://api.runpod.ai/v2/<endpoint-id>/health     # Health check
https://api.runpod.ai/v2/<endpoint-id>/status/<job-id>  # Job status

Weekly Installs

216

Repository

runpod/skills

GitHub Stars

First Seen

Feb 10, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykFail

Installed on

opencode209

codex208

gemini-cli207

github-copilot205

amp202

kimi-cli202

Runpodctl 命令行工具：管理 GPU 容器、无服务器端点和 AI 模型部署

🇨🇳中文介绍

Runpodctl

安装

相关 Skills

快速开始

命令

容器

无服务器（别名：sls）

模板（别名：tpl）

网络存储卷（别名：nv）

模型

注册表（别名：reg）

信息

SSH

文件传输

实用工具

URL

容器 URL

无服务器 URL

🇺🇸English

Runpodctl

Install

Quick start

Commands

Pods

Serverless (alias: sls)

Templates (alias: tpl)

Network Volumes (alias: nv)

Models

Registry (alias: reg)

Info

SSH

File Transfer

Utilities

URLs

Pod URLs

Serverless URLs

最新 Skills