> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/pt/agente-realmjoin/realmjoin-client/branchcache.md).

# BranchCache

Como o Agente RealmJoin distribui o conteúdo dos pacotes com BranchCache: componentes CDN e do cliente, obtenção entre pares, verificação de hash, pré-carregamento, configuração e Delivery Optimization.

O agente RealmJoin baixa o conteúdo do pacote através do BranchCache. Os dispositivos na mesma rede recuperam conteúdo uns dos outros e só obtêm do CDN do RealmJoin o que nenhum par possui. Para uma implantação em um site, o conteúdo cruza o link WAN aproximadamente uma vez, em vez de uma vez por dispositivo.

{% hint style="info" %}
O BranchCache está ativado por padrão no CDN do RealmJoin e em novas instalações do Agente RealmJoin (`BranchCache.Mode = "Distributed"`).
{% endhint %}

## Componentes

* **CDN.** O CDN do RealmJoin (`cdn.realmjoin.com`) fornece o conteúdo do pacote pronto para BranchCache: com cada arquivo, ele fornece as informações de conteúdo (hashes de segmentos) que os clientes usam para localizar o conteúdo nos pares e para verificá-lo.
* **Biblioteca cliente.** O agente traz a biblioteca cliente BranchCache correspondente e a integra à sua pilha HTTP como um manipulador de mensagens. Todos os downloads de pacotes do agente passam por ela: Chocolatey (`winchoco`) pacotes, pacotes craft e os downloads que um script de pacote faz durante a instalação (`Get-ChocolateyWebFile`), com o mecanismo clássico do Chocolatey e o [Native Choco Runtime](https://docs.realmjoin.com/pt/agente-realmjoin/realmjoin-client/native-choco-runtime.md).
* **serviço Windows BranchCache.** O armazenamento em cache e a troca entre pares são feitos pelo serviço Windows BranchCache (`PeerDistSvc`) em **modo de cache distribuído**.

## Fluxo de download

1. O agente solicita um arquivo ao CDN e recebe suas informações de conteúdo em vez do conteúdo completo.
2. O dispositivo procura os segmentos em sua sub-rede: ele envia uma consulta multicast WS-Discovery, e os pares que possuem os segmentos respondem diretamente.
3. Os segmentos são recuperados dos pares. Se vários pares possuírem o conteúdo, a carga é distribuída entre eles. Os segmentos que nenhum par possui são baixados do CDN.
4. Cada segmento é verificado em relação aos hashes das informações de conteúdo, independentemente de ter vindo de um par ou do CDN.
5. O dispositivo adiciona o conteúdo ao seu cache local e passa a servi-lo aos outros pares a partir de então.

Para cada transferência, o agente registra quantos bytes vieram do cache (cache local e pares) e quantos vieram da origem, e relata essas estatísticas ao CDN do RealmJoin (`cdn.realmjoin.com`).

Para detalhes do protocolo, consulte o Microsoft Learn: [BranchCache](https://learn.microsoft.com/en-us/windows-server/networking/branchcache/branchcache).

## Pré-busca

Antes de instalar os pacotes Chocolatey pendentes, o agente baixa seu conteúdo em segundo plano (pré-busca) para `%WINDIR%\\Temp\\chocolatey\\<package-id>\\<version>\\`. Este é o caminho de cache que o `Get-ChocolateyWebFile` usa, então a instalação aproveita os arquivos pré-buscados em vez de baixá-los novamente. Antes de um arquivo pré-buscado ser usado, ele é verificado em relação ao checksum no script do pacote; em caso de divergência, o arquivo é baixado novamente.

A pré-busca é sensível à arquitetura. Muitos pacotes contêm instaladores separados para x64, ARM64 e x86, dos quais apenas um é usado em um determinado dispositivo. O agente corresponde tokens de arquitetura nos nomes de arquivo (por exemplo `x64`, `amd64`, `arm64`, `x86`, `win32`) e faz a pré-busca de:

* um único arquivo, se o pacote contiver apenas um,
* os arquivos que correspondem à arquitetura do dispositivo, além dos arquivos sem um token de arquitetura, se pelo menos um nome de arquivo tiver um token,
* nada, se o pacote contiver vários arquivos e nenhum deles tiver um token. O conteúdo é então baixado no momento da instalação.

A pré-busca é ignorada em conexões tarifadas.

Em uma implantação em um site, o primeiro dispositivo a fazer a pré-busca de um pacote o baixa do CDN; os outros dispositivos o recuperam desse dispositivo ou de outros pares que já o possuem.

## BranchCache e Otimização de Entrega

A Otimização de Entrega (DO) é a tecnologia ponto a ponto do Windows para conteúdo da Microsoft. Ela só funciona com endpoints controlados pela Microsoft e não pode ser usada com fontes de terceiros, como o CDN do RealmJoin.

<table><thead><tr><th width="220"></th><th>Otimização de Entrega</th><th>BranchCache</th></tr></thead><tbody><tr><td>Conteúdo</td><td>Windows Update, Microsoft Store, Aplicativos Microsoft 365, apps do Intune</td><td>Pacotes RealmJoin do CDN do RealmJoin</td></tr><tr><td>Configurado por</td><td>Intune ou política de grupo; o Agente RealmJoin define o ID de grupo</td><td>O Agente RealmJoin (<code>BranchCache.Mode</code>)</td></tr></tbody></table>

O agente define o ID de grupo de Otimização de Entrega de cada dispositivo para um ID derivado do gateway padrão do dispositivo. Os dispositivos atrás do mesmo gateway, portanto, acabam no mesmo grupo DO e compartilham conteúdo da Microsoft entre si. Se nenhum gateway padrão for encontrado, o agente usa um ID aleatório.

## Requisitos

* **Dispositivos.** Windows 10 e Windows 11 com o Agente RealmJoin. O agente não usa BranchCache no Windows 365 Cloud PCs.
* **Tráfego entre pares.** Os dispositivos devem conseguir se alcançar diretamente. Não os separe em VLANs ou sub-redes diferentes e não bloqueie o tráfego entre pares com isolamento de cliente ou dispositivo. A Microsoft lista as portas e regras de firewall para o modo de cache distribuído no Microsoft Learn: [Configurar regras de firewall para permitir o tráfego do BranchCache](https://learn.microsoft.com/en-us/windows-server/networking/branchcache/deploy/configure-firewall-rules-for-non-domain-members-to-allow-branchcache-traffic).
* **Apenas modo de cache distribuído.** O Hosted Cache Mode (um Windows Server dedicado configurado por meio da política "Configure Hosted Cache Servers") não é suportado.

Os endpoints, orientações sobre proxy e os outros requisitos de rede estão listados em [Considerações de infraestrutura](https://docs.realmjoin.com/pt/implementacao/infrastructure.md#branchcache-and-device-isolation).

## Configuração

O BranchCache é controlado pela `BranchCache.Mode` política, atribuída por usuário ou grupo. Consulte [Configurar BranchCache para pacotes RJ](https://docs.realmjoin.com/pt/ugd-management/user-and-group-settings/additional-settings.md#configure-branchcache-for-rj-packages).

<table><thead><tr><th width="160">Valor</th><th>Comportamento</th></tr></thead><tbody><tr><td><code>"Distributed"</code></td><td>Padrão. Antes de instalar um pacote, o agente verifica se o BranchCache está disponível no dispositivo. Se não estiver, o agente executa <code>Enable-BCDistributed -Force</code>.</td></tr><tr><td><code>"Undefined"</code></td><td>O agente não habilita BranchCache.</td></tr></tbody></table>

{% hint style="warning" %}
A configuração se aplica apenas a **novo** clientes. `"Undefined"` não desativa o BranchCache em dispositivos em que ele já está ativo, e o agente continua usando-o ali. Para desativá-lo, execute `Disable-BC` em um PowerShell elevado nesses dispositivos.
{% endhint %}

Mediante solicitação, o RealmJoin pode desativar o BranchCache para o seu tenant do lado do CDN. A configuração do lado do cliente então não tem efeito.

## Verificando o BranchCache em um dispositivo

### No Portal RealmJoin

O [detalhes do dispositivo](https://docs.realmjoin.com/pt/ugd-management/user-list/device-details.md#branchcache) mostram os dados de BranchCache que o agente relata para um dispositivo. O **Economia de BranchCache** campo na visão geral mostra os bytes recuperados do cache local e dos pares em vez da WAN; para dispositivos que não estão no modo distribuído, ele mostra o modo em vez disso. A **BranchCache** seção lista o modo, o tamanho do cache local, a taxa de acerto do cache, os bytes recuperados do cache e do servidor, o total de bytes recuperados, os bytes servidos aos pares e o número de segmentos completos e parciais. Os valores são contadores de desempenho acumulados do Windows BranchCache.

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-fc8f4785ba6e9b4443b2253d3be87e60fc1704c4%2Fbranchcache-device-details.png?alt=media" alt="BranchCache Savings field and BranchCache section in the device details"><figcaption><p>Dados de BranchCache de um dispositivo em modo de cache distribuído</p></figcaption></figure>

### No dispositivo

`Get-BCStatus` em um PowerShell elevado mostra o modo atual do cliente e o tamanho do cache local. Os [arquivos de log](https://docs.realmjoin.com/pt/resolucao-de-problemas-e-faq/troubleshooting/package-installation-issues/logfiles-structure.md) contêm as decisões de pré-busca (linhas que começam com `Prefetch`) e os contadores de desempenho do BranchCache após cada instalação de pacote.

Para erros de BranchCache durante downloads de pacotes (por exemplo `Não há espaço suficiente em disco` ou uma divergência de hash), consulte [Correções para problemas comuns](https://docs.realmjoin.com/pt/resolucao-de-problemas-e-faq/troubleshooting/package-installation-issues/fixes-for-common-issues.md#branchcache-issues).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/pt/agente-realmjoin/realmjoin-client/branchcache.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
