woodpecker：從 README 拆解功能、設定與採用邊界
Woodpecker 是一個簡單但功能強大的 CI/CD 引擎，具有強大的可擴充性。
秒懂
- 它是什麼？
- Woodpecker is a simple, yet powerful CI/CD engine with great extensibility.，本文以 README 可核對的功能、命令、版本與限制整理採用判斷。
- 適合誰用？
- Woodpecker 是一個用 Go 寫的 Apache-2.0 授權 CI/CD 引擎，預設使用 SQLite，支援外掛擴充，並有一個已知的 Codeberg 公開部署。
- 可以商用嗎？
- 可以。Apache-2.0 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
- 還在維護嗎？
- 有在維護。儲存庫最近一次提交在 2 天前。
- 用什麼語言寫的？
- 主要是 Go（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月14日）與我們的分析，不構成法律意見。
開源專案深度解析
README 開頭對 Woodpecker 的描述
README 開頭將 Woodpecker 描述為一個簡單但強大的 CI/CD 引擎，並強調它有良好的可擴充性。repository 元資料顯示該專案使用 Go 編寫，首頁是 https://woodpecker-ci.org，GitHub repository 有 7,637 個星標、644 個 fork 和 358 個未關閉問題，archived 欄位為 false，預設分支是 main。README 頂部的徽章連結包括 pipeline 狀態、程式碼覆蓋率、翻譯狀態、Matrix 空間、Go 參考、GitHub 發佈、Docker 拉取、Apache-2.0 授權、OpenSSF 最佳實踐和 pre-commit.ci。這些徽章指向外部服務，README 本身沒有提供效能基準或與其他 CI/CD 引擎的比較，也沒有說明這些徽章對應的檢查細節。
Woodpecker 的 README 只用一句話界定方向：簡單但有擴充性的 CI/CD engine。可核對的實作訊號包括 Go 語言、main 預設分支、woodpecker-ci.org 首頁與 v3.18.0 release。它沒有在 README 提供 pipeline 語法、執行器拓撲或高負載數據，所以不能用一句「簡單」推導操作成本。
在 woodpecker 的實際核對中，第 1 節應保留這個專案名稱與對應的文件線索，並把觀察到的結果和 README 的宣告分開記錄。這樣才能知道問題出在設定、輸入、版本，還是工具本身沒有提供該能力。對 woodpecker 而言，這項區分會影響後續的部署範圍、回滾方式與責任界線。核對時也要記下第 1 節提到的檔案、指令或設定鍵，讓下一次升級可以重現相同檢查。若輸出和文件不一致，應保留錯誤訊息、作業系統與執行版本，再針對 woodpecker 的 issue 或 release 找對應變更。這種記錄方式讓功能判斷落在可觀察結果，而不是倉庫人氣。
安裝方式與資源占用
README 說 Woodpecker 可以有多種安裝方式，並指向 https://woodpecker-ci.org/docs/administration/general 的安裝說明。它沒有逐一列出這些方式，因此具體支援哪些套件格式、容器映像或編排系統，本 repository 沒有說明。預設資料庫是 SQLite，但 README 沒有說明如何在生產環境中切換到其他資料庫。README 給出空閒記憶體占用：伺服器端約 100 MB，Agent 約 30 MB。它沒有說明高負載、大 repository 或高並發時的資源需求，也沒有提供任何安裝指令或設定檔範例。空閒記憶體數字來自 README，實際使用情況會隨配置變化，這個數字不是上限。要確認這些，需要查看安裝文件。
安裝文件入口是 https://woodpecker-ci.org/docs/administration/general，README 說預設資料庫為 SQLite，idle 時 server 約 100 MB、agent 約 30 MB。這兩個數字是 README 的容量觀察，不是上限；實際評估應觀察 repository 數量、pipeline 並行度與 agent 任務的資源曲線。
在 woodpecker 的實際核對中，第 2 節應保留這個專案名稱與對應的文件線索，並把觀察到的結果和 README 的宣告分開記錄。這樣才能知道問題出在設定、輸入、版本，還是工具本身沒有提供該能力。對 woodpecker 而言，這項區分會影響後續的部署範圍、回滾方式與責任界線。核對時也要記下第 2 節提到的檔案、指令或設定鍵，讓下一次升級可以重現相同檢查。若輸出和文件不一致，應保留錯誤訊息、作業系統與執行版本，再針對 woodpecker 的 issue 或 release 找對應變更。這種記錄方式讓功能判斷落在可觀察結果，而不是倉庫人氣。
README 中唯一提到的公開部署
README 點名了一個公開使用 Woodpecker 的實例：Codeberg。Codeberg 被描述為注重隱私和自由軟體發展的替代 Git 托管平台，並將 Woodpecker 作為主要 CI/CD 引擎。這是 README 中唯一提到的生產部署，沒有其他公司或專案被列出。README 沒有說明 Codeberg 的伺服器數量、pipeline 規模或硬體配置，因此這些資訊不能從本 repository 得出。徽章區域有 pipeline 狀態和程式碼覆蓋率連結，但它們只是外部指標，不是對 Codeberg 運作情況的陳述。README 也沒有提供 Codeberg 的連結或更多背景，所以外部驗證只能從 Codeberg 自己的材料開始。
外掛概覽位於 https://woodpecker-ci.org/plugins，收錄核心團隊與社群維護的外掛，但 README 沒有提供 API 版本、審核制度或安全模型。Codeberg 被點名為主要 CI/CD 使用者；這能證明一個公開部署案例，不能替代你的權限、secret、外掛來源與失敗重試測試。docs/ 另採 CC BY-SA 4.0，程式碼採 Apache-2.0，兩者分發時要區分。
在 woodpecker 的實際核對中，第 3 節應保留這個專案名稱與對應的文件線索，並把觀察到的結果和 README 的宣告分開記錄。這樣才能知道問題出在設定、輸入、版本，還是工具本身沒有提供該能力。對 woodpecker 而言，這項區分會影響後續的部署範圍、回滾方式與責任界線。核對時也要記下第 3 節提到的檔案、指令或設定鍵，讓下一次升級可以重現相同檢查。若輸出和文件不一致，應保留錯誤訊息、作業系統與執行版本，再針對 woodpecker 的 issue 或 release 找對應變更。這種記錄方式讓功能判斷落在可觀察結果，而不是倉庫人氣。
文件、翻譯與支援管道
專案文件位於 https://woodpecker-ci.org/docs/intro。在地化方面，README 提到一個自托管的 Weblate 實例，位址是 translate.woodpecker-ci.org，並連結到翻譯狀態總覽。社群討論透過 Matrix 空間進行，徽章中有相關連結。資金支援方面，README 指向 Open Collective 和 GitHub Sponsors，並顯示 Open Collective 的支援者圖片。它沒有說明資金如何使用，也沒有列出企業贊助者。README 還包含 OpenSSF 最佳實踐和 pre-commit.ci 的徽章，但 README 文字沒有解釋這些檢查具體覆蓋什麼，也沒有提到任何服務等級或回應時間。翻譯狀態總覽頁面由 Weblate 提供，README 沒有給出語言列表或翻譯完成率。
在 woodpecker 的實際核對中，第 4 節應保留這個專案名稱與對應的文件線索，並把觀察到的結果和 README 的宣告分開記錄。這樣才能知道問題出在設定、輸入、版本，還是工具本身沒有提供該能力。對 woodpecker 而言，這項區分會影響後續的部署範圍、回滾方式與責任界線。核對時也要記下第 4 節提到的檔案、指令或設定鍵，讓下一次升級可以重現相同檢查。若輸出和文件不一致，應保留錯誤訊息、作業系統與執行版本，再針對 woodpecker 的 issue 或 release 找對應變更。這種記錄方式讓功能判斷落在可觀察結果，而不是倉庫人氣。
基於外掛的擴充方式
README 將外掛描述為擴充 Woodpecker 的方式。外掛概覽網站位於 https://woodpecker-ci.org/plugins，README 說該網站同時收錄 Woodpecker 核心團隊和社群維護的外掛。它沒有給出外掛數量、API 版本、範例設定或散佈格式，也沒有描述第三方外掛的安全模型，以及社群外掛如何審核。要編寫外掛，需要查閱文件或原始碼，因為 README 沒有提供這些細節。外掛概覽網站是否由核心團隊維護，README 也沒有說明。可擴充性是 README 對專案的定位之一，但具體實作方式由文件和程式碼決定。
在 woodpecker 的實際核對中，第 5 節應保留這個專案名稱與對應的文件線索，並把觀察到的結果和 README 的宣告分開記錄。這樣才能知道問題出在設定、輸入、版本，還是工具本身沒有提供該能力。對 woodpecker 而言，這項區分會影響後續的部署範圍、回滾方式與責任界線。核對時也要記下第 5 節提到的檔案、指令或設定鍵，讓下一次升級可以重現相同檢查。若輸出和文件不一致，應保留錯誤訊息、作業系統與執行版本，再針對 woodpecker 的 issue 或 release 找對應變更。這種記錄方式讓功能判斷落在可觀察結果，而不是倉庫人氣。
程式碼與文件的授權條款
repository 採用 Apache-2.0 授權，README 說原始檔帶有標明授權和版權的標頭。docs 目錄下的內容單獨採用知識共享 姓名標示-相同方式分享 4.0 國際 公眾授權條款。Apache 授權條款摘錄包含永久、全球性、非專屬、免費、免版稅的著作權授權，以及類似的專利授權，並規定如果提起專利訴訟，專利授權會終止。摘錄還包含再散佈條款的開頭，但沒有展示完整條款。授權文字沒有涉及擔保、支援或安全保證，因此這些內容不由本 repository 材料確立。該摘錄只是授權條款的一部分，完整條款還需要看 Apache 2.0 全文。若要在生產環境使用，應該閱讀完整的授權檔案。
在 woodpecker 的實際核對中，第 6 節應保留這個專案名稱與對應的文件線索，並把觀察到的結果和 README 的宣告分開記錄。這樣才能知道問題出在設定、輸入、版本，還是工具本身沒有提供該能力。對 woodpecker 而言，這項區分會影響後續的部署範圍、回滾方式與責任界線。核對時也要記下第 6 節提到的檔案、指令或設定鍵，讓下一次升級可以重現相同檢查。若輸出和文件不一致，應保留錯誤訊息、作業系統與執行版本，再針對 woodpecker 的 issue 或 release 找對應變更。這種記錄方式讓功能判斷落在可觀察結果，而不是倉庫人氣。
編輯結論
Woodpecker 是一個用 Go 寫的 Apache-2.0 授權 CI/CD 引擎，預設使用 SQLite，支援外掛擴充，並有一個已知的 Codeberg 公開部署。
社群筆記