# Privacy Proxy

A MASQUE-based forward proxy that protects user privacy while preserving geolocation accuracy

> Links below point directly to Markdown versions of each page. Any page can also be retrieved as Markdown by sending an `Accept: text/markdown` header to the page's URL without the `index.md` suffix (for example, `curl -H "Accept: text/markdown" https://docs.ahq.lat/privacy-proxy/`).
>
> For other Cloudflare products, see the [Cloudflare documentation directory](https://docs.ahq.lat/llms.txt).

## Overview

- [Privacy Proxy](https://docs.ahq.lat/privacy-proxy/index.md): Privacy Proxy is a MASQUE-based forward proxy that hides client IP addresses while preserving geolocation accuracy.

## Get started

- [Get started](https://docs.ahq.lat/privacy-proxy/get-started/index.md): Connect to Privacy Proxy, configure your client, and verify that traffic is proxied correctly.

## concepts

- [Authentication](https://docs.ahq.lat/privacy-proxy/concepts/authentication/index.md): Privacy Proxy authentication methods, including pre-shared keys, Privacy Pass tokens, and mutual TLS.
- [Deployment models](https://docs.ahq.lat/privacy-proxy/concepts/deployment-models/index.md): Compare Privacy Proxy single-hop and double-hop deployment architectures for different privacy and operational requirements.
- [Geolocation](https://docs.ahq.lat/privacy-proxy/concepts/geolocation/index.md): Privacy Proxy preserves user geolocation using geohashes to select egress IPs that match the client's geographic region.
- [How Privacy Proxy works](https://docs.ahq.lat/privacy-proxy/concepts/how-it-works/index.md): Learn how Privacy Proxy uses MASQUE protocols to create encrypted tunnels that separate user identity from user activity.

## reference

- [Client libraries](https://docs.ahq.lat/privacy-proxy/reference/client-libraries/index.md): Open source libraries and tools for connecting to Privacy Proxy, including tokio-quiche, Chaussette, and privacypass-ts.
- [HTTP headers](https://docs.ahq.lat/privacy-proxy/reference/http-headers/index.md): HTTP headers used by Privacy Proxy for authentication, geolocation, and observability, including request and response formats.
- [Observability](https://docs.ahq.lat/privacy-proxy/reference/metrics/index.md): Monitor Privacy Proxy deployments using the GraphQL Analytics API or OpenTelemetry telemetry export.
- [GraphQL Analytics API](https://docs.ahq.lat/privacy-proxy/reference/metrics/graphql/index.md): Query Privacy Proxy request, connection, and authentication metrics using the Cloudflare GraphQL Analytics API.
- [OpenTelemetry](https://docs.ahq.lat/privacy-proxy/reference/metrics/opentelemetry/index.md): Export Privacy Proxy metrics and traces to your observability platform using the OpenTelemetry Protocol (OTLP).
- [Proxy status reference](https://docs.ahq.lat/privacy-proxy/reference/proxy-status/index.md): All possible proxyStatus values for Privacy Proxy error classification in GraphQL Analytics and OpenTelemetry metrics.