SSD Nodes Learn Hosting plans →
Посібники Matt ConnorВід Matt Connor

Keycloak, authentik чи Zitadel для одного VPS

Порівняння Keycloak, authentik і Zitadel: мінімум RAM, підтримка застосунків без SSO та головні обмеження кожного рішення на одному VPS.

Який SSO-сервер підходить для одного VPS

Keycloak, authentik і Zitadel — це self-hosted сервери єдиного входу (SSO), які зазвичай розглядають, коли потрібен один обліковий запис для всіх застосунків на сервері. На одному невеликому VPS це не взаємозамінні рішення. authentik — безпечний варіант за замовчуванням для сервера з трьома або чотирма self-hosted застосунками, оскільки лише він із цих трьох продуктів може показувати форму входу перед застосунком, який не має власної автентифікації. Keycloak підходить, коли кожен захищений застосунок уже підтримує стандартний протокол і на сервері достатньо пам’яті для Java virtual machine (JVM). Zitadel призначений для розробників, які постачають продукт через API, і я не радив би використовувати його на сервері з менш ніж 4 GB пам’яті.

Спочатку виберіть рішення, а потім встановлюйте його. Після вибору покрокове встановлення authentik на VPS допоможе налаштувати систему.

Скільки оперативної пам’яті насправді потрібно кожному з них?

Почніть із мінімальних ресурсів, оскільки саме вони визначають короткий список ще до оцінювання функцій. Наведені нижче цифри взято з опублікованих даних самих проєктів станом на October 2026. Це рекомендації постачальників, а не результати навантажувального тестування.

ГрафікPublished minimum RAM and base container count, October 2026
Дані, на яких побудовано графік
[
  {
    "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, сервер і worker. Зазначений параметр хоста має охоплювати всі три компоненти, включно з базою даних.

Keycloak публікує найточніший показник серед 3 проєктів. У посібнику з визначення розміру зазначено: «базове використання пам’яті Pod, включно з кешами даних Realm і 10,000 кешованих сесій, становить 1250 MB RAM». Ці 1250 MB стосуються сервера Keycloak із такими кешами. У посібнику база даних розраховується окремо, тому 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.

На сторінці compose для Zitadel також вказано 2 GB — ті самі 2048 MB. Це передумова для всього посібника: від quickstart до етапу homelab або напівпродуктивного використання. Для подальшого визначення розміру слід звернутися до сторінки про продуктивне використання. Сам процес Zitadel потребує «приблизно 512MB RAM і може працювати менш ніж з одним ядром CPU». Найбільше ресурсів потребує база даних: «приблизно одне ядро CPU на 100 requests per second (req/s) і 4GB RAM на ядро». Для хешування паролів потрібно «4 ядра CPU, доступні для цієї мети», оскільки сплеск входів спричиняє різке зростання навантаження на CPU. Офіційний compose для v4 запускає 4 контейнери ще до додавання інших компонентів: Traefik як проксі, Zitadel API, окремий контейнер Login UI і PostgreSQL. Redis та OpenTelemetry collector підключаються через необов’язкові compose profiles.

Отже, Keycloak і authentik працюватимуть на VPS із 4 GB, залишаючи запас для застосунків, які ви захищаєте. Zitadel запуститься на 2 GB, але під час кожного входу конкуруватиме за пам’ять зі своїм PostgreSQL. Я не запускав би Zitadel із менш ніж 4 GB, а для сервера, на якому також розміщені застосунки, заклав би 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 -d

Server публікує порти 9000 і 9443. Перший перехід на порт 9000 запускає початкове налаштування, де потрібно встановити пароль для користувача за замовчуванням akadmin. Налаштуйте reverse proxy зі справжнім сертифікатом перед ним, перш ніж цей порт стане доступним з інтернету.

Keycloak — це один процес і база даних, яку ви надаєте самостійно. У quickstart використовується один контейнер.

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-dev

start-dev призначений для ознайомлення. Він працює з локальною базою даних для розробки та без TLS (transport layer security), тому контейнер, запущений у такий спосіб, після видалення видалить і ваш realm. Для production використовуйте start: справжній PostgreSQL через KC_DB і публічне ім’я хоста через KC_HOSTNAME. У production guide 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

Установіть ZITADEL_MASTERKEY у .env до першого запуску. Це 32-символьний ключ, який Zitadel використовує для шифрування секретів у базі даних. Якщо втратити цей ключ, доступ до цих секретів буде втрачено. Якщо ви вперше запускаєте такі стеки, у матеріалі основи Docker Compose для VPS описано вибір томів і політик перезапуску, від яких залежить, чи переживе ваш identity provider перезавантаження.

Які протоколи підтримує кожен із них?

Усі три підтримують OpenID Connect (OIDC) — рівень автентифікації поверх OAuth 2.0, який використовують сучасні застосунки. Усі три також підтримують SAML 2.0 (security assertion markup language) — старіший стандарт, який досі постачається з корпоративним програмним забезпеченням. Основна відмінність стосується LDAP (lightweight directory access protocol), де один термін охоплює дві протилежні функції.

Читання з LDAP означає, що SSO-сервер перевіряє паролі в каталозі, який ви вже використовуєте. Keycloak робить це через user federation. Zitadel також підтримує цю функцію: у його документації описано, як "підключити LDAP-сервер як постачальника ідентифікаційних даних у ZITADEL".

Надання LDAP означає, що застосунок, який підтримує лише LDAP, може виконати bind до вашого SSO-сервера так, ніби це каталог. Таку функцію має лише authentik. Його LDAP provider робить "усіх користувачів і групи в базі даних authentik доступними для пошуку через LDAP-каталог" за допомогою виділеного LDAP outpost; LDAPS доступний через порт 636. За замовчуванням користувач після bind може шукати лише власні дані та групи. Тому обліковий запис служби, з яким застосунок виконує bind, має отримати дозвіл "Search full LDAP directory", щоб бачити всіх користувачів. У документації описано лише bind і пошук, без операцій запису. Тому вважайте цей каталог доступним лише для читання. Одноразовий код додається до пароля через крапку з комою, як у password;123456. SMS-аутентифікатори під час bind не підтримуються.

Якщо один із ваших застосунків підтримує лише LDAP, на цьому порівняння завершується. Keycloak і Zitadel не зможуть відповісти на такий bind. Тому поруч із ними доведеться запустити окремий каталог і синхронізувати два списки користувачів.

А як бути із застосунками, які взагалі не мають входу?

Відповідь — forward auth. Це поширений сценарій для self-hosted сервера. Reverse proxy запитує SSO-сервер, чи дозволено запит, перш ніж передати його upstream. Застосунок за проксі нічого не знає про SSO. Він отримує запити, які проксі вже перевірив, зазвичай з іменем користувача в заголовку.

authentik's proxy provider підтримує це в трьох задокументованих режимах. У режимі "Proxy" authentik outpost сам передає трафік до upstream-застосунку. Режим "Forward auth (single application)" залишає передавання трафіку наявному reverse proxy і використовує authentik лише для перевірки автентифікації. Режим "Forward auth (domain level)" захищає всі застосунки в одному батьківському домені за допомогою одного провайдера. Режим domain level зручніший, але має задокументоване обмеження: він "cannot enforce different application-level authorization rules for each protected application", тому всі застосунки в цьому домені використовують один набір політик.

У Keycloak цього немає. Його супутній проксі Keycloak Gatekeeper перейменували на Louketo Proxy, у листопаді 2020 він досяг завершення життєвого циклу, а в грудні 2020 його архівували на GitHub. Щоб захистити застосунок без підтримки OIDC, потрібно запустити перед ним окремий компонент, зазвичай oauth2-proxy, налаштований на клієнт Keycloak. Zitadel також не має власного режиму forward auth, тому потрібне те саме додаткове встановлюване, контрольоване й оновлюване програмне забезпечення.

Саме на цьому додатковому переході конфігурація reverse proxy перестає бути простою. Перед підключенням auth middleware прочитайте як Traefik обслуговує кілька застосунків Docker Compose.

Наскільки складний процес оновлення?

Станом на 25 October 2026 актуальні релізи: Keycloak 26.8.1, authentik 2026.8.5 і Zitadel v4.20.0. Усі три продукти виконують міграції схеми PostgreSQL, тобто кожне оновлення змінює базу даних. Щоразу спочатку створюйте резервну копію бази даних. Ця звичка важливіша за будь-яку функцію в цьому порівнянні.

authentik має найсуворіше правило і прямо це зазначає: "Оновлення мають виконуватися послідовно між основними версіями; не переходьте безпосередньо зі старішої основної версії на найновішу версію." Перед переходом до наступної версії потрібно оновитися до найновішого patch-релізу поточної версії, а "authentik не підтримує зниження версії". Якщо календарний проєкт відстає на рік, одне оновлення перетворюється на ланцюжок оновлень, кожне з власною міграцією бази даних.

У посібнику з оновлення Keycloak наведено порядок дій: переглянути зміни міграції з попередньої версії, оновити сервер, а потім оновити адаптери. Міграція бази даних виконується автоматично. Також її можна експортувати й застосувати вручну, що зручно, якщо потрібно переглянути зміни до їх застосування. Недолік Keycloak полягає саме в цьому перегляді. У примітках до релізів є застарілі функції та зміни поведінки, які легко пропустити, але наслідки пропуску можуть бути значними.

Zitadel відокремлює фази init і setup від запущеного сервера. У рекомендаціях для production радять тримати їх окремо, щоб масштабування не повторювало роботу setup. На одному VPS це здебільшого означає, що крок setup має завершитися до того, як API повідомить про справний стан. Саме тому compose-файл містить health checks, а команда запуску використовує --wait.

Для кого створено кожен проєкт і де кожен має обмеження

Keycloak — це сервер ідентифікації Red Hat, створений для організацій із realms, групами, зіставленням ролей і наявним корпоративним каталогом. Це найповніша реалізація стандартів серед трьох продуктів. Він втрачає переваги на VPS із 2 GB RAM, де працюють чотири self-hosted застосунки, половина з яких не підтримує OIDC. Сервер Keycloak потребує 1250 MB RAM ще до запуску бази даних. Вам доведеться опанувати модель realm, розраховану на компанію, а для застосунків, які вас фактично цікавили, усе одно встановити oauth2-proxy.

authentik створено для self-hosting-аудиторії, і це видно з переліку функцій. Він підтримує forward auth і має LDAP provider, а login flows можна створювати у візуальному редакторі. Він втрачає переваги, коли потрібна підтримка постачальника без enterprise-бюджету або передбачуваний цикл випусків, який не змінюється кожні кілька тижнів. Підтримка доступна лише за платною підпискою: ticket support входить до Enterprise subscriptions вартістю понад $1k, а dedicated support із SLA — до Enterprise Plus, яка коштує від $20k на рік. Calendar versioning без можливості downgrade і пропуску версій створює реальне операційне навантаження, а flow editor вимагає опанування цілої моделі, хоча фактична проблема може полягати лише в одному OIDC-клієнті.

Zitadel створено для розробників, які вбудовують автентифікацію у продукт, що постачають, із потужним API та multi-tenancy як базовими функціями. Саме в цьому сценарії він і має обмеження. Чотири контейнери, відсутність forward auth і база даних, розмір якої розраховується як 4 GB на core, — невідповідна архітектура для одного VPS із password manager і wiki за ним.

Що я б запускав на одному VPS і як

Для одного VPS із трьома або чотирма self-hosted застосунками запускайте authentik. Усі три продукти надають екран входу. Вирішальним фактором є те, що деякі ваші застосунки ніколи не підтримуватимуть OIDC, а authentik вирішує цю проблему за допомогою вбудованого forward auth, без додаткового компонента поруч із ним.

Якщо можливо, виділіть для нього 4 GB, а 2 GB — лише якщо інші застосунки невеликі. Не відкривайте порт 9000 для публічного інтернету та завершуйте TLS на reverse proxy перед ним. Щоночі створюйте дампи PostgreSQL і зберігайте їх за межами цього сервера, оскільки identity provider без резервної копії є єдиною точкою відмови для кожного застосунку за ним. Запускайте стек від імені окремого непривілейованого облікового запису, а не root: у матеріалі налаштування користувачів із мінімальними привілеями на VPS описано потрібні обліковий запис і права власника файлів.

Вибирайте Keycloak, якщо всі застосунки, які ви захищаєте, уже підтримують OIDC або SAML, або якщо вам потрібна детальна модель ролей, яку надають realms у Keycloak. Вибирайте Zitadel, якщо ви створюєте застосунок, у якому реєструватимуться інші користувачі, і вам потрібні його API та модель tenant. Жоден із цих варіантів не призначений для сценарію з трьома застосунками на одному сервері, про який ідеться в цій статті.

Перші типові причини збоїв

У Keycloak немає даних після перезапуску. Ви запустили його з start-dev, який використовує локальну базу даних для розробки. У контейнері без volume видалення контейнера видаляє realm. Перейдіть на start, указавши в KC_DB=postgres справжню базу даних.

Контейнер worker authentik зникає на малопотужному сервері. Worker і server використовують один і той самий image та запускають процеси Python, а PostgreSQL також потребує частину ресурсів хоста з 2 GB пам’яті. Виконайте docker compose ps, щоб перевірити, який сервіс завершив роботу, а потім перегляньте dmesg на наявність завершення через нестачу пам’яті, перш ніж шукати помилку в застосунку.

Console Zitadel не працює за вашим reverse proxy. API Zitadel використовує gRPC, якому потрібен HTTP/2 на всьому шляху до upstream. На сторінці вимог зазначено, що 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 не працює.

Кожен застосунок повертає вас на сторінку входу. Публічний URL SSO-сервера та URL, налаштований у застосунку, мають точно збігатися, включно зі схемою та портом. У Keycloak це називається параметром hostname, а в Zitadel — external domain. Якщо значення не збігаються, застосунок перенаправляє на сторінку входу, яку сервер не розпізнає як власну, і браузер переходить між ними по колу.

FAQ

Який із трьох варіантів підходить для VPS із 2 GB?

authentik і Keycloak. Заявлена вимога authentik — хост щонайменше з 2 ядрами CPU і 2 GB RAM, а в посібнику з розрахунку ресурсів Keycloak базовий обсяг пам’яті для сервера без бази даних становить 1250 MB. Для обох варіантів 2 GB — це впритул після додавання застосунків, які ви захищаєте, тому 4 GB слід вважати комфортним мінімумом. У compose-посібнику Zitadel також указано 2 GB; на такому обсязі описано запуск у homelab або напівпродуктивному середовищі. Проте в рекомендаціях для production зазначено 4 ядра CPU для хешування паролів і 4 GB RAM на ядро бази даних, тому після появи реального трафіку входу 2 GB буде впритул.

Чи можуть Keycloak або Zitadel захистити застосунок, у якого немає власної автентифікації?

Не самостійно. Жоден із них не постачається з компонентом forward auth. Старий супутній proxy Keycloak, Louketo Proxy, досяг end of life у November 2020, а його GitHub repository заархівовано з December 2020, тому не слід будувати рішення на ньому. Розмістіть oauth2-proxy або подібний компонент між reverse proxy і застосунком та вкажіть у ньому OIDC client на SSO-сервері. authentik підтримує це безпосередньо через свій proxy provider у режимі "Forward auth (single application)" або "Forward auth (domain level)".

Який із них може працювати як LDAP-сервер для застосунку, що підтримує лише LDAP?

authentik. Його LDAP provider працює на outpost і дає змогу шукати користувачів і групи в authentik через LDAP; LDAPS доступний на port 636. Документація описує лише bind і search, тому вважайте цей інтерфейс доступним лише для читання. Keycloak і Zitadel працюють у протилежному напрямку: обидва читають дані з наявного LDAP directory як із джерела користувачів, і жоден не відповідає на LDAP bind від застосунку.

Чи можна пропускати версії під час оновлення authentik?

Ні. У документації зазначено, що оновлення мають виконуватися послідовно через major releases, і не слід переходити зі старої major version одразу на найновішу. Спочатку перейдіть на останній patch release у межах кожної версії, а потім послідовно переходьте на наступну версію. Створюйте резервну копію PostgreSQL перед кожним кроком, оскільки authentik не підтримує downgrade, а міграції виконуються лише вперед.

Чи була ця стаття корисною?

#sso#authentik#keycloak#zitadel#self-hosted#identity