runpod-templates
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseOfficial Runpod templates
Runpod官方模板
Prefer an official template over building an image. Runpod maintains prebuilt
images for common workloads; deploying one is a create + poll, with no SSH install
step. This skill is the reference for what those images actually are. It does not
manage infrastructure — deploy with runpod-mcp (if connected) or runpodctl.
优先使用官方模板而非自行构建镜像。Runpod为常见工作负载维护预构建镜像;部署流程仅需创建+轮询,无需SSH安装步骤。本指南是这些镜像实际内容的参考文档。它不管理基础设施——请通过runpod-mcp(已连接时)或runpodctl进行部署。
Terms — "template" vs the Hub
术语区分——“模板”与Hub
Two different products share the word "Hub", and conflating them derails discovery:
| Term | What it is | Runs as | Discover with |
|---|---|---|---|
| Pod template (this skill) | A saved pod config — image + ports + disk + env. The official ones appear on Console Hub template pages ( | a pod | |
| Hub repo / listing | A packaged serverless worker (e.g. | serverless | |
Same word, disjoint catalogs: returns only the serverless worker
and none of the official ComfyUI pod templates, and returns no
Hub repos. In the REST v2 catalog, pod vs serverless templates are told apart by each
entry's flag.
hub search comfyuitemplate searchserverless有两款不同产品共享“Hub”一词,混淆二者会阻碍查找:
| 术语 | 定义 | 运行形式 | 查找方式 |
|---|---|---|---|
| Pod模板(本指南) | 保存的Pod配置——镜像+端口+磁盘+环境变量。官方模板显示在控制台Hub模板页面( | 以Pod运行 | |
| Hub仓库/列表 | 打包的无服务器工作节点(例如 | 以无服务器形式运行 | |
同一词汇,不同目录:仅返回无服务器工作节点,不会返回任何官方ComfyUI Pod模板;而不会返回Hub仓库。在REST v2目录中,Pod模板与无服务器模板可通过每个条目的标志区分。
hub search comfyuitemplate searchserverlessWhat "official" means, and how to find them
“官方”的定义及查找方式
A template is Runpod-maintained when it reports . Anything else in search
results is community-published: usable, but not covered by this skill and not
version-guaranteed.
isRunpod: truebash
runpodctl template list --type official # the whole official set (14 as of 2026-08-25)
runpodctl template search <name> # by name; check isRunpod: true
runpodctl template get <template-id> # image, ports, portsConfig, disk + full readmetemplate get⚠️ is not how you find pod templates — see Terms.
runpodctl hub ...To hand a user a Console link, use .
https://console.runpod.io/hub/template/<template-id>当模板标注时,说明该模板由Runpod维护。搜索结果中的其他模板均为社区发布:可使用,但不在本指南覆盖范围内,且版本无保障。
isRunpod: truebash
runpodctl template list --type official # 全部官方模板(截至2026-08-25共14个)
runpodctl template search <name> # 按名称搜索;需确认isRunpod: true
runpodctl template get <template-id> # 获取镜像、端口、端口配置、磁盘信息及完整自述文件template get⚠️ 并非查找Pod模板的方式——详见术语区分。
runpodctl hub ...如需向用户提供控制台链接,请使用。
https://console.runpod.io/hub/template/<template-id>REST v2 has no template search — only slices you filter yourself
REST v2无模板搜索功能——仅支持自行过滤分片
REST v2 has no query/search parameter for templates, so every "search" is a client-side
filter over a fetched slice:
| Endpoint | Params | Returns |
|---|---|---|
| | the public catalog slice |
| none | only templates you own |
| — | one template, owned or catalog |
officialverifiedcommunityrunpodctl template searchisRunpodsourceCatalog entries carry , which is the reliable way to pick between
CUDA-line variants of the same template — pair it with instead of inferring from the GPU name.
allowedCudaVersionsrunpodctl pod create --min-cuda-versionREST v2没有针对模板的查询/搜索参数,因此所有“搜索”操作均需在客户端对获取的分片进行过滤:
| 端点 | 参数 | 返回内容 |
|---|---|---|
| | 公开目录分片 |
| 无 | 仅返回您拥有的模板 |
| — | 单个模板(自有或目录中的模板) |
**(14个)和(3个)模板可完整枚举;模板上限为100个,且明确不支持分页。**超过该上限的社区模板不会进入API返回的分片,读取的也是相同的服务器端分片——因此也无法查看上限之外的模板。如果用户提及一个您找不到的模板,请向他们索要模板ID,而非直接判定该模板不存在。
officialverifiedcommunityrunpodctl template searchisRunpodsource目录条目包含****字段,这是选择同一模板不同CUDA版本变体的可靠方式——将其与配合使用,而非通过GPU名称推断。
allowedCudaVersionsrunpodctl pod create --min-cuda-versionThe templates
模板列表
| Workload | Reference | Deploy walkthrough |
|---|---|---|
| ComfyUI — image generation UI at a URL | | golden path 02, variant B |
| PyTorch — general GPU base / dev box (2.1 → 2.9, incl. cluster + ROCm builds) | | golden path 06 |
| Ubuntu — bare 20.04 / 22.04 / 24.04 (CPU category) | TODO | — |
| Network storage file browser (GPU + CPU) | TODO | golden path 07 |
Add a template by adding one file here and one row above. Do not create a new skill
per template — the task shape is identical and every registered skill costs context in
every session.
| 工作负载 | 参考文档 | 部署演练 |
|---|---|---|
| ComfyUI — 可通过URL访问的图像生成UI | | 黄金路径02,变体B |
| PyTorch — 通用GPU基础/开发环境(2.1 → 2.9,包含集群及ROCm构建版本) | | 黄金路径06 |
| Ubuntu — 纯净20.04 / 22.04 / 24.04(CPU类别) | TODO | — |
| 网络存储文件浏览器(GPU + CPU) | TODO | 黄金路径07 |
添加模板时,需在此处添加一个文件并在上方表格中添加一行。请勿为每个模板创建新指南——任务流程完全相同,且每个注册的指南都会占用会话上下文。
How to use a template reference
如何使用模板参考文档
Each file under answers the same questions in the same order, so an agent
can skim to the one it needs:
reference/- Identity — template name, id, image, upstream source repo.
- Variants — CUDA/arch/GPU-generation splits and which to pick.
- Ports and credentials — what is exposed and any default login.
- Autostart — what is already running on boot, with the exact command.
- Paths — where the app, its config, and its data live (and what a network volume mount changes).
- Readiness — how long first boot takes and the exact signal for "actually
serving". is never the signal.
Running - What does not ship — the gap between "booted" and "usable", and how to close it programmatically rather than by clicking.
- Sizing — container disk and minimum VRAM.
- Version pinning — how to hold a known-good version.
reference/- 标识信息 — 模板名称、ID、镜像、上游源仓库。
- 变体版本 — CUDA/架构/GPU代际的分支及选择建议。
- 端口与凭据 — 暴露的内容及默认登录信息。
- 自动启动 — 启动时已运行的服务及确切命令。
- 路径信息 — 应用、配置及数据的存储位置(以及挂载网络卷后的变化)。
- 就绪状态 — 首次启动所需时间及“实际已就绪”的确切信号。状态绝非就绪信号。
Running - 未包含内容 — “已启动”与“可使用”之间的差距,以及通过编程方式而非点击操作填补差距的方法。
- 规格要求 — 容器磁盘空间及最小显存。
- 版本固定 — 如何锁定已知可用的版本。
Routing onward — this skill is the hub, not the destination
跳转指引——本指南是枢纽,而非最终目的地
A user asking about a template rarely wants the reference file itself; they want a
template deployed, fixed, or replaced. Land here, identify which, and hand off:
| The user wants to… | Send them to |
|---|---|
| Deploy a template end to end | the matching golden path in the table above (index) — live-verified runs with real commands |
| Fix a pod that won't serve ("Running" but URL dead, 404/502) | the template's reference file, §Readiness — then |
| Fix a ComfyUI workflow whose models won't download (missing/broken model metadata, imported workflow or PNG) | the |
| Add models / files to a running template pod | the template's reference file (§What does not ship), or |
| Customize beyond what the template ships (pinned versions, extra nodes, lighter image) | |
| A serverless worker, not a pod | not a pod template — Hub workers via |
Reference files here answer what is in the image; they never duplicate a walkthrough or
a repair procedure — they point at the owner.
询问模板相关问题的用户很少只需要参考文档本身;他们通常想要部署、修复或替换模板。先定位到此处,确定用户需求,再跳转至对应内容:
| 用户需求 | 跳转至 |
|---|---|
| 端到端部署模板 | 上方表格中对应的黄金路径(索引)——经过实际验证的运行流程及真实命令 |
| 修复无法提供服务的Pod(显示“Running”但URL无法访问、出现404/502错误) | 模板参考文档的“就绪状态”章节——随后跳转至 |
| 修复无法下载模型的ComfyUI工作流(模型元数据缺失/损坏、导入的工作流或PNG文件有问题) | ** |
| 向运行中的模板Pod添加模型/文件 | 模板参考文档的“未包含内容”章节,或使用 |
| 自定义模板未包含的内容(固定版本、额外节点、轻量化镜像) | |
| 无服务器工作节点而非Pod | 不属于Pod模板范畴——通过 |
此处的参考文档回答的是镜像中包含什么;绝不会重复演练流程或修复步骤——只会指向对应的负责文档。