指南 · Docker 与 Action

Docker 镜像和 GitHub Action 怎么被 AI 推荐?Docker Hub 与 Marketplace 页面实测

更新于 2026-11-12 · kagentx

短答案

2026-11-12 实测:Docker Hub 镜像页和 GitHub Marketplace 的 Action 页都是服务端直出的,README 全文在原始 HTML 里;meta description 分别是 Docker Hub 的短描述和 action.yml 的 description,都是你自己写的一句话。Docker Hub 的 robots.txt 没有禁止规则,GitHub 对 AI 爬虫的规则是 Crawl-delay: 1,没有整站禁止。Docker 官方规定短描述最多 100 个字符、分类最多 3 个,GitHub 官方要求 Action 名称唯一。AI 是否引用这两类页面,我们没有证据,未核实。

Docker Hub 的镜像页和 Marketplace 的 Action 页,是服务端直出的吗?

都是。2026-11-12 我们用 curl 取了 3 个页面(不执行脚本,User-Agent 是 Mozilla/5.0,没有模拟 AI 爬虫),正文都在原始 HTML 里:

页面HTTP 和大小title 和 meta description可见正文(去掉脚本后)
hub.docker.com/_/nginx200,524,903 字节title “nginx - Official Image | Docker Hub”;description 是短描述 “Official build of Nginx.”;有 canonical约 13,737 字符:README 全文、docker pull 和 docker run
hub.docker.com/r/grafana/grafana200,338,679 字节title “grafana/grafana - Docker Image”;description 是短描述 “The official Grafana docker container”;有 canonical约 1,614 字符:README 全文(API 里 full_description 只有 569 字符)、tag 摘要、docker pull、本周拉取数
github.com/marketplace/actions/checkout200,306,881 字节title “Checkout · Actions · GitHub Marketplace · GitHub”;description 和 action.yml 的 description 一字不差;有 canonical约 14,495 字符:README 的 Usage、输入说明、示例

三个页面都没有 JSON-LD。所以不执行脚本的爬虫也能读到这些页面;爬虫是否执行脚本的一般情况见 AI 爬虫会执行 JavaScript 吗?。

一个关键事实:这两类页面的 meta description 都是你自己写的一句话(Docker Hub 的短描述、action.yml 的 description),不是 README 的开头。这一句要自己写好。

Docker Hub 的 robots.txt 和 API 是什么样的?

检查项实测结果(2026-11-12)
hub.docker.com/robots.txt200,98 字节:User-agent: * 后 Disallow 为空,加一行 Sitemap 指向 cloudfront 上的 sitemap-index.xml;没有点名任何 AI 爬虫
hub.docker.com/sitemap.xml200,1,841 字节,是索引,子文件是 cloudfront 上的 sitemap-001.xml.gz 等,前几项 lastmod 是 2024-01-17;子文件里的内容未核实
hub.docker.com/v2/repositories/library/nginx/200,17,842 字节 JSON,无需登录;字段有 description(短描述)、full_description(16,434 字符)、star_count 21,421、pull_count 13,582,768,795、categories、last_updated
docs.docker.com/robots.txt200,116 字节:多一行 Content-Signal: ai-train=yes, search=yes, ai-input=yes;这是文档站的声明,不是 Docker Hub 的

同一个接口上,grafana/grafana 的 pull_count 是 5,386,765,446,categories 有三个:Security、Internet of things、Monitoring & observability。这些数字是 2026-11-12 取的,会变。

Docker Hub 官方对描述和分类有什么规定?

docs.docker.com 的仓库信息页(2026-11-12 读原文,页面没有日期):

项目官方说法
短描述最多 100 个字符;出现在 docker search 的结果里
概览(Overview)开启自动构建时,可以从仓库的 README.md 同步;支持基础 Markdown;页面没有写长度上限
分类最多选 3 个,代表镜像主要的使用场景;新仓库不会自动分配;自动分配只对 Verified Publisher 和 Docker 赞助的开源项目
找到的可能性页面写:清晰的仓库信息能让别人找到并用好你的镜像;分类让用户更容易按问题领域找内容

官方没有写这些字段怎么影响搜索排序或 AI 引用,所以那部分我们没有证据,未核实。README 的写法见 GitHub README 会被 AI 搜索引用吗?。

GitHub Marketplace 的 Action 页数据从哪来?

从仓库根目录的 action.yml。actions/checkout 的 action.yml(5,144 字节)里,name 是 Checkout,description 是 Checkout a Git repository at a particular version,下面每个 input 都有自己的 description 和 default。Marketplace 页的 meta description 就是那句 description。

name: 'Csv Lint'
description: 'Check CSV files for broken rows and fail the workflow'
inputs:
  path:
    description: 'Glob of CSV files to check, for example data/**/*.csv'
    default: '**/*.csv'
runs:
  using: 'node20'
  main: 'dist/index.js'
branding:
  icon: 'check-circle'
  color: 'green'

上面是写法示例:description 一句话写清「做什么、什么时候失败」,每个 input 写出例子值,因为这些文字会出现在页面和 README 里。

GitHub 官方的发布文档(2026-11-12 读原文,页面没有日期):

项目官方说法
名称action.yml 里的 name 必须唯一:不能和 Marketplace 已有的 action 同名,也不能和某个用户或组织同名(除非是该所有者发布)
分类选一个主分类(应当是能帮人找到你的那个),可选一个副分类
仓库结构每个仓库根目录只能有一个 action.yml 或 action.yaml;子文件夹里的不会自动上架
发布发布一个 release 即可;需要两步验证;满足条件后立即上架,GitHub 不审核
没写的description 和 branding 的要求、搜索排序都没有写

GitHub 的 robots.txt 里,GPTBot、OAI-SearchBot、ChatGPT-User、ClaudeBot、Claude-SearchBot、Claude-User、PerplexityBot、Perplexity-User 在同一个组:Crawl-delay: 1,没有 Disallow: /;/marketplace/ 下只有带 ?tab=readme、?tab=transparency 的网址有规则,Action 页本身没有被点到(这是读规则文字的结果,不是真实爬虫的访问)。

怎么一步一步让镜像和 Action 更容易被找到?

  1. 1. 短描述和 description 当成 meta description 来写

    Docker Hub 限 100 个字符,action.yml 的 description 没有限制但会成为 meta description:写「做什么、给谁用」,不写营销形容词。

  2. 2. README 开头放可以复制的命令

    镜像放 docker pull 和一个 docker run 例子,Action 放 uses: 一行和一个完整的 workflow 片段。两个页面都会把 README 直出给爬虫。

  3. 3. Docker Hub 选分类,Marketplace 选主分类

    Docker Hub 最多 3 个,新仓库不会自动分配,要自己选;Marketplace 选一个能帮人找到你的主分类。

  4. 4. 名称要唯一,且和官网一致

    Action 的 name 官方要求唯一;镜像的名字和官网、README 里写的一致,别让 AI 在不同页面看到不同的名字。

  5. 5. 官网写一页,链到两个页面

    官网写清用途、对比、版本和更新记录,再链到 Docker Hub 和 Marketplace 页。写法见 开发者文档怎么写,AI 才读得懂、引得到? 和 开源项目怎么被 AI 搜索推荐?README 以外的 6 个地方。

  6. 6. 隔几周用同一组问题再测

    问 ChatGPT、Perplexity「某某的 Docker 镜像哪个好」「有没有做某某的 GitHub Action」,每个问题问 3 次,记下有没有提到你、引用了哪些网址。MCP 服务器的镜像另见 MCP 服务器怎么被 AI 推荐、被连接器目录收录?,包仓库页见 npm、PyPI 上的包怎么被 AI 推荐?,robots.txt 写法见 AI 爬虫的 robots.txt 怎么写?。

同样放在 GitHub 上的 Home Assistant 自定义集成,HACS 的收录要求和公开页面实测见 Home Assistant 自定义集成怎么被 AI 搜索找到?。

常见问题

Docker Hub 的镜像页,爬虫不执行脚本也读得到吗?

读得到。2026-11-12 用 curl 取 nginx 和 grafana/grafana 的页面,都是 200,去掉脚本后分别约 13,737 和 1,614 个可见字符,里面有 README 全文、docker pull 命令和拉取数。

Docker Hub 页的 meta description 是什么?

是仓库的短描述。nginx 页是 “Official build of Nginx.”,grafana/grafana 页是 “The official Grafana docker container”。官方文档写明短描述最多 100 个字符,所以它要一句写完。

Docker Hub 的 robots.txt 拦 AI 爬虫吗?

没有。2026-11-12 实测 hub.docker.com/robots.txt 是 98 字节:User-agent: * 后 Disallow 为空,加一行 Sitemap。sitemap 里子文件的内容未核实。

GitHub Marketplace 的 Action 页 meta description 从哪来?

从 action.yml 的 description。actions/checkout 的页面 meta description 和 action.yml 里的 description 一字不差:Checkout a Git repository at a particular version。

Action 页读得到 README 吗?

读得到。2026-11-12 取 marketplace/actions/checkout,页面 306,881 字节,去掉脚本后约 14,495 个可见字符,含 Usage 小节和输入说明。

GitHub 的 robots.txt 对 AI 爬虫怎么写?

8 个 AI 相关的 User-Agent(GPTBot、OAI-SearchBot、ChatGPT-User、ClaudeBot、Claude-SearchBot、Claude-User、PerplexityBot、Perplexity-User)在同一个组,Crawl-delay: 1,没有 Disallow: /。/marketplace/ 下只有带 ?tab=readme 和 ?tab=transparency 的网址有规则,Action 页本身没有被点到。

Marketplace 的名称有什么要求?

官方文档写明 action.yml 里的 name 必须唯一,不能和 Marketplace 已有的 action 同名,也不能和某个用户或组织同名(除非是该所有者发布)。

Marketplace 搜索怎么排序?

官方文档没有写搜索排序,也没有写关键词规则,只说主分类用来帮助人们找到你的 action。AI 是否引用 Marketplace 页面,我们没有证据,未核实。

出处

kagentx

你的页面,爬虫读得到吗?
让评测告诉你

评测检查爬虫能不能进、正文是否直出,再把买家的问题拿去问 ChatGPT、Perplexity、Claude(开联网搜索),看有没有提到你。基础版 $1,一般 2–3 分钟出结果。