Rails Ruby2Shell RCE 漏洞:如何檢查 API 是否受影響
Kerentanan RCE di Rails (Ruby2Shell): Cara Memeriksa Apakah API Anda Terdampak
Ruby2Shell(CVE-2026-132825)會影響使用特定 Ruby 版本的 Rails API,修復方式是升級 Ruby,而非更新 gem。受影響範圍包括 Ruby 2.4.0 至 3.3.13、3.4.0 至 3.4.12,以及 4.0.0 至 4.0.9;修補版本分別為 3.3.14、3.4.13 和 4.0.10。
文章整理 Ruby2Shell 的受影響與修補版本,並説明應在實際服務 API 的環境核對 Ruby 版本,單靠更新 Rails gem 無法修復漏洞。
Ruby2Shell:要求升級 Ruby 而非 Gem 的 Rails RCE 漏洞
本週備受關注的 Rails RCE 漏洞是 Ruby2Shell(發現者將其寫作「Ruby2ßhell」),編號為 CVE-2026-132825 和 GHSA-34m4-m9fh-gqp5。這是 Ruby 在轉換字串大小寫時出現的一個位元組 heap 溢位。研究人員指出,在 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。
簡短答案:我是否受影響?
- 在實際為你的 API 提供服務的環境(容器、VM 或 dyno)中執行
ruby -v,不要在手提電腦上執行。 - 如果版本在上述三個範圍之內,你的系統便會受影響。
- 升級 Ruby、重新建置所有映像檔、重新啟動所有應用程式伺服器,然後再次執行 API 測試。
甚麼是 Ruby2Shell Rails RCE 漏洞?
Ruby2Shell 是 Ruby 在 ISO-8859-x 和 Windows-125x 等舊式單位元組編碼中,用於轉換字串大小寫的程式碼出現的一個位元組 heap 緩衝區溢位。Veria Labs 將其評為 Critical,指出漏洞可透過網絡在無需驗證的情況下觸發,並表示在預設設定下,Rails 和傳統風格的 Sinatra 都可觸發漏洞。
根本原因很簡單。大部分單位元組編碼都沒有德文 sharp s「ß」的大寫形式,因此對它執行 upcase 時,會寫入兩個位元組,即「SS」。執行這項操作的迴圈只會檢查是否有足夠空間容納一個位元組。Ruby 會按照輸入長度加 20 個位元組的大小分配輸出緩衝區,因此根據 Veria 的文章,包含 21 個「ß」字元的輸入會令緩衝區溢出一個位元組。
這個溢位可透過 upcase、swapcase、downcase(:fold) 和 casecmp? 觸發。UTF-8 字串會採用不同的程式碼路徑,因此不受影響。這個錯誤自 Ruby 2.4.0 起便存在。
Ruby 於 2026 年 11 月 18 日發布了安全公告,同時公佈 regular expression 引擎和字串大小寫轉換中的另外六個漏洞。Ruby 表示,已知有概念驗證利用這個漏洞,在「若干情況下」造成遠端程式碼執行。Veria Labs 表示,自己是首個示範如何在預設 Rails 中達成 RCE 的團隊,並計劃於 2026 年 11 月 25 日發布 exploit;如果屆時大型供應商尚未推出修正,發布時間則會延後。
這個日期就是你真正的期限:一旦 exploit 公開,掃描未修補的 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 應用程式在預設情況下不會暴露於此漏洞,但任何對不可信的舊式編碼字串執行 upcase 的程式碼,仍可能觸發這個錯誤。
Ruby 3.2 及更舊版本不會再獲得修補程式。如果某項服務仍使用 3.1 或 3.2,Ruby2Shell 會把「我們下季再升級」變成今個星期要處理的工作。
如何檢查您的 Rails API 是否受影響
陷阱在於檢查錯了地方:您手提電腦上的 Ruby,或 .ruby-version 中列出的版本,可能與正式環境實際執行的版本不同。
步驟 1:讀取執行中環境的版本
查詢正在處理流量的程序。按您的託管方式選擇相應的一行:
# Docker / Kubernetes
docker exec <container> ruby -v
kubectl exec deploy/<api-deployment> -- ruby -v
# Platform bergaya Heroku
heroku run ruby -v -a <app-name>
# VM atau host bare-metal, sebagai user aplikasi
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 工作流程中的 CI 設定,例如
ruby-version: - 鎖定 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 沒有列出任何應變方法,因此修補是唯一的解決方法。以下次序可避免意外:
-
更新版本鎖定設定。將
.ruby-version、Gemfile中的ruby行,以及 CI 中所有ruby-version設為 3.3.14、3.4.13 或 4.0.10,並維持在目前使用的系列。 -
更新鎖定檔。執行
bundle install,讓Gemfile.lock中的RUBY VERSION區段也一併吻合。 -
使用已修補的基礎映像重新建置。將
FROM ruby:指向包含已修補版本的標籤(鎖定前先查看 Docker Hub 上的標籤清單),並使用--pull重新建置,避免舊的快取層再次混入。 - 重新啟動所有程序。Puma、Sidekiq、cron runner 和一次性 console 都會將舊的直譯器保留在記憶體中,直至重新啟動。
-
在正式環境重新執行步驟 1。請以執行中容器回報的
ruby -v為準,而非已合併的 pull request。
同一批版本亦修復了另外六個正規表示式和字串相關錯誤,涉及 API 極為依賴的程式碼:參數剖析、驗證及不區分大小寫的搜尋。將版本推送至正式環境前,請先在預備環境執行 API 測試。
使用 Apidog CLI,讓您的程式編寫 Agent 驗證已修補的 API
你已經開啟一個 coding agent,準備更新 Ruby 版本鎖定設定。讓同一個 agent 證明已修補的 build 會回傳用戶端預期的結果,而不是由你逐一點擊 endpoint。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 # pilih agent Anda saat diminta
如果你的 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 會讀取 payload schema、驗證內容並執行測試套件。以下是它使用的指令:
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 通過後,把同一個 apidog run ... -r junit 步驟加入 CI,讓下一次 Ruby 升級也能自動接受相同檢查。Apidog CLI 的 CI/CD 指南介紹如何設定 pipeline,而Claude Code 中的 Apidog CLI則介紹 agent 端的設定。Apidog Free 最多支援 4 位用戶,足以讓小型後端團隊今天就開始使用。
Ruby2Shell 與近期其他 runtime RCE 的比較
Ruby2Shell 是自 10 月以來本文討論的另外兩宗 runtime 層級 RCE 之後的最新一宗。三者的漏洞都位於 runtime,因此更新 framework 和套件並無作用。
| 漏洞 | 層級 | 需要升級的項目 |
|---|---|---|
| Ruby2Shell (CVE-2026-132825) | Ruby 字串大小寫轉換 | Ruby 升級至 3.3.14、3.4.13 或 4.0.10 |
| PHP2Shell (CVE-2026-109618, CVE-2026-109619) | PHP interpreter | 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 本身 |
如果你的團隊使用多語言技術堆疊,請按服務整理一份 runtime 版本清單。以上每個漏洞都由同一個問題開始:正式環境實際執行的是哪個版本?如要了解更全面的做法,請參閲自動偵測 API 漏洞。
常見問題
更新 Rails gem 能修復 Ruby2Shell 嗎? 不能。漏洞位於 Ruby interpreter,因此 bundle update rails 無法修復它。你需要使用 Ruby 3.3.14、3.4.13 或 4.0.10,並重新建置 image 及重新啟動程序。
如果我的應用程式只使用 UTF-8,是否安全? Veria Labs 表示,UTF-8 字串會走不同的程式碼路徑,因此不受影響。不過,Veria 亦表示,傳統 Rails 和 Sinatra 在預設設定下可能會執行到有漏洞的程式碼,因此「我們只使用 UTF-8」並非跳過升級的理由。
目前是否已有 Ruby2Shell 的公開 exploit? 截至 2026 年 11 月 20 日,尚未有。Ruby 表示已知悉有針對若干情境中 RCE 的概念驗證,而 Veria Labs 計劃於 2026 年 11 月 25 日公開其 Rails exploit;如果供應商尚未發布修補程式,則會延後公開。
如果我使用 Ruby 3.2 或更舊版本,該怎麼辦? Ruby 3.2 及更舊版本已停止支援,不會再收到修補程式。請升級至 Ruby 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

