最新指南

Create an application that uses the Micrometer metrics library to collect runtime, extension and application metrics and expose them as a Prometheus (OpenMetrics) endpoint.

Create a new tutorial that guides users through creating, running, and testing a Quarkus application that uses annotations from an imaginary extension.

Get started with Quarkus Security by securing your Quarkus application endpoints with the built-in Quarkus Basic authentication and the Jakarta Persistence identity provider, enabling role-based access control.

This guide explains how your Quarkus application can utilize web sockets to create interactive web applications.

Migrate an application from OpenTracing to OpenTelemetry tracing in Quarkus 3.x.

Learn how to use OpenID Connect (OIDC) and OAuth2 clients with filters to get, refresh, and propagate access tokens in your applications.

Quarkus Security provides comprehensive OpenId Connect (OIDC) and OAuth2 support with its quarkus-oidc extension, supporting both Authorization code flow and Bearer token authentication mechanisms.

Use the Quarkus OpenID Connect (OIDC) extension to secure a Jakarta REST application with Bearer token authentication.

Discover how to secure application HTTP endpoints by using the Quarkus OpenID Connect (OIDC) authorization code flow mechanism with the Quarkus OIDC extension, providing robust authentication and authorization.

Discover some of the features that make developing with Quarkus a joyful experience.

探索Quarkus开发者工具链，让Quarkus开发如此快速和愉快。

了解如何创建您的第一个Quarkus应用程序。

了解有关使用Quarkus开发响应式应用程序的更多信息。

了解更多关于Quarkus在IDE中的整合。

用GraalVM或Mandrel构建原生可执行文件。

Contribute to the documentation by using the recommended diataxis content types, steps, workflow, and style guidance to ensure the content successfully renders on the Quarkus website portal.

You can use Dev Services for Keycloak and the Dev UI for the OpenID Connect (OIDC) Keycloak provider and adapt these services for other OpenID Connect providers.

Enable Basic authentication for your Quarkus project and allow users to authenticate with a username and password.

You can configure your application to use Jakarta Persistence to store users’ identities.

Learn how to upgrade your projects to the latest version of Quarkus

How to use virtual threads in a REST application

Learn how to enable bearer token authorization in your Quarkus application using Keycloak Authorization Services for secure access to protected resources.

This guide demonstrates how your OpenID Connect (OIDC) application can support multitenancy to serve multiple tenants from a single application.

Optionally, use application.yaml instead of application.properties to configure your application.

Quarkus extensions can do a lot, or a little.

The Quarkus Security framework supports multiple authentication mechanisms, which you can use to secure your applications.

HTTP Basic authentication is one of the least resource-demanding techniques that enforce access controls to web resources.

This document explains how to configure well-known social OIDC and OAuth2 providers.

Cross-origin resource sharing (CORS) is an HTTP-header-based mechanism that allows a server to indicate any origins other than its own, from which a browser should permit loading resources.

When using a traditional, blocking, and synchronous framework, processing of each request is performed in a dedicated thread.

Secure HTTP access to Jakarta REST (formerly known as JAX-RS) endpoints in your application with Bearer token authentication by using the Quarkus OpenID Connect (OIDC) extension.

To protect your web applications, you can use the industry-standard OpenID Connect (OIDC) Authorization Code Flow mechanism provided by the Quarkus OIDC extension.

The Quarkus Security architecture provides several built-in authentication mechanisms and is highly customizable.

Quarkus Security is a framework that provides the architecture, multiple authentication and authorization mechanisms, and other tools to build secure and production-quality Java applications.

Quarkus documentation is structured into four distinct content types: concepts, how-tos, tutorials, and references.

Most of the Quarkus tags are registered in the US National Vulnerability Database (NVD) in Common Platform Enumeration (CPE) name format.

Learn how to manage proactive authentication in Quarkus, including customizing settings and handling exceptions.

In the Quarkus Security framework, identity providers play a crucial role in authentication and authorization by verifying user identities.

本指南包括如何使用多种GCP服务。

本指南包括如何在Quarkus中使用Amazon DynamoDB数据库。

本指南包括如何在Quarkus中使用亚马逊身份和访问管理。

本指南介绍了如何在Quarkus中使用亚马逊密钥管理服务。

本指南包括如何在Quarkus中使用Amazon S3云存储。

本指南包括如何在Quarkus中使用亚马逊简单电子邮件服务。

本指南包括如何在Quarkus中使用亚马逊简单通知服务。

本指南涵盖了如何在Quarkus中使用Amazon Simple Queue Service。

本指南包括如何在Quarkus中使用AWS系统管理器。

Quarkus incorporates a pluggable web security layer.

本参考指南解释了如何用Quarkus开发命令行应用程序。

了解更多关于如何配置你的Quarkus应用程序。

Use a unified configuration model to define data sources for Java Database Connectivity (JDBC) and Reactive drivers.

更深入地了解Quarkus对CDI的实现。

本指南包括如何在Quarkus中使用GCP BigQuery。

本指南包括如何在Quarkus中使用GCP Bigtable。

本指南包括如何在Quarkus中使用GCP Firestore。

本指南包括如何在Quarkus中使用GCP PubSub。

本指南包括如何在Quarkus中使用GCP Spanner。

本指南包括如何在Quarkus中使用GCP存储。

了解更多关于配置Quarkus基于Vert.x的HTTP层的信息–如果你使用servlets的话，还有Undertow。

Use Infinispan as the Quarkus cache backend

Infinispan is an in memory distributed data store and cache server that offers flexible deployment options and robust capabilities for storing, managing, and processing data.

Load shedding is the practice of detecting service overload and rejecting requests.

Read about the use of logging API in Quarkus, configuring logging output, and using logging adapters to unify the output from other logging APIs.

本参考指南更详细地解释了Quarkus Mailer的配置和使用。

Management interface configuration

Use Micrometer to collect metrics produced by Quarkus, its extensions, and your application.

This guide is a companion to the Building a Native Executable, Using SSL With Native Images, and Writing Native Applications, guides.

本指南介绍了如何在Quarkus中使用Neo4j图数据库。

You can use Quarkus extensions for OpenID Connect and OAuth 2.0 access token management, focusing on acquiring, refreshing, and propagating tokens.

Typically, you have to register an OIDC client (application) manually in your OIDC provider’s dashboard.

As a Quarkus developer, you configure the Quarkus OpenID Connect (OIDC) extension by setting the following properties in the src/main/resources/application.properties file.

The Quarkus Maven Plugin builds the Quarkus applications, and provides helpers to launch dev mode or build native executables.

Guidelines are provided to help you to contribute clear and consistent content that is also sourced in the required diataxis structure and composition of Quarkus documentation.

了解你需要知道的关于Qute模板引擎的一切。

This guide is the companion from the Getting Started with RabbitMQ.

Use Redis as the Quarkus cache backend

Redis is an in-memory data store used as a database, cache, streaming engine, and message broker.

了解更多关于Scheduler扩展的信息。

This guide is the companion from the Stork Getting Started Guide.

TLS registry configuration and usage

This guide covers how to test your Quarkus web application with Playwright.

This guide covers how to develop, build and serve your npm-compatible web applications such as React, Angular, Vue, Lit, Svelte, Astro, SolidJS, and others alongside Quarkus.

This guide covers how to set up bundling and minification (with source-map) for your web app scripts (JS, JSX, TS, TSX), dependencies (jQuery, htmx, Bootstrap, Lit etc.), and styles (CSS, SCSS, SASS).

The quarkus-narayana-jta extension provides a Transaction Manager that coordinates and expose transactions to your applications as described in the link: Jakarta Transactions specification, formerly known as Java Transaction API (JTA).

本参考指南提供了关于Quarkus使用的Vert.x实例的使用和配置的高级细节。

This guide explains how to benefit from Java 21+ virtual threads in Quarkus application.

The quarkus-websockets-next extension provides a modern declarative API to define WebSocket server and client endpoints.

Learn how to configure gRPC code generation.

Learn how to configure gRPC server and clients.

本指南解释了Quarkus支持的各种方法来验证您的Vault。

本指南解释了你的Quarkus应用程序如何在运行时从Consul读取配置属性。

本指南介绍了如何在Quarkus中使用GCP Secret Manager直接或通过 application.properties 来使用配置属性。

本指南展示了你的Quarkus应用程序如何利用SmallRye响应式消息传递来消费和提供HTTP消息。

用Vault的PKI加密引擎生成X.509证书。

This guide explains how your Quarkus application can utilize OpenTelemetry to provide observability for interactive web applications.

本指南解释了如何使用Sentry来监控你的应用程序，并在发生异常时得到通知。

本指南解释了如何使用HashiCorp Vault在Quarkus中安全地存储您的凭证。

本指南解释了如何使用HashiCorp Vault进行 “加密即服务”。

本指南演示了您的Quarkus应用程序如何利用SmallRye响应式消息通过WebSockets来消费和产生消息。

This guide is the companion from the Getting Started with AMQP 1.0.

将你的数据库凭证存储在Vault中，对其进行保密。

了解更多关于如何使用Apache Tika工具包从文档中提取内容。

本指南解释了如何用JGit访问Git仓库。

了解关于Quarkus类加载基础设施的更多信息。

在开发和测试模式下自动启动AMQP。

This guide explains how you can deploy Quarkus-based AWS Lambdas.

This document explains how to optimize your AWS Lambda application for SnapStart

This guide explains how you can deploy Vert.x Web, Servlet, or RESTEasy microservices as an AWS Lambda.

本指南包括与Apache Camel的系统集成

This reference guide provides an in-depth look on Apache Kafka and Quarkus Messaging extensions.

This reference guide provides an in-depth look on Apache Pulsar and the Quarkus Messaging extensions.

在开发和测试模式下自动启动Apicurio仓库。

This reference guide explains how to enable AppCDS with Quarkus.

本指南解释了如何使用简单的注解来缓存CDI Bean中昂贵的方法调用。

Build and deploy your Quarkus App using Ansible

Integrate Quarkus with the Microsoft Azure functions that you have written.

Deploy Vert.x Web, Servlet, or RESTEasy microservices as a Microsoft Azure Function.

This guide presents what build analytics is and how to configure it.

JSON Web Token (JWT) is defined by the RFC 7519 specification as a compact, URL-safe means of representing claims.

使用Quarkus CLI来创建、构建、运行和管理Quarkus项目的扩展。

一步一步地学习如何构建一个简单的扩展。

了解如何将你的扩展与Quarkus的CDI容器集成。

本指南解释了如何使用Graylog扩展日志格式（GELF）用Logstash或Fluentd集中管理你的日志。

用Picocli扩展简化了命令行应用程序的创建。

Ultimate Packer for eXecutables (UPX) is a compression tool reducing the size of executables.

This guide covers how to interact with an Elasticsearch cluster using the low level REST client or the Elasticsearch Java client.

本指南解释了如何在你的Quarkus应用程序中消费gRPC服务。

Learn how to build and push container images with Jib, OpenShift, Docker, or Podman as part of the Quarkus build.

了解更多关于如何利用SmallRye Context Propagation传递上下文信息的信息。

Cross-Site Request Forgery (CSRF) is an attack that forces an end user to execute unwanted actions on a web application in which they are currently authenticated.

本指南涵盖了如何在OpenShift上部署一个原生应用程序。

本指南解释了如何将Quarkus应用程序部署到谷歌云。

This guide explains how to deploy your gRPC services in Quarkus to Kubernetes.

An introduction to Dev Services and a list of all extensions that support Dev Services and their configuration options.

When testing or running in dev mode Quarkus can provide you with a zero-config database out of the box, a feature we refer to as Dev Services.

Start Elasticsearch automatically in dev and test modes

Start Infinispan automatically in dev and test modes.

Start a Kubernetes API server automatically in dev and test modes.

Quarkus supports a feature called Dev Services that allows you to create various datasources without any config.

With Quarkus Messaging Pulsar extension (quarkus-messaging-pulsar) Dev Services for Pulsar automatically starts a Pulsar broker in dev mode and when running tests.

Dev Services for RabbitMQ automatically starts a RabbitMQ broker in dev mode and when running tests.

Learn how to get your extension to contribute features to the Dev UI (v2).

在Quarkus中如何实现和使用功能。

Provide users with initial code for extensions when generating Quarkus applications on code.quarkus.io and all the Quarkus tooling.

虽然我们鼓励你使用Hibernate ORM与Panache作为你的数据层，但Quarkus以spring-data-jpa扩展的形式为Spring Data JPA提供了一个兼容层。

Spring Data REST简化了基于我们Spring Data兼容层的CRUD应用程序的创建。

本指南解释了Funqy框架的基础知识，这是一个简单的可移植的跨供应商的云功能API。

This guide explains Funqy’s AWS Lambda binding.

本指南解释了Funqy的Google Cloud Platform Functions绑定。

本指南解释了Funqy的HTTP绑定。

This guide explains Funqy’s AWS Lambda HTTP binding.

Use Funqy HTTP binding with Microsoft Azure Functions to deploy your serverless Quarkus applications.

本指南解释了Funqy的Google Cloud Platform Functions HTTP绑定。

本指南解释了Funqy的Knative Events绑定。

This guide explains how to generate SBOMs for Quarkus applications in the CycloneDX format.

Hibernate ORM REST Data with Panache simplifies the creation of CRUD applications based on Jakarta REST and Hibernate ORM.

This guide demonstrates how your Quarkus application can utilize Quarkus Messaging to interact with AMQP.

This guide demonstrates how your Quarkus application can utilize Quarkus Messaging to interact with Apache Kafka.

This guide demonstrates how your Quarkus application can utilize Quarkus Messaging to interact with Apache Pulsar.

This guide demonstrates how your Quarkus application can utilize Quarkus Messaging to interact with RabbitMQ.

The essence of distributed systems resides in the interaction between services.

本指南解释了如何部署基于Quarkus的Google Cloud Functions。

本指南介绍了如何将Vert.x Web、Servlet或RESTEasy微服务部署为Google Cloud Function。

本指南解释了如何在你的Quarkus应用程序中实现gRPC服务。

This reference guide explains how to configure initialization tasks

Quarkus DI solution is based on the Jakarta Contexts and Dependency Injection 4.1 specification.

Dev UI extension for Apache Kafka for development purposes.

在开发和测试模式下自动启动Apache Kafka。

本指南演示了如何使用Fabric8 Kubernetes客户端与你的Kubernetes集群互动。

使用ConfigMaps作为Quarkus应用程序的配置源。

本指南涵盖了如何在Kubernetes上部署一个原生应用程序。

将多个配置属性分组到一个对象中。

Migrating from RESTEasy Classic to Quarkus REST (formerly RESTEasy Reactive) is straightforward in most cases, however there are a few cases that require some attention.

Mutiny is an intuitive, reactive programming library.

本指南涵盖了使用LRA来协调跨服务的活动。

Entry point for Observability DevServices

OTel-LGTM is all-in-one Docker image containing OpenTelemetry’s OTLP as the protocol to transport metrics, tracing and logging data to an OpenTelemetry Collector which then stores signals data into Prometheus (metrics), Tempo (traces) and Loki (logs), only to have it visualized by Grafana.

This guide covers packaging and releasing CLI applications using the JReleaser tool.

Quarkus extensions are distributed as Maven JAR artifacts that application and other libraries may depend on.

了解更多关于扩展仓库的概念，以及如何使用自己的扩展仓库。

虽然我们鼓励你使用Cache扩展来进行应用级缓存，但Quarkus以spring-cache扩展的形式为Spring Cache提供了一个兼容层。

虽然我们鼓励你使用CDI注解进行注入，但Quarkus以spring-di扩展的形式为Spring依赖注入提供了一个兼容层。

While you are encouraged to use the Quarkus Security layer to secure your applications, Quarkus provides a compatibility layer for Spring Security in the form of the spring-security extension.

While you are encouraged to use Jakarta REST annotations for defining REST endpoints, Quarkus provides a compatibility layer for Spring Web in the form of the spring-web extension.

Event-driven messaging systems have become the backbone of most modern applications, enabling the building of message-driven microservices or complex data streaming pipelines.

了解关于Quarkus响应式架构的更多信息。

This guide explains how to benefit from Java virtual threads when implementing a gRPC service.

This guide explains how to benefit from Java virtual threads when writing message processing applications in Quarkus.

Develop and build your Quarkus application with Gradle

Develop and build your Quarkus application with Maven

Learn more about creating all kinds of Web applications with Quarkus.

虽然我们鼓励你使用Scheduler或Quartz扩展来安排任务，但Quarkus以spring-scheduled扩展的形式为Spring Scheduled提供了一个兼容层。

To ease the containerization of native executables, Quarkus provides a base image providing the requirements to run these executables.

了解更多关于如何利用Qute模板引擎在你的应用程序中使用模板。

在开发和测试模式下自动启动Redis。

你的计划任务需要集群支持？本指南解释了如何使用Quartz扩展来实现这一点。

用jbang轻松实现基于Quarkus的脚本。

Use encrypted configuration values to protect sensitive passwords, secrets, tokens and keys.

了解更多关于如何使用我们的响应式电子邮件客户端从Quarkus应用程序发送电子邮件。

本指南展示了你的Quarkus应用程序如何通过SmallRye容错扩展来利用SmallRye容错规范。

本指南解释了如何利用SmallRye GraphQL来实现GraphQL服务。

本指南解释了如何利用SmallRye GraphQL客户端来消费GraphQL服务。

本指南展示了您的Quarkus应用程序如何利用SmallRye Health扩展。

本指南展示了你的Quarkus应用程序如何利用SmallRye Metrics扩展。

This reference guide covers the QuarkusComponentTestExtension, a JUnit extension to ease the testing of components and mocking of their dependencies.

Hibernate Search Standalone allows you to index your entities in an Elasticsearch/OpenSearch cluster and easily offer full text search in all your applications, even without Hibernate ORM.

Hibernate Search with Hibernate ORM allows you to index your entities in an Elasticsearch/OpenSearch cluster and easily offer full text search in all your Hibernate ORM-based applications.

Use Apache Kafka, Json Schema serialized records, and connect to a schema registry.

Hibernate ORM is the de facto Jakarta Persistence implementation and offers you the full breath of an Object Relational Mapper.

This guide explains how Java Flight Recorder (JFR) can be extended to provide additional insight into your Quarkus application.

The Quarkus Keycloak Admin Client and its reactive twin support Keycloak Admin Client which can be used to configure a running Keycloak server.

本指南涵盖了如何使用Liquibase扩展来管理你的模式迁移。

Liquibase is an open source tool for database schema change management, it allows managing MongoDB databases via it’s MongoDB Extension.

This guide explains how your Quarkus application can utilize OpenTelemetry Logging to provide distributed logging for interactive web applications.

This guide explains how your Quarkus application can utilize OpenTelemetry to provide metrics for interactive web applications.

This guide explains how your Quarkus application can utilize OpenTelemetry Tracing to provide distributed tracing for interactive web applications.

Podman is an open-source, daemonless, and rootless container engine for developing, managing, and running OCI Containers on Linux, Windows and Mac.

本指南展示了你的Quarkus应用程序如何使用LDAP目录来存储你的用户身份。

本指南涵盖了软件事务性内存（STM）的使用。

This guide explains how to use Stork with Kubernetes for service discovery and load balancing.

本指南解释了如何使用Vault凭证提供者或实现你自己的自定义凭证。

This page explains how to use gRPC CLI.

本指南包括如何在Quarkus中使用Apache Cassandra NoSQL数据库。

This guide covers how to use Infinispan with Quarkus.

This guide explains how to use the REST Client.

This guide explains how to use the RESTEasy Classic REST Client in order to interact with REST APIs (JSON and other) with very little effort.

This guide explains how to use the RESTEasy Classic REST Client to send multipart REST requests, typically to upload documents.

This page explains how to enable xDS gRPC usage in your Quarkus application.

Learn more about how to use the web dependency locator

Discover how to develop highly scalable reactive REST services with Jakarta REST and Quarkus REST.

一切gRPC的总入口。

Quarkus以spring-cloud-config-client扩展的形式为Spring Cloud Config提供了一个兼容层。

This guide explains how your application can use SmallRye JWT to provide secured access to the Jakarta REST endpoints.

Quarkus provides support for properties file-based authentication intended for development and testing purposes.

本指南展示了你的Quarkus应用如何利用Apache Kafka Streams API来实现基于Apache Kafka的流处理应用。

使用Apache Kafka，Avro序列化记录，并连接到一个模式注册中心。

本指南解释了如何使用Blaze-Persistence来简化你的数据和DTO层。

本指南包括如何使用Flyway扩展来管理你的模式迁移。

Hibernate Reactive is a reactive API for Hibernate ORM, supporting non-blocking database drivers and a reactive style of interaction with the database.

本指南展示了你的Quarkus应用程序如何使用数据库来存储你的用户身份。

本指南演示了你的Quarkus应用程序如何使用AMQP 1.0的Apache Qpid JMS，或使用Apache ActiveMQ Artemis JMS进行JMS信息传递。

本指南解释了如何使用Kotlin。

本指南包括如何在Quarkus中使用MongoDB。

This guide explains how your Quarkus application can utilize OAuth2 tokens to provide secured access to the Jakarta REST endpoints.

本指南解释了如何使用OpenAPI扩展来生成OpenAPI描述符，并获得一个Swagger UI前端来测试你的REST端点。

Hibernate ORM is the de facto Jakarta Persistence implementation and offers you the full breadth of an Object Relational Mapper.

基于Hibernate 响应式的简化响应式ORM层。

本指南涵盖了MongoDB使用活动记录和存储库的用法。

本指南包括如何在Quarkus中使用Redis数据存储。

使用Spring Boot的 @ConfigurationProperties ，代替MicroProfile配置注解

本指南演示了你的Quarkus应用程序如何使用WebAuthn认证来代替密码。

This guide explains how your Quarkus application can utilize web sockets to create interactive web applications.

本指南解释了不同的Bean如何使用事件总线进行交互。

本指南演示了如何使用响应式路由。

本指南涵盖了如何在Quarkus中使用响应式SQL客户端。

本指南解释了如何在Quarkus中使用Vert.x来构建响应式应用程序。

In this guide, we will discuss how you can get your native images to support SSL, as native images don’t support it out of the box.

This document describes how to test Quarkus Security.

Modern applications often need to run specific tasks periodically.

了解更多关于Quarkus 世界中我们称之为平台的东西。

You often need to execute custom actions when the application starts and clean up everything when the application stops.

开发模式与生产应用程序有何不同

本指南解释了如何在你的Quarkus应用程序中开始使用gRPC。

列出每个扩展的所有配置属性

扩展和定制配置。

通过持续测试获得早期测试反馈。

基于特定条件触发包含附加扩展。

探索你可以在你的扩展中消费/提供的所有BuildItems。

This guide covers testing in JVM mode, native mode, and injection of resources into tests

本指南解释了如何测量你的Quarkus应用程序的测试覆盖率。

本指南包括如何在REST服务中使用Hibernate验证器/Bean验证。

This explains the specifics of using Hibernate ORM with Panache in a Kotlin project.

本指南涵盖了在Kotlin项目中使用活动记录和存储库的MongoDB的用法。

JSON is now the lingua franca between microservices.

本指南收集了一些提示，帮助你解决将应用程序编译为原生可执行文件时遇到的问题。

Quarkus extensions optimize your applications by pushing as much work as possible to the build operation.

本指南解释了如何最好地测量Quarkus应用程序的占用空间。

在Heroku上部署你的Quarkus应用程序。

Deploy a Quarkus application to the Microsoft Azure cloud platform.

Hardcoded values in your code is a no go (even if we all did it at some point ;-)).

使用易变的jars来重建具有不同构建时间配置的应用程序。