跳到正文
DEV Community· Antoine Laurent·· 2 天前精選AI 評分78

Ruby2Shell RCE 漏洞:如何檢查 Rails API 是否受影響

Vulnérabilité RCE dans Rails (Ruby2Shell) : comment vérifier si votre API est concernée

AI 導讀

Ruby2Shell(CVE-2026-132825)是 Ruby 字串大小寫轉換中的一字節堆積溢位漏洞,可能影響使用受影響 Ruby 版本的 Rails API。

推薦理由

文章整理 Ruby2Shell 的受影響及修補版本,並列出從生產環境核對 Ruby 到重建容器映像和重啟服務的處理流程。

正文 · 繁體中文

本週備受關注的 Rails RCE 漏洞是 Ruby2Shell(發現者將其寫作「Ruby2ßhell」),編號為 CVE-2026-132825 和 GHSA-34m4-m9fh-gqp5。這是 Ruby 字串大小寫轉換中的一個位元組堆積緩衝區溢位。研究人員表示,在標準 Rails 應用程式中,毋須驗證身份即可觸發此漏洞。如果你的 API 執行 Ruby 2.4.0 至 3.3.13、3.4.0 至 3.4.12,或 4.0.0 至 4.0.9,即受此漏洞影響。修補方法是將 Ruby 升級至 3.3.14、3.4.13 或 4.0.10,而非更新 gem。

今天就試用 Apidog

快速回答:我是否受影響?

  1. 在實際為 API 提供服務的環境(容器、VM 或 dyno)中執行 ruby -v,不要在手提電腦上執行。
  2. 如果版本落在上述三個範圍之一,即表示你受此漏洞影響。
  3. 升級 Ruby、重建每個映像檔、重新啟動每個應用程式伺服器,然後重新執行 API 測試。

Rails 的 Ruby2Shell RCE 漏洞是甚麼?

Ruby2Shell 是 Ruby 用來轉換字串大小寫的程式碼中,一個位於堆積的單位元組緩衝區溢位漏洞;涉及的編碼包括 ISO-8859-x 和 Windows-125x 等舊式單位元組編碼。Veria Labs 將其評為嚴重,並指出網絡上的攻擊者毋須驗證身份即可觸發此漏洞;按其説法,採用預設設定的傳統 Rails 和 Sinatra 應用程式均受影響。

根本原因非常簡單。大多數單位元組編碼都沒有德文小寫字母「ß」的大寫形式,因此將它轉為大寫時會寫入兩個位元組「SS」。執行這項操作的迴圈只檢查是否有空間寫入一個位元組。Ruby 會按輸入長度加 20 個位元組配置輸出緩衝區,因此根據 Veria 的報告,包含 21 個「ß」字元的輸入會令緩衝區溢出一個位元組。

Diagramme du bug Ruby2Shell : une chaîne d'entrée de caractères eszett s'étend en deux caractères S chacun, et le dernier S atterrit un octet au-delà de la fin du tampon de sortie

透過 upcase、swapcase、downcase(:fold) 和 casecmp? 可觸發此溢位。UTF-8 字串會走另一條程式碼路徑,因此不受影響。Ruby 自 2.4.0 版起便存在此錯誤。

Ruby 於 2026 年 11 月 18 日發布了安全公告,同時公佈正規表示式引擎和字串大小寫轉換中的另外六個漏洞。Ruby 表示,已知有概念驗證程式利用此漏洞,在「某些情境」下達成遠端程式碼執行(RCE)。Veria Labs 表示,自己是首個在標準 Rails 應用程式上展示 RCE 的團隊,並計劃於 2026 年 11 月 25 日發布漏洞利用程式;若大型供應商屆時仍未推出修補程式,則會延後發布。

這個日期才是你真正的期限:漏洞利用程式一旦公開,搜尋未修補的 Rails API 就會變得成本低廉。

哪些 Ruby 和 Rails 版本受影響?

此表綜合 Ruby 的安全公告和 Veria Labs 的受影響軟件列表,資料截至 2026 年 11 月 20 日。

Ruby 系列 受影響 修補版本
4.0 4.0.0 至 4.0.9 4.0.10
3.4 3.4.0 至 3.4.12 3.4.13
3.3 3.3.0 至 3.3.13 3.3.14
3.2 及更早版本 2.4.0 起的所有版本 沒有修補版本(已停止維護)

Rails 版本在此並不重要。錯誤位於直譯器中,因此 bundle update rails 並無影響。使用 Ruby 3.4.12 的 Rails 8 應用程式會受影響;使用 Ruby 3.3.14 的 Rails 6.1 應用程式則不受影響。

Veria Labs 將傳統的 Rails 和 Sinatra 列為預設設定下受影響的框架。其他框架和簡單的 Rack 應用程式預設不受影響,但任何將不可信字串以舊式編碼轉換為大寫的程式碼,仍可能觸發這個漏洞。

Ruby 3.2 及之前版本不會獲得修補程式。如果服務仍在使用 3.1 或 3.2,Ruby2Shell 就會把「下個季度再升級」變成「本週要處理」的工作。

如何檢查 Rails API 是否受影響

容易在錯誤的位置檢查:你手提電腦上的 Ruby,或 .ruby-version 內的 Ruby,可能與正式環境使用的版本不同。

Organigramme pour vérifier une API Rails face à Ruby2Shell : exécuter ruby -v en production, comparer aux plages concernées, puis mettre à niveau ou lancer les tests de régression

步驟 1:從正在執行的環境讀取版本

查詢實際處理流量的程序。按你的部署環境選擇相應一行:

# Docker / Kubernetes
docker exec <container> ruby -v
kubectl exec deploy/<api-deployment> -- ruby -v

# Plateformes de type Heroku
heroku run ruby -v -a <app-name>

# Une VM ou un serveur bare-metal, en tant qu'utilisateur de l'application
sudo -u deploy bash -lc 'cd /srv/api/current && bundle exec ruby -v'

步驟 2:比對已修補的版本

對許多服務而言,請在每個環境貼上這條單行命令。它只使用 Ruby 隨附的 Gem::Version:

ruby -e '
fixed = { "3.3" => "3.3.14", "3.4" => "3.4.13", "4.0" => "4.0.10" }
v = Gem::Version.new(RUBY_VERSION)
series = RUBY_VERSION.split(".").first(2).join(".")
if v < Gem::Version.new("2.4.0")
  puts "#{RUBY_VERSION}: outside the Ruby2Shell range, but end of life"
elsif fixed[series] && v >= Gem::Version.new(fixed[series])
  puts "#{RUBY_VERSION}: patched"
else
  puts "#{RUBY_VERSION}: VULNERABLE, upgrade Ruby"
end'

命令會輸出一行,例如 3.4.12: VULNERABLE, upgrade Ruby。任何 3.2 或之前的版本也會被標示為有漏洞,這是正確的:這些版本系列並沒有已修補版本。

步驟 3:找出每個指定 Ruby 版本的位置

正式環境會顯示目前的狀態;程式碼庫則會顯示下次部署將會發布的內容。請搜尋以下所有項目:

  • .ruby-version 和 .tool-versions(rbenv、asdf、mise)
  • 你的 Gemfile 中的 ruby 行
  • Gemfile.lock 下方的 RUBY VERSION 區段
  • 每個 Dockerfile 中的 FROM ruby:... 行,包括多階段建置
  • GitHub Actions 工作流程中,類似 ruby-version: 的 CI 設定
  • 指定 Ruby 版本的 buildpack 或平台設定
grep -rnE "ruby[-_]version|^ruby |FROM ruby:|RUBY VERSION" \
  --include="*.yml" --include="*.yaml" --include="Dockerfile*" \
  --include="Gemfile*" --include=".ruby-version" --include=".tool-versions" .

步驟 4:別忘記你沒有自行安裝的 Ruby

自行託管的工具會內置自己的 Ruby,因此升級系統上的 Ruby 並無幫助。Veria Labs 的表格更新於 2026 年 11 月 20 日 01:59 UTC,內容如下:

軟件 狀態 已修補版本
GitLab 19.6.0 及之前版本有漏洞 尚未有已修補版本
GitHub Enterprise Server 3.22.5 及之前版本有漏洞 尚未有已修補版本
Chatwoot 4.20.0 及之前版本有漏洞 尚未有已修補版本
Mastodon 4.7.5 及之前版本 4.7.6, 4.6.12, 4.5.22, 4.4.29
OpenProject 17.9.7 及之前版本 17.9.8, 17.8.3
Discourse 早於 2.0.20261119-0203 的基礎映像 2.0.20261119-0203

對於尚未有修補程式的產品,Aikido 的建議是把伺服器移離公開互聯網,置於 VPN 或 IP 白名單之後,直至供應商推出修補程式。

如何修補 Ruby2Shell,同時避免影響 API

Ruby 並未提及任何暫時解決方法,因此修補是唯一方案。以下是避免意外的建議次序:

  1. 更新指定版本。 將 .ruby-version、Gemfile 中的 ruby 行,以及 CI 中所有 ruby-version 設為 3.3.14、3.4.13 或 4.0.10,同時維持在目前使用的版本系列內。
  2. 更新 lockfile。 執行 bundle install,讓 Gemfile.lock 中的 RUBY VERSION 區段保持最新。
  3. 以已修補的基礎映像重建映像。 將 FROM ruby: 指向包含修補程式的標籤(固定版本前,先在 Docker Hub 檢查標籤清單),並使用 --pull 重新建置,以免舊的快取層再次出現。
  4. 重新啟動每個程序。 Puma、Sidekiq、cron 排程工作及臨時主控台都會一直在記憶體中保留舊的直譯器,直到重新啟動為止。
  5. 在正式環境重做步驟 1。請信任正式環境容器的 ruby -v,而不是已合併的 pull request。

同一版本亦修正了另外六個正規表示式及字串處理錯誤,影響 API 所依賴的程式碼,包括參數剖析、驗證及不區分大小寫的搜尋。先在 staging 執行 API 測試,再將 build 推上正式環境。

讓你的編碼 Agent 使用 Apidog CLI 驗證修正後的 API

你已開啟一個編碼 Agent,準備更新 Ruby 版本鎖定設定。讓同一個 Agent 證明修正後的 build 會傳回客戶預期的內容,毋須親自逐一點選 API 端點。Apidog CLI讓 Claude Code、Codex、Cursor 或 OpenCode 能以可編寫腳本的方式匯入 API 規格、編寫測試案例,並在任何環境中執行測試。

安裝只需三條命令:

npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com   # pick your agent when prompted

如果你的 Rails 應用程式會匯出 OpenAPI 檔案(例如使用 rswag),只需給 Agent 一個提示詞:

Import openapi.yaml into Apidog project <id>. Create test cases for our five
most-used endpoints, including GET /api/v1/users/:id and POST /api/v1/orders,
that assert status codes, response schemas and that names containing non-ASCII
characters (like "Straße") round-trip unchanged. Run them against staging after
the Ruby 3.4.13 deploy and summarize any failures.

Agent 會讀取負載結構、驗證結構,並執行測試套件。它會使用以下命令:

apidog import --project <id> --format openapi --file ./openapi.yaml
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <id> --file case.json
apidog run --test-case <caseId> --project <id> -e <stagingEnvId> -r cli,json

非 ASCII 檢查不是漏洞利用測試,也不應該是;不要向正式環境發送偽造的溢位 payload。這是針對修補程式所影響程式碼路徑的回歸檢查。檢查在 staging 通過後,請在 CI 加入相同的 apidog run ... -r junit 步驟,讓下一次 Ruby 升級也能自動進行同樣的檢查。Apidog CLI 的 CI/CD 指南介紹 pipeline 設定,而Claude Code 中的 Apidog CLI則説明 Agent 端的用法。Apidog Free 支援最多 4 位用戶,小型後端團隊今天就足以開始設定。

Ruby2Shell 與近期執行環境層級 RCE 的比較

Ruby2Shell 之前,這裏自 10 月起亦介紹過另外兩宗執行環境層級的 RCE。三者的錯誤都位於執行環境,因此更新框架和套件都無法解決問題。

錯誤 層級 要升級的項目
Ruby2Shell (CVE-2026-132825) Ruby 字串大小寫轉換 將 Ruby 升級至 3.3.14、3.4.13 或 4.0.10
PHP2Shell (CVE-2026-109618, CVE-2026-109619) PHP 直譯器 將 PHP 升級至 8.5.12、8.4.27、8.3.36 或 8.2.35
Node.js Brotli RCE (CVE-2026-111497) Node.js Brotli 解碼器 Node.js 本身

如果團隊使用多語言技術堆疊,請按服務建立一份統一的執行環境版本清單。這些錯誤都始於同一個問題:正式環境實際執行的是哪個版本?如要了解更全面的做法,請參閲API 漏洞自動偵測。

常見問題

升級 Rails gem 能修正 Ruby2Shell 嗎?不能。問題位於 Ruby 直譯器,因此 bundle update rails 無法修正問題。你需要使用 Ruby 3.3.14、3.4.13 或 4.0.10,並重新建置映像檔及重新啟動程序。

如果我的應用程式只使用 UTF-8,是否安全?Veria Labs 指出,UTF-8 字串會經過另一條程式碼路徑,因此不受影響。該公司亦指出,傳統 Rails 和 Sinatra 在預設設定下會觸及易受影響的程式碼,因此「我們只使用 UTF-8」並不足以成為跳過升級的理由。

Ruby2Shell 是否已有公開漏洞利用程式? 截至 2026 年 11 月 20 日,尚未。Ruby 表示已知悉某些情境下存在遠端程式碼執行(RCE)的概念驗證,而 Veria Labs 預計於 2026 年 11 月 25 日公開其針對標準版 Rails 的漏洞利用程式;若發行商尚未推出修補程式,則會延後發布。

如果我使用 Ruby 3.2 或更早版本,該怎麼辦? Ruby 3.2 及更早版本已停止支援,不會收到修補程式。請升級至 3.3.14 或更新版本,最好升級至 3.4.13 或 4.0.10,並將升級視為緊急事項。

如何檢查 GitLab 或 Mastodon 是否受 Ruby2Shell 影響? 這些產品內置了自己的 Ruby。請查閲發行商的版本説明,確認是否有已修補的版本。如果尚未推出,請先透過 VPN 或 IP 白名單限制存取。

升級 Ruby 會一併修復其他問題嗎? 會。Ruby 3.3.14、3.4.13 和 4.0.10 也修復了同一份 Ruby 安全公告所列的另外六個正規表示式及字串大小寫轉換漏洞,因此一次升級便可修復全部七個漏洞。

來源:DEV Community · dev.to