使用 Docker 部署 Authentik 统一认证服务 - 其一

1070 字

5 分钟

使用 Docker 部署 Authentik 统一认证服务 - 其一

2026-02-05

SSO

/

Authentik

前情提要#

主播有一些服务想分享给我的朋友，但是让朋友给每个服务都注册且设置密码非常麻烦
虽然我目前也在使用朋友提供的 SSO(单点认证) 服务，但是他的服务面向于自己人，因此决定自建
朋友目前用的是 Authentik，因此我也使用

TIP
Authentik 是什么?
Authentik 是一个现代化的开源身份管理和身份验证平台，专为企业和个人提供身份验证、授权和访问管理解决方案

goauthentik

/

authentik

Waiting for api.github.com...

00K

0K

Waiting...

系列总览#

其一 - 使用 Docker 部署 Authentik 统一认证服务 - 点我这里跳转
其二 - 为 Authentik 配置 OIDC 认证服务 - 点我这里跳转
其三 - 为 Authentik 配置 LDAP 认证服务 - 点我这里跳转

准备材料#

一台装有 Docker 的 Linux 发行版 服务器
一个正常的网络环境

开始部署#

WARNING
📕本部署教程很多步骤都借鉴了 Authentik 官方文档
🌏最后的参考文献会指向对应网站
🤔相比起来官方文档，这里的优势是能用中文来讲解部署流程
🕶如果你熟练英文，更推荐你翻到最下面的 参考文献 去寻找官方教程！点我直达

一.🐋 获取官方编排#

Authentik 的官方提供了一个 Docker Compose(编排) 脚本，请打开你的终端并执行以下命令

1
wget https://docs.goauthentik.io/docker-compose.yml

此命令会帮助你下载官方的编排文件

WARNING
始终建议你的编排文件保存在一个单独的文件夹里面
比如 mkdir Authentik && cd Authentik 然后下载编排文件

如果呢 ~ 不方便下载的话，以下是 Authentik 的编排原文！ 2026-2-8

1
services:
2
  postgresql:
3
    env_file:
4
    - .env
5
    environment:
6
      POSTGRES_DB: ${PG_DB:-authentik}
7
      POSTGRES_PASSWORD: ${PG_PASS:?database password required}
8
      POSTGRES_USER: ${PG_USER:-authentik}
9
    healthcheck:
10
      interval: 30s
11
      retries: 5
12
      start_period: 20s
13
      test:
14
      - CMD-SHELL
15
      - pg_isready -d $${POSTGRES_DB} -U $${POSTGRES_USER}
16
      timeout: 5s
17
    image: docker.io/library/postgres:16-alpine
18
    restart: unless-stopped
19
    volumes:
20
    - database:/var/lib/postgresql/data
21
  server:
22
    command: server
23
    depends_on:
24
      postgresql:
25
        condition: service_healthy
26
    env_file:
27
    - .env
28
    environment:
29
      AUTHENTIK_POSTGRESQL__HOST: postgresql
30
      AUTHENTIK_POSTGRESQL__NAME: ${PG_DB:-authentik}
31
      AUTHENTIK_POSTGRESQL__PASSWORD: ${PG_PASS}
32
      AUTHENTIK_POSTGRESQL__USER: ${PG_USER:-authentik}
33
      AUTHENTIK_SECRET_KEY: ${AUTHENTIK_SECRET_KEY:?secret key required}
34
    image: ${AUTHENTIK_IMAGE:-ghcr.io/goauthentik/server}:${AUTHENTIK_TAG:-2025.12.3}
35
    ports:
36
    - ${COMPOSE_PORT_HTTP:-9000}:9000
37
    - ${COMPOSE_PORT_HTTPS:-9443}:9443
38
    restart: unless-stopped
39
    volumes:
40
    - ./data:/data
41
    - ./custom-templates:/templates
42
  worker:
43
    command: worker
44
    depends_on:
45
      postgresql:
46
        condition: service_healthy
47
    env_file:
48
    - .env
49
    environment:
50
      AUTHENTIK_POSTGRESQL__HOST: postgresql
51
      AUTHENTIK_POSTGRESQL__NAME: ${PG_DB:-authentik}
52
      AUTHENTIK_POSTGRESQL__PASSWORD: ${PG_PASS}
53
      AUTHENTIK_POSTGRESQL__USER: ${PG_USER:-authentik}
54
      AUTHENTIK_SECRET_KEY: ${AUTHENTIK_SECRET_KEY:?secret key required}
55
    image: ${AUTHENTIK_IMAGE:-ghcr.io/goauthentik/server}:${AUTHENTIK_TAG:-2025.12.3}
56
    restart: unless-stopped
57
    user: root
58
    volumes:
59
    - /var/run/docker.sock:/var/run/docker.sock
60
    - ./data:/data
61
    - ./certs:/certs
62
    - ./custom-templates:/templates
63
volumes:
64
  database:
65
    driver: local

二.🗒 在当前目录下生成配置文件#

因为这是第一次安装，所以你需要生成两个东西:密码 和 密钥,请使用终端执行以下命令

1
echo "PG_PASS=$(openssl rand -base64 36 | tr -d '\n')" >> .env
2
echo "AUTHENTIK_SECRET_KEY=$(openssl rand -base64 60 | tr -d '\n')" >> .env

三.🚀 ak，启动！#

现在，你可以使用终端执行以下命令启动 Authentik 了

1
docker compose up -d

现在你可以访问 http://<你服务器的 IP 地址>:9000/ 去访问你刚刚部署好的 Authentik 了！🎉

等等！看了一会你会发现有点不对劲: 为什么访问 http://<你服务器的 IP 地址>:9000 是直接到登录页面的，我也没开始注册呀🤔，急急急！🤯
也请您稍安勿躁，请看下面👇

⚙ 访问初始化地址#

实际上，Authentik 提供了一个链接来让你完成初始化⚙
请使用你的浏览器访问以下地址

1
http://<你服务器的 IP 地址>:9000/if/flow/initial-setup/

完成初始配置后，你将登录并进入到 Authentik 的用户门户里

这下，真的恭喜你已经全部完成部署流程了！🚀

四.📧 配置全局邮箱(可选但推荐)#

Authentik 可以在配置文件里配置 SMTP 发件服务器 用于向管理员们推送警报，配置问题和新版本推送
也请不用担心你的发信次数少得可怜或者目前不想配置，Authentik 仍然可以为每个注册，忘记密码的流程里单独配置其独特的 SMTP 发信服务器

使用你的文本编辑器打开 .env 文件添加以下文本

1
# 填写你的 SMTP 服务器提供者地址
2
AUTHENTIK_EMAIL__HOST=localhost
3
AUTHENTIK_EMAIL__PORT=25
4
# 填写你的邮箱名和密码
5
AUTHENTIK_EMAIL__USERNAME=
6
AUTHENTIK_EMAIL__PASSWORD=
7
# 是否使用 StartTLS，端口为 587
8
AUTHENTIK_EMAIL__USE_TLS=false
9
# 是否使用 SSL，端口为 465
10
AUTHENTIK_EMAIL__USE_SSL=false
11
AUTHENTIK_EMAIL__TIMEOUT=10
12
# 邮件是从哪个地址发出的，填写其邮箱地址
13
AUTHENTIK_EMAIL__FROM=authentik@localhost