homelab-wiki/services/authelia.md

title, lifecycle, evidence, last_reviewed, last_verified, sources

title	lifecycle	evidence	last_reviewed	last_verified	sources
Authelia	active	documented	2026-09-16	null	维护者于 2026-09-16 确认当前状态

Authelia

Authelia 已作为 homelab 唯一的主 OIDC broker 工作，当前状态为 active。 此状态由维护者于 2026-09-16 明确，本轮未查询运行环境。

用途与入口

Authelia 承担人类用户的统一登录与应用 OIDC 接入。现有架构中，Samba AD 提供用户目录， Authelia 提供网页认证与 OIDC；机器和 workload 身份由 SPIFFE/SPIRE 提供。 SPIRE 的 OIDC discovery 用于机器身份验签，不构成另一个人类登录 broker。

登录入口沿用源码仓库记录：https://auth.ddupan.top。 从已接入的应用选择其 SSO 登录入口，按 Authelia 页面完成认证后返回应用。 具体应用入口和访问权限仍由各服务文档说明。

当前状态与历史记录

源码工作区 apps/authelia/README.md 中将 OIDC 描述为后续阶段的内容属于旧记录， 不能继续作为当前部署状态依据。旧 Keycloak、Casdoor 位于源码仓库 archive/， 不属于当前 OIDC 登录方案；目前无需为统一身份而重新引入它们。

本次只更新知识库状态，未修改原工作区 README，也未将 broker active 扩大解释为 所有应用都已接入 OIDC。现有 forward-auth 接入与 OIDC 是不同的应用认证方式， 具体配置继续以各服务说明为准。

维护入口

以下路径相对于 homelab-infra：

• apps/authelia/：Authelia 部署配置；README 中过时的 OIDC 阶段说明待同步。
• infrastructure/samba-ad/README.md：用户目录与 AD。
• platform/envoy-gateway/README.md：网关认证集成。
• archive/keycloak/RETIRED.md、archive/casdoor/RETIRED.md：旧身份方案的退役记录。

新增应用的 OIDC 接入与权限配置在对应源码和服务文档中维护，不在知识库保存实际 client secret。