指南 · 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 分鐘出結果。