單一 VPS 適合用 Keycloak、authentik 還是 Zitadel?
比較 Keycloak、authentik 與 Zitadel 在單一 VPS 的 RAM 下限、無 SSO 應用程式支援,以及各自的限制,並說明為何少於 4 GB 不建議使用 Zitadel。
哪一個 SSO 伺服器適合單一 VPS
Keycloak、authentik 與 Zitadel 都是自架的單一登入(SSO)伺服器。當有人想在伺服器上的所有應用程式共用一組登入資訊時,通常會考慮這些方案。但在一台小型 VPS 上,三者並不能互相替代。對於執行 3 或 4 個自架應用程式的主機,authentik 是較安全的預設選擇,因為只有它能在沒有內建登入功能的應用程式前方提供登入畫面。當你要保護的每個應用程式都已支援標準通訊協定,且主機能提供 Java 虛擬機器(JVM)所需的記憶體時,Keycloak 才是合適的選擇。Zitadel 是為透過 API 發布產品的開發者打造;若記憶體少於 4 GB,我不建議嘗試使用它。
先選擇方案,再進行安裝。完成選擇後,VPS 上的 authentik 實作安裝指南會逐步說明設定方式。
各自實際需要多少 RAM?
先從資源下限開始,因為它會在任何功能比較前決定候選名單。以下數字取自各專案截至 2026 年 10 月公布的資料。這些是供應商建議值,不是負載測試結果。
此圖表背後的資料
[
{
"label": "authentik",
"vendor_min_ram_mb": 2048,
"base_containers": 3
},
{
"label": "Keycloak",
"vendor_min_ram_mb": 1250,
"base_containers": 2
},
{
"label": "Zitadel",
"vendor_min_ram_mb": 2048,
"base_containers": 4
}
]authentik 的 Docker Compose 安裝頁面要求「至少具備 2 個 CPU 核心與 2 GB RAM 的主機」,也就是 2048 MB;其公布的 compose 檔案會執行 3 個容器:PostgreSQL、server 與 worker。這項主機規格必須涵蓋全部 3 個元件,包括資料庫。
Keycloak 公布的數值在 3 個專案中最具體。其 sizing guide 表示:「包含 Realm 資料快取與 10,000 個快取工作階段的 Pod,基本記憶體使用量為 1250 MB RAM。」這 1250 MB 是 Keycloak server 搭配上述快取時的需求。該指南會另外估算資料庫,因此 PostgreSQL 還需要額外配置記憶體。同一頁也說明容器記憶體限制為何如此重要:Keycloak 會將記憶體限制的 70% 用作 heap,另外約使用 300 MB 的 non-heap 記憶體;其範例將 1250 MB 的基本需求換算為 1360 MB 的記憶體限制。若只給容器 1 GB,計算出的 heap 約為 717 MB,加上約 300 MB 的 non-heap 記憶體後,總量約為 1017 MB。在此限制下幾乎沒有餘裕,而指南所列、包含 Realm 快取與 10,000 個工作階段的基本需求為 1250 MB。
Zitadel 的 compose 頁面同樣要求 2 GB,也就是 2048 MB,並將其列為整份指南的先決條件,適用範圍從 quickstart 到 homelab 或半正式環境階段。若要進一步評估規模,應參考其 production 頁面。Zitadel 程序本身需要「約 512MB RAM,且可在少於 1 個 CPU 核心的情況下運作」。耗用資源較多的是資料庫:「每 100 requests per second (req/s) 約需 1 個 CPU 核心,每個核心需 4GB RAM」。密碼雜湊則需要「提供 4 個 CPU 核心供此用途使用」,因為登入突增會轉化為 CPU 尖峰。官方 v4 compose 在尚未加入其他元件前會執行 4 個容器:Traefik 作為代理、Zitadel API、獨立的 Login UI 容器,以及 PostgreSQL。Redis 與 OpenTelemetry collector 位於選用的 compose profiles 中。
因此,Keycloak 與 authentik 可在 4 GB VPS 上執行,並為受保護的應用程式保留一些餘裕。Zitadel 可在 2 GB 上啟動,但每次登入時都會與自身的 PostgreSQL 爭用記憶體。我不會在低於 4 GB 的環境執行 Zitadel;若同一台主機也承載應用程式,我會希望配置 8 GB。
各個服務在伺服器上的實際執行方式
authentik 由 PostgreSQL 資料庫以及兩個相同的映像檔組成,分別是 server 與 worker。server 負責處理 HTTP 請求並包含一個內嵌的 outpost。worker 則執行目錄同步與電子郵件發送等背景任務。官方提供的安裝步驟相當簡潔。
wget https://docs.goauthentik.io/compose.yml
echo "PG_PASS=$(openssl rand -base64 36 | tr -d '\n')" >> .env
echo "AUTHENTIK_SECRET_KEY=$(openssl rand -base64 60 | tr -d '\n')" >> .env
docker compose pull
docker compose up -dserver 會對外開放 9000 與 9443 埠。首次存取 9000 埠時會觸發初始設定流程,您需在此設定預設 akadmin 使用者的密碼。在將該埠暴露於網際網路之前,請務必在其前方架設具備有效憑證的反向代理。
Keycloak 由單一處理程序加上您自行提供的資料庫組成。快速啟動方式為執行單一容器。
docker run -p 127.0.0.1:8080:8080 \
-e KC_BOOTSTRAP_ADMIN_USERNAME=admin \
-e KC_BOOTSTRAP_ADMIN_PASSWORD=admin \
quay.io/keycloak/keycloak:26.8.1 start-devstart-dev 僅供初步測試使用。它使用本地開發用資料庫且未啟用 TLS (傳輸層安全性),因此以這種方式啟動並隨後移除的容器,會連同您的 realm 一併刪除。正式環境應改用 start,透過 KC_DB 連接正式的 PostgreSQL,並使用 KC_HOSTNAME 設定公開主機名稱。Keycloak 的正式環境指南亦指出,所有進出伺服器的通訊皆須透過安全通道,因此 HTTPS 在此並非選項,而是必要條件。
Zitadel 為上述提到的四容器堆疊。
mkdir zitadel-compose && cd zitadel-compose
curl -fsSLO https://raw.githubusercontent.com/zitadel/zitadel/main/deploy/compose/docker-compose.yml
curl -fsSLO https://raw.githubusercontent.com/zitadel/zitadel/main/deploy/compose/.env.example
cp .env.example .env
docker compose up -d --wait在首次啟動前,請務必在 .env 中設定 ZITADEL_MASTERKEY。這是 Zitadel 用於加密資料庫內機密資訊的 32 字元金鑰,一旦遺失,將無法存取這些機密資料。若您不熟悉此類堆疊的運作方式,Docker Compose 基礎教學 涵蓋了決定身分識別提供者能否在重開機後存續的 volume 與 restart-policy 設定。
各者支援哪些協定?
三者都支援 OpenID Connect (OIDC)。這是建構在 OAuth 2.0 之上的登入層,現代應用程式普遍使用。三者也都支援 SAML 2.0 (security assertion markup language)。這是較舊的標準,企業軟體仍會提供支援。真正的差異在於 LDAP (lightweight directory access protocol),因為同一個詞涵蓋兩種相反的用途。
從 LDAP 讀取表示 SSO 伺服器會使用你已經執行的目錄驗證密碼。Keycloak 透過 user federation 提供此功能。Zitadel 也支援:其文件說明如何「在 ZITADEL 中將 LDAP 伺服器連線為身分識別提供者」。
提供 LDAP 服務表示只支援 LDAP 的應用程式可以像連線至目錄一樣,向你的 SSO 伺服器建立 bind。只有 authentik 支援此功能。其 LDAP provider 透過專用的 LDAP outpost,讓「authentik 資料庫中的所有使用者與群組都能透過 LDAP 目錄搜尋」,並可在 port 636 使用 LDAPS。依預設,已建立 bind 的使用者只能搜尋自己的詳細資料與群組。因此,應用程式用來建立 bind 的 service account 必須具備「Search full LDAP directory」權限,才能查看所有使用者。其文件只涵蓋 bind 與 search,未說明任何寫入操作,因此應將它視為唯讀目錄。一次性代碼會以分號附加在密碼後方,例如 password;123456;SMS 驗證器不支援 bind。
如果你的清單中有應用程式只支援 LDAP,比較到此即可結束。Keycloak 與 Zitadel 無法回應該 bind,因此你必須在兩者旁邊另行執行一個目錄,並同步維護兩份使用者清單。
若應用程式完全沒有登入功能該怎麼辦?
Forward auth 是解決方案,這也是自架伺服器經常遇到的情況。反向代理會在將請求傳遞給後端應用程式之前,先詢問 SSO 伺服器該請求是否獲准。後端應用程式無需了解 SSO 機制,它只會收到代理層已驗證過的請求,通常會在標頭(header)中包含使用者名稱。
authentik 的 proxy provider 透過三種已記錄的模式涵蓋此需求。「Proxy」模式由 authentik outpost 直接將流量傳遞給後端應用程式。「Forward auth (single application)」模式則將流量保留在現有的反向代理中,僅使用 authentik 進行驗證檢查。「Forward auth (domain level)」模式則以單一 provider 保護同一父網域下的所有應用程式。Domain level 模式最為便利,但有一項已知的限制:它「無法針對每個受保護的應用程式強制執行不同的應用層級授權規則」,因此該網域下的所有應用程式都必須共用同一套政策。
Keycloak 並無此類內建功能。其配套的代理程式 Keycloak Gatekeeper 已更名為 Louketo Proxy,並於 2020 年 11 月終止支援,隨後於 2020 年 12 月在 GitHub 上封存。若要保護不支援 OIDC 的應用程式,您必須在其前方執行一個額外的元件(通常是 oauth2-proxy),並將其指向 Keycloak client。Zitadel 也沒有專屬的 forward auth 模式,因此同樣需要安裝、監控並升級額外的元件。
這個額外的跳轉步驟會讓反向代理的設定變得複雜,因此在將驗證 middleware 串接到 Traefik 之前,請先閱讀 Traefik 如何作為多個 Docker Compose 應用程式的前端。
升級路徑有多複雜?
截至 25 October 2026,目前的版本分別是 Keycloak 26.8.1、authentik 2026.8.5 以及 Zitadel v4.20.0。這 3 個產品都會對 PostgreSQL 執行資料庫結構遷移,因此每次升級都會變更資料庫。每次升級前都要先備份資料庫。這個習慣的價值高於本比較中的任何功能。
authentik 的規則最嚴格,而且明確說明:「升級必須依 major release 的順序進行;不得直接從較舊的 major version 跳到最新版本。」進入下一個版本前,必須先升級到目前版本序列中的最新 patch version;此外,「authentik 不支援降級」。採用日曆版本制的專案若落後 1 年,單次升級就會變成一連串升級,而每次升級都有各自的資料庫遷移。
Keycloak 的升級指南提供了應遵循的順序:先檢閱前一版本的遷移變更,再升級伺服器,最後升級 adapters。資料庫遷移會自動執行;你也可以先匯出遷移內容,再手動套用。若希望在變更套用前先檢閱內容,這項功能很有用。Keycloak 的成本在於閱讀。其 release notes 包含容易略過的棄用項目與行為變更,但忽略這些內容可能造成高昂的維運成本。
Zitadel 將 init 與 setup 階段和執行中的伺服器分開;其正式環境指引也建議維持分離,避免擴充規模時重複執行 setup。對單一 VPS 而言,這主要表示 setup 步驟必須先完成,API 才會回報健康狀態;因此 compose file 會提供 health checks,而啟動命令會使用 --wait。
各專案的適用對象,以及各自的限制
Keycloak 是 Red Hat 的身分識別伺服器,適合具備 realm、群組、角色對應及既有企業目錄的組織。3 者之中,它對標準的實作最完整。若是在執行 4 個自架應用程式的 2 GB VPS 上使用,其中一半不支援 OIDC,Keycloak 就不合適。Keycloak 伺服器本身就會占用 1250 MB,尚未計入資料庫;此外,您還要學習以企業為設計對象的 realm 模型,最後仍需為真正需要保護的應用程式安裝 oauth2-proxy。
authentik 是為自架服務使用者打造的產品,功能清單即可反映這一點。它提供 forward auth 與 LDAP provider,也能在視覺化編輯器中建立登入流程。若您需要不受企業預算限制的廠商支援,或需要不必每隔幾週就更新的發行節奏,authentik 就不合適。支援僅隨付費訂閱提供:Enterprise 訂閱(超過 $1k)包含工單支援;Enterprise Plus 起價為每年 $20k,提供具 SLA 的專屬支援。採用日曆版本編號、無法降級且不能跳過版本,會增加實際的維運工作量。如果您的實際問題只是設定 1 個 OIDC client,還要學習整套流程編輯器所代表的模型。
Zitadel 是為將身分驗證整合至所發布產品中的開發人員打造的產品,具備強大的 API,並將多租戶列為一級功能。但在這個情境下,它正好不合適。需要執行 4 個容器、不提供 forward auth,且資料庫規模設定為每個 core 4 GB;對於在單一 VPS 上,讓 password manager 與 wiki 位於其後的架構而言,這並不是合適的配置。
我會在一台 VPS 上執行的方式
如果一台 VPS 上有三或四個自架應用程式,建議執行 authentik。這三者都會提供登入畫面。決定因素在於,部分應用程式永遠不會支援 OIDC,而 authentik 內建 forward auth,可直接處理這種情況,不必再搭配另一個元件。
如果可以,為它配置 4 GB;只有在旁邊的應用程式規模較小時,才配置 2 GB。不要讓 port 9000 暴露在公開網際網路上,並在前方的反向代理終止 TLS。每晚建立 PostgreSQL 傾印,並儲存到主機外部,因為沒有備份的身分識別提供者會成為其後所有應用程式的單一故障點。請使用專用的非特權帳號執行整個 stack,不要使用 root:在 VPS 上設定最小權限使用者涵蓋所需的帳號與檔案擁有權設定。
如果所有受保護的應用程式都已支援 OIDC 或 SAML,或需要 Keycloak realm 提供的細緻角色模型,請改用 Keycloak。如果你要建立讓其他人註冊的應用程式,並且需要其 API 與 tenant model,請選擇 Zitadel。這兩者都不適用於本文所討論的單一主機執行三個應用程式的情境。
你最先會遇到的故障模式
Keycloak 重新啟動後沒有資料。 你使用 start-dev 啟動它,而該設定使用本機開發資料庫。在沒有 volume 的容器中,移除容器也會移除 realm。請改用 start,並透過 KC_DB=postgres 指向實際的資料庫。
小型主機上的 authentik worker 容器消失。 worker 與 server 使用相同的 image,且兩者都會執行 Python 程序;PostgreSQL 也需要分配 2 GB 主機記憶體。執行 docker compose ps,確認是哪個服務已結束,再檢查 dmesg 是否有 out-of-memory kill,之後再尋找應用程式本身的錯誤。
Zitadel 的 Console 無法在 proxy 後方運作。 Zitadel API 使用 gRPC,因此到 upstream 的整條連線都必須使用 HTTP/2。需求頁面要求 reverse proxy 支援到 upstream 的 HTTP/2 連線,並列出經測試的 Traefik v3.x、NGINX v1.x、Caddy v2.x 與 Apache httpd 2.4.x 版本。若 proxy 將到 upstream 的連線降級為 HTTP/1.1,登入頁面會正常載入,但 Console 會失敗。
每個應用程式都將你導回登入畫面。 SSO server 的公開 URL 必須與應用程式中設定的 URL 完全一致,包括 scheme 與 port。Keycloak 將此設定稱為 hostname,Zitadel 則稱為 external domain。兩者不一致時,應用程式會將你重新導向至一個 server 不認為屬於自己的登入位置,瀏覽器便會在兩者之間反覆重新導向。
FAQ
哪一個適合 2 GB 的 VPS?
authentik 與 Keycloak。authentik 官方建議主機至少需 2 核心 CPU 與 2 GB RAM;Keycloak 的規模指南則指出,伺服器在不含資料庫的情況下,基礎記憶體需求為 1250 MB。一旦加入您要保護的應用程式,這兩者在 2 GB 的環境下都會非常吃緊,因此建議以 4 GB 作為舒適的基準。Zitadel 的 compose 指南雖列出 2 GB 需求,並可用於家庭實驗室或半生產環境,但其生產環境指南建議使用 4 核心 CPU 以處理密碼雜湊,且每個資料庫核心需 4 GB RAM,因此當實際登入流量湧入時,2 GB 可能會變得捉襟見肘。
Keycloak 或 Zitadel 能保護沒有內建登入功能的應用程式嗎?
無法單獨達成。兩者皆未內建 Forward auth 元件。Keycloak 舊有的配套代理程式 Louketo Proxy 已於 2020 年 11 月終止支援,其 GitHub 儲存庫亦自 2020 年 12 月起封存,不建議採用。您需要在反向代理與應用程式之間部署 oauth2-proxy 或類似元件,並將其指向 SSO 伺服器上的 OIDC 客戶端。authentik 則透過其 proxy provider 原生支援此功能,提供「Forward auth (single application)」或「Forward auth (domain level)」模式。
哪一個能為僅支援 LDAP 的應用程式提供 LDAP 伺服器功能?
authentik。其 LDAP provider 運行於 outpost 上,能讓應用程式透過 LDAP 搜尋 authentik 中的使用者與群組,並支援在 636 埠使用 LDAPS。其文件僅涵蓋綁定 (bind) 與搜尋 (search) 功能,請視為唯讀模式。Keycloak 與 Zitadel 的運作方向相反:兩者皆是從現有的 LDAP 目錄讀取使用者資訊,均無法回應來自應用程式的 LDAP 綁定請求。
升級 authentik 時可以跳過版本嗎?
不行。官方文件明確指出升級必須遵循主要版本順序,不應從舊的主要版本直接跳升至最新版本。請先升級至各版本內的最新修補程式版本,再逐一升級主要版本。在每個步驟前請務必備份 PostgreSQL,因為 authentik 不支援降級,且資料庫遷移僅能向前執行。