Quarkus Guides：按分类与版本查阅 Quarkus 开发指南，覆盖 REST、安全认证与原生编译

首页的分类与筛选

指南首页左侧列出 Getting started、Packaging、Core、Web、Data、Messaging 等分类，分类下再细分具体主题。例如 Packaging 下有 JARs、Native 与 Containers，Web 下有 HTTP、REST、GraphQL 与 WebSockets。

页面顶部的版本下拉菜单可以选择最新版本或历史版本，菜单中可以看到 3.33、3.27、3.20 等版本，以及 Main 快照版。关键词筛选框可以直接输入功能名称来定位指南。

Quarkus Guides 首页截图，顶部为站点导航，正文标题为 Guides，下方是版本选择（Latest）、关键词筛选框、左侧分类列表，以及 Getting started 入门指南卡片

入门与打包

入门类指南包括“Creating your first application”，即在 15 分钟左右构建一个带实时重载、依赖注入和测试的 REST 应用；另一篇“Your second Quarkus application”介绍更多开发体验方面的功能。

打包类指南说明了 JAR、uber-JAR、AOT 缓存、jlink 镜像、原生可执行文件和容器镜像等打包方式，并给出如何根据工作负载选择的建议。

以 OIDC Bearer 令牌保护服务

“Protect a service application by using OpenID Connect (OIDC) Bearer token authentication”是一篇典型的功能指南。它说明如何使用 Quarkus OpenID Connect（OIDC）扩展，为 Jakarta REST 端点启用 Bearer 令牌认证。令牌由 Keycloak 等符合 OIDC 与 OAuth 2.0 规范的授权服务器签发，Quarkus 服务则用授权服务器提供的验证密钥检查令牌签名和有效期。

指南的步骤依次为创建 Maven 项目、编写应用、配置应用、在开发模式下运行、启动并配置 Keycloak 服务器，然后分别以 JVM 模式和原生模式运行并测试。如果需要保护网页应用，指南另有基于 OIDC 授权码流程的专门说明。

OpenID Connect（OIDC）Bearer 令牌认证指南页截图，标题为 Protect a service application by using OpenID Connect (OIDC) Bearer token authentication，左侧为本页目录，正文开头说明使用 Quarkus OIDC 扩展保护 Jakarta REST 应用

配置与参考

配置类指南包括“All configuration options”，按扩展列出全部配置属性；“YAML configuration”说明可以用 application.yaml 代替 application.properties；“Mapping configuration to objects”介绍如何把多个配置项组织为一个对象。

另有 HTTP、Dev Services、测试和原生编译等参考页面，篇幅较长，适合在遇到具体问题时查阅。

语言版本

指南首页的语言链接包括英文原版，以及葡萄牙语、西班牙语、简体中文和日语等站点。