后台、面板、监控页挂在公网,只靠一个密码,撞库成功就全丢。加一层 2FA 是最便宜的止损,但自己写登录页容易出错,Authelia 把这件事标准化了。
Authelia 是什么
Authelia 是开源的认证和授权网关:提供登录页、2FA、会话和访问控制,通过 Nginx 的 auth_request 或 Traefik 的 ForwardAuth 保护后面的服务。它不存业务数据,只做“能不能进”。
部署组件
最小部署只要 Authelia 一个容器;生产建议加 Redis 存会话,用户库可以用文件、LDAP 或数据库。
docker run -d --name authelia \
-p 9091:9091 \
-v /data/authelia:/config \
authelia/authelia:latest
配置文件挂到 /config/configuration.yml,用户库和密钥也放这个目录,权限收紧。
最小配置
server:
address: 'tcp://:9091'
log:
level: info
authentication_backend:
file:
path: /config/users.yml
access_control:
default_policy: deny
rules:
- domain: app.example.com
policy: two_factor
默认拒绝,再按域名放行;别一上来 default_policy: one_factor,等于没保护。

Nginx 接入
location / {
auth_request /authelia;
auth_request_set $user $upstream_http_remote_user;
proxy_set_header Remote-User $user;
proxy_pass http://app:8080;
}
location = /authelia {
internal;
proxy_pass http://127.0.0.1:9091/api/verify?rd=https://auth.example.com;
proxy_set_header X-Original-URL $scheme://$http_host$request_uri;
}
登录页单独一个域名,证书也要配;auth_request 失败会返回 401,前端要能处理跳转。
Traefik 接入
Traefik 用 ForwardAuth 中间件,把认证请求转到 Authelia,再把用户头传给后端。中间件挂在 router 上,别挂错到入口点。

2FA 怎么配
Authelia 支持 TOTP 和 WebAuthn。TOTP 兼容性好,WebAuthn 更安全但依赖浏览器/硬件。建议:
- 管理员强制 2FA
- 普通用户可选,逐步推
- 备份恢复码,别只存手机
- 丢失设备走人工重置流程

香港还是德国
Authelia 是认证入口,用户到它的延迟直接影响登录体验。
- 香港:大陆和亚洲用户近,适合内部后台
- 德国:欧盟用户近,数据位置更合规
- 美国:北美团队近
如果用户主要在欧盟,放德国;大陆团队用香港。认证服务不要和业务跨洲,登录会明显变慢。
安全细节
- 密钥、SMTP 密码、LDAP 密码用文件挂载,别写进镜像
- 会话 Cookie 开 Secure、HttpOnly、SameSite
- 登录接口限流,防撞库
- 管理路径单独限制来源 IP
- 审计登录失败和 2FA 重置
用户库
小团队用文件用户库够,成员多了接 LDAP/AD;别在多个地方维护同一批账号。
会话
会话过期时间按敏感度设,管理后台短一点;Redis 存会话,重启不丢登录。
审计
记录登录成功/失败、2FA 重置和策略变更;异常登录要能告警。
常见误区
“加了登录页就安全”忽略了弱密码和撞库;“默认放行”等于没配;“2FA 一定兼容”要先测客户端。
WebAuthn
支持硬件密钥和指纹,比 TOTP 抗钓鱼;但用户设备兼容性要先测,别一刀切。
备份
备份配置、用户库和密钥;恢复后测试登录和 2FA,别只看容器起来了。
部署位置
认证入口和业务同区域,别让登录跨洲;多区域可以部署多个实例,共享用户库。
访问控制
按域名、路径、用户组设策略;管理路径要求 2FA,公开页面可以单因素,别一套规则套全部。
升级
升级前看 release notes 和配置变更,备份用户库;跨版本可能改字段,先在测试环境跑。
先把登录和 2FA 跑通,再加策略和用户组。
策略从紧到松,先保护管理后台,再逐步覆盖内部服务。
先保护入口,再谈细粒度权限。
先把管理员账号接进去,确认 2FA 能登录、能重置,再推广到普通用户。
先跑通登录,再谈策略和用户组;别一上来全站强制 2FA。
管理员先上 2FA,普通用户再逐步推。
先把管理后台锁住,再谈全站 SSO。
先把入口守住,再谈体验。
先让管理员用起来,再推给团队。
先让管理员用起来,再推给团队,别一上来全站强制。
先锁后台,再谈全站。
常见问题 FAQ
Q1:Authelia 能替代 SSO 吗?
能覆盖常见自托管服务的 SSO/2FA,但复杂权限和多租户要看需求;它不是完整的 IAM。
Q2:一定要 Redis 吗?
单机可以用内存会话,多副本或重启保持会话建议 Redis。
Q3:香港还是德国节点?
用户在哪放哪;欧盟用户选德国,大陆/亚洲选香港。
Q4:配错了会不会锁死自己?
会。保留一个 bypass 规则或控制台访问方式,改配置前备份。
Q5:能商用吗?
看 Authelia 许可证;商用前确认授权和数据处理方式。
总结
Authelia 把登录、2FA 和访问控制从业务里拆出来:默认拒绝、按域名放行、Nginx/Traefik 接入、管理员强制 2FA。节点跟着用户走,密钥和会话安全别省。
需要一台认证网关,可以按小时开一台香港 CN2 节点,先把登录和 2FA 跑通。
先小范围验证,再决定是否全量上线,别急着铺开,真的啊。







