# Encaminhar portas no seu código

Você pode encaminhar portas no seu código para testar e depurar seu aplicativo. Você também pode gerenciar o protocolo de porta e compartilhar a porta em sua organização ou de modo público.

## Sobre as portas encaminhadas

O redirecionamento de porta dá acesso a portas TCP que estão em execução no seu codespace. Por exemplo, se você estiver executando um aplicativo web em uma determinada porta no seu codespace, você pode encaminhar essa porta. Isso permite que você acesse o aplicativo do navegador na sua máquina local para testes e depuração.

<div class="ghd-tool webui">

Quando um aplicativo em execução em um codespace imprime a saída para o terminal que contém uma URL do localhost, como `http://localhost:PORT` ou `http://127.0.0.1:PORT`, a porta é encaminhada automaticamente. Se você estiver usando os GitHub Codespaces no navegador ou no Visual Studio Code, a cadeia de caracteres da URL no terminal será convertida em um link que acessa a página da Web no computador local. Por padrão, GitHub Codespaces encaminha portas usando HTTP.

Você pode editar a configuração do contêiner de desenvolvimento do repositório para encaminhar automaticamente uma ou mais portas. Você também pode encaminhar uma porta manualmente, etiquetar portas encaminhadas, compartilhar portas encaminhadas com integrantes da sua organização, compartilhar as portas encaminhadas publicamente e adicione as portas encaminhadas à configuração do codespace.

> \[!NOTE]
> Os proprietários da organização podem restringir a capacidade de disponibilizar portas de encaminhamento publicamente ou na organização. Para saber mais, confira [Como restringir a visibilidade das portas encaminhadas](/pt/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports).

## Encaminhar uma porta

Você pode encaminhar manualmente uma porta que não foi encaminhada automaticamente.

1. Abra o terminal no seu codespace.

2. Clique na guia **PORTAS**.

3. Na lista de portas, clique em **Adicionar porta**.

   ![Captura de tela do botão "Adicionar porta" para um espaço de código.](/assets/images/help/codespaces/add-port-button.png)

4. Digite o número ou o endereço da porta e pressione Enter.

   ![Captura de tela do número 3000 sendo inserido no campo Número da porta de uma nova porta encaminhada.](/assets/images/help/codespaces/port-number-text-box.png)

## Usando encaminhamento de HTTPS

Por padrão, GitHub Codespaces encaminha portas usando HTTP, mas é possível atualizar qualquer porta para usar HTTPS, conforme necessário. Se uma porta com visibilidade pública for atualizada para usar HTTPS, a visibilidade dela mudará automaticamente para privada.

1. Abra o terminal no seu codespace.

2. Clique na guia **PORTAS**.

3. Clique com o botão direito do mouse na porta que deseja atualizar e passe o cursor sobre **Alterar Protocolo de Porta**.

   ![Captura de tela do menu pop-up de uma porta encaminhada, com a opção "Alterar Protocolo da Porta" selecionada e "HTTPS" selecionado no submenu.](/assets/images/help/codespaces/update-port-protocol.png)

4. Selecione o protocolo necessário para esta porta. O protocolo que você selecionar será lembrado por esta porta durante o ciclo de vida do codespace.

## Compartilhar uma porta

> \[!NOTE]
> Você só poderá tornar uma porta privada para uma organização se a sua organização usar o GitHub Team ou o GitHub Enterprise Cloud.

Se você quiser compartilhar uma porta encaminhada com outras pessoas, você pode tornar a porta privada da sua organização ou tornar a porta pública. Após tornar uma porta privada para a sua organização, qualquer pessoa na organização com a URL da porta poderá ver o aplicativo em execução. Após você tornar uma porta pública, qualquer pessoa que conheça a URL e o número da porta poderá ver o aplicativo em execução sem precisar efetuar a autenticação.

> \[!NOTE]
> Sua escolha de opções de visibilidade de porta pode ser limitada por uma política configurada para sua organização. Para saber mais, confira [Como restringir a visibilidade das portas encaminhadas](/pt/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports).

1. Abra o terminal no seu codespace.

2. Clique na guia **PORTAS**.

3. Clique com o botão direito do mouse na porta que deseja compartilhar, selecione **Visibilidade da Porta** e clique em **Privado para a Organização** ou **Público**.

   ![Captura de tela do menu pop-up de uma porta encaminhada, com a opção "Visibilidade da Porta" selecionada e "Particular" selecionado no submenu.](/assets/images/help/codespaces/make-public-option.png)

4. À direita do endereço local para a porta, clique no ícone copiar.

   ![Captura de tela do painel "Portas". O ícone de cópia, que copia a URL de uma porta encaminhada, é destacado com um contorno laranja.](/assets/images/help/codespaces/copy-icon-port-url.png)

5. Envie a URL copiada para a pessoa com quem você deseja compartilhar a porta.

## Como usar ferramentas de linha de comando e clientes REST para acessar portas

Quando você encaminha uma porta, seu aplicativo fica disponível no URL `https://CODESPACENAME-PORT.app.github.dev`. Por exemplo, `https://monalisa-hot-potato-vrpqrxxrx7x2rxx-4000.app.github.dev`. Se você encaminhar uma porta privada do aplicativo da área de trabalho VS Code, seu aplicativo também ficará disponível em uma porta localhost, como `127.0.0.1:4000`.

Para acessar seu aplicativo usando um cliente REST, como o Postman, ou uma ferramenta de linha de comando como curl, você não precisará se autenticar se estiver usando uma porta localhost ou se estiver acessando uma porta pública no domínio remoto. No entanto, para se conectar a uma porta privada no domínio remoto, você precisa se autenticar com o token de acesso `GITHUB_TOKEN` na sua solicitação.

> \[!NOTE]
> O `GITHUB_TOKEN` é criado automaticamente quando você inicia um codespace e permanece igual durante a sessão do codespace. Se você interromper e reiniciar um codespace, um novo `GITHUB_TOKEN` será gerado.

<!-- Don't delete this comment. It prevents a formatting issue. -->

### Como localizar o endereço ao qual se conectar

1. Abra o terminal no seu codespace.

2. Clique na guia **PORTAS**. Ela lista todas as portas que você encaminhou.

3. Clique com o botão direito do mouse na porta à qual você deseja se conectar e clique em **Copiar Endereço Local**.

   ![Captura de tela do menu pop-up de uma porta encaminhada com a opção "Copiar Endereço Local" realçada com um contorno laranja.](/assets/images/help/codespaces/copy-local-address.png)

4. Cole o endereço copiado em algum lugar para uso posterior.

### Como localizar o GITHUB\_TOKEN

1. No terminal do seu codespace, insira `echo $GITHUB_TOKEN`.

   O token é uma cadeia de caracteres que começa com `ghu_`.

2. Copie a o token.

   > \[!IMPORTANT]
   > Não compartilhe esse token de acesso com ninguém.

### Como usar o curl para acessar uma porta encaminhada

Em um terminal no computador local, insira:

```shell
curl ADDRESS -H "X-Github-Token: TOKEN"
```

Substitua `ADDRESS` e `TOKEN` pelos valores que você copiou anteriormente.

### Como usar o Postman para acessar uma porta encaminhada

1. Abra o Postman.

2. Crie uma solicitação GET.

3. Cole o endereço copiado anteriormente como a URL da solicitação.

   ![Captura de tela da URL da porta encaminhada, colada no Postman como a URL de solicitação GET. O URL é destacado.](/assets/images/help/codespaces/postman-screenshot-url.png)

4. Na guia **Cabeçalhos**, crie uma entrada em que a chave é "X-Github-Token" e o valor é `GITHUB_TOKEN` que você copiou anteriormente.

   ![Captura de tela de um GITHUB\_TOKEN fictício, colado no Postman como o valor da chave X-GitHub-Token. A chave e o valor estão realçados.](/assets/images/help/codespaces/postman-screenshot-key-token.png)

5. Clique em **Enviar**.

## Encaminhando uma porta automaticamente

É possível adicionar uma porta encaminhada à configuração dos GitHub Codespaces do repositório para que a porta seja encaminhada automaticamente a todos os codespaces criados do repositório. Depois de atualizar a configuração, todos os codespaces criados anteriormente deverão ser reconstruídos para que a alteração seja aplicada. Para saber mais sobre o arquivo de configuração do contêiner de desenvolvimento, confira [Introdução aos contêineres de desenvolvimento](/pt/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers#applying-configuration-changes-to-a-codespace).

1. No codespace, abra o arquivo de configuração do contêiner de desenvolvimento que você deseja atualizar. Normalmente, esse arquivo é `.devcontainer/devcontainer.json`.

2. Adicione a propriedade `forwardPorts`.

   ```json
   "forwardPorts": [NUMBER],
   ```

   Substitua `NUMBER` pelo número da porta que você deseja encaminhar. Esta pode ser uma lista separada por vírgulas de números de portas.

3. Salve o arquivo.

## Etiquetar uma porta

Ao abrir um codespace no navegador ou no aplicativo da área de trabalho VS Code, você pode rotular uma porta encaminhada para facilitar a identificação em uma lista.

1. Abra o terminal no seu codespace.

2. Clique na guia **PORTAS**.

3. Clique com o botão direito do mouse na porta que deseja rotular e clique em **Definir Rótulo da Porta**.

   ![Captura de tela do menu pop-up de uma porta encaminhada, com a opção "Definir Rótulo da Porta" realçada com um contorno laranja.](/assets/images/help/codespaces/set-port-label.png)

4. Digite um rótulo para sua porta e pressione Enter.

   ![Captura de tela do rótulo "Preparo" adicionado como rótulo personalizado a uma porta encaminhada.](/assets/images/help/codespaces/label-text-box.png)

### Como rotular uma porta encaminhada automaticamente

Você pode rotular uma porta e gravar a alteração em um arquivo de configuração do contêiner de desenvolvimento do repositório. Se você fizer isso para uma porta que é encaminhada automaticamente, usando a propriedade `forwardPorts`, o rótulo será aplicado automaticamente a essa porta encaminhada para todos os codespaces futuros criados com base no repositório que usam esse arquivo de configuração.

1. Abra o terminal no seu codespace.

2. Clique na guia **PORTAS**.

3. Clique com o botão direito do mouse na porta cujo atributo de rótulo deseja adicionar à configuração do codespace e clique em **Definir Rótulo e Atualizar devcontainer.json**.

   ![Captura de tela do menu pop-up de uma porta encaminhada, com a opção "Definir Rótulo e Atualizar devcontainer.json" realçada com um contorno laranja.](/assets/images/help/codespaces/update-devcontainer-to-add-port-option.png)

4. Digite um rótulo para sua porta e pressione Enter.

   ![Captura de tela do rótulo "Preparo" adicionado como rótulo personalizado a uma porta encaminhada.](/assets/images/help/codespaces/label-text-box.png)

5. Se o repositório tiver mais de um arquivo de configuração do contêiner de desenvolvimento, você será solicitado a escolher qual arquivo deseja atualizar.

   O arquivo de configuração do contêiner de desenvolvimento é atualizado para incluir o novo rótulo na `portsAttributes` propriedade. Por exemplo:

   ```jsonc
   // Use 'forwardPorts' to make a list of ports inside the container available locally.
   "forwardPorts": [3333, 4444],

   "portsAttributes": {
     "3333": {
       "label": "app-standard-preview"
     },
     "4444": {
       "label": "app-pro-preview"
     }
   }
   ```

</div>

<div class="ghd-tool vscode">

Quando um aplicativo em execução em um codespace imprime a saída para o terminal que contém uma URL do localhost, como `http://localhost:PORT` ou `http://127.0.0.1:PORT`, a porta é encaminhada automaticamente. Se você estiver usando os GitHub Codespaces no navegador ou no Visual Studio Code, a cadeia de caracteres da URL no terminal será convertida em um link que acessa a página da Web no computador local. Por padrão, GitHub Codespaces encaminha portas usando HTTP.

Você pode editar a configuração do contêiner de desenvolvimento do repositório para encaminhar automaticamente uma ou mais portas. Você também pode encaminhar uma porta manualmente, etiquetar portas encaminhadas, compartilhar portas encaminhadas com integrantes da sua organização, compartilhar as portas encaminhadas publicamente e adicione as portas encaminhadas à configuração do codespace.

> \[!NOTE]
> Os proprietários da organização podem restringir a capacidade de disponibilizar portas de encaminhamento publicamente ou na organização. Para saber mais, confira [Como restringir a visibilidade das portas encaminhadas](/pt/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports).

## Encaminhar uma porta

Você pode encaminhar manualmente uma porta que não foi encaminhada automaticamente.

1. Abra o terminal no seu codespace.

2. Clique na guia **PORTAS**.

3. Na lista de portas, clique em **Adicionar porta**.

   ![Captura de tela do botão "Adicionar porta" para um espaço de código.](/assets/images/help/codespaces/add-port-button.png)

4. Digite o número ou o endereço da porta e pressione Enter.

   ![Captura de tela do número 3000 sendo inserido no campo Número da porta de uma nova porta encaminhada.](/assets/images/help/codespaces/port-number-text-box.png)

## Compartilhar uma porta

> \[!NOTE]
> Você só poderá tornar uma porta privada para uma organização se a sua organização usar o GitHub Team ou o GitHub Enterprise Cloud.

Se você quiser compartilhar uma porta encaminhada com outras pessoas, você pode tornar a porta privada da sua organização ou tornar a porta pública. Após tornar uma porta privada para a sua organização, qualquer pessoa na organização com a URL da porta poderá ver o aplicativo em execução. Após você tornar uma porta pública, qualquer pessoa que conheça a URL e o número da porta poderá ver o aplicativo em execução sem precisar efetuar a autenticação.

> \[!NOTE]
> Sua escolha de opções de visibilidade de porta pode ser limitada por uma política configurada para sua organização. Para saber mais, confira [Como restringir a visibilidade das portas encaminhadas](/pt/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports).

1. Abra o terminal no seu codespace.

2. Clique na guia **PORTAS**.

3. Clique com o botão direito do mouse na porta que deseja compartilhar, selecione **Visibilidade da Porta** e clique em **Privado para a Organização** ou **Público**.

   ![Captura de tela do menu pop-up de uma porta encaminhada, com a opção "Visibilidade da Porta" selecionada e "Particular" selecionado no submenu.](/assets/images/help/codespaces/make-public-option.png)

4. À direita do endereço local para a porta, clique no ícone copiar.

   ![Captura de tela do painel "Portas". O ícone de cópia, que copia a URL de uma porta encaminhada, é destacado com um contorno laranja.](/assets/images/help/codespaces/copy-icon-port-url.png)

5. Envie a URL copiada para a pessoa com quem você deseja compartilhar a porta.

## Como usar ferramentas de linha de comando e clientes REST para acessar portas

Quando você encaminha uma porta, seu aplicativo fica disponível no URL `https://CODESPACENAME-PORT.app.github.dev`. Por exemplo, `https://monalisa-hot-potato-vrpqrxxrx7x2rxx-4000.app.github.dev`. Se você encaminhar uma porta privada do aplicativo da área de trabalho VS Code, seu aplicativo também ficará disponível em uma porta localhost, como `127.0.0.1:4000`.

Para acessar seu aplicativo usando um cliente REST, como o Postman, ou uma ferramenta de linha de comando como curl, você não precisará se autenticar se estiver usando uma porta localhost ou se estiver acessando uma porta pública no domínio remoto. No entanto, para se conectar a uma porta privada no domínio remoto, você precisa se autenticar com o token de acesso `GITHUB_TOKEN` na sua solicitação.

> \[!NOTE]
> O `GITHUB_TOKEN` é criado automaticamente quando você inicia um codespace e permanece igual durante a sessão do codespace. Se você interromper e reiniciar um codespace, um novo `GITHUB_TOKEN` será gerado.

<!-- Don't delete this comment. It prevents a formatting issue. -->

### Como localizar o endereço ao qual se conectar

1. Abra o terminal no seu codespace.

2. Clique na guia **PORTAS**. Ela lista todas as portas que você encaminhou.

3. Clique com o botão direito do mouse na porta à qual você deseja se conectar e clique em **Copiar Endereço Local**.

   ![Captura de tela do menu pop-up de uma porta encaminhada com a opção "Copiar Endereço Local" realçada com um contorno laranja.](/assets/images/help/codespaces/copy-local-address.png)

4. Cole o endereço copiado em algum lugar para uso posterior.

### Como localizar o GITHUB\_TOKEN

1. No terminal do seu codespace, insira `echo $GITHUB_TOKEN`.

   O token é uma cadeia de caracteres que começa com `ghu_`.

2. Copie a o token.

   > \[!IMPORTANT]
   > Não compartilhe esse token de acesso com ninguém.

### Como usar o curl para acessar uma porta encaminhada

Em um terminal no computador local, insira:

```shell
curl ADDRESS -H "X-Github-Token: TOKEN"
```

Substitua `ADDRESS` e `TOKEN` pelos valores que você copiou anteriormente.

### Como usar o Postman para acessar uma porta encaminhada

1. Abra o Postman.

2. Crie uma solicitação GET.

3. Cole o endereço copiado anteriormente como a URL da solicitação.

   ![Captura de tela da URL da porta encaminhada, colada no Postman como a URL de solicitação GET. O URL é destacado.](/assets/images/help/codespaces/postman-screenshot-url.png)

4. Na guia **Cabeçalhos**, crie uma entrada em que a chave é "X-Github-Token" e o valor é `GITHUB_TOKEN` que você copiou anteriormente.

   ![Captura de tela de um GITHUB\_TOKEN fictício, colado no Postman como o valor da chave X-GitHub-Token. A chave e o valor estão realçados.](/assets/images/help/codespaces/postman-screenshot-key-token.png)

5. Clique em **Enviar**.

## Encaminhando uma porta automaticamente

É possível adicionar uma porta encaminhada à configuração dos GitHub Codespaces do repositório para que a porta seja encaminhada automaticamente a todos os codespaces criados do repositório. Depois de atualizar a configuração, todos os codespaces criados anteriormente deverão ser reconstruídos para que a alteração seja aplicada. Para saber mais sobre o arquivo de configuração do contêiner de desenvolvimento, confira [Introdução aos contêineres de desenvolvimento](/pt/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers#applying-configuration-changes-to-a-codespace).

1. No codespace, abra o arquivo de configuração do contêiner de desenvolvimento que você deseja atualizar. Normalmente, esse arquivo é `.devcontainer/devcontainer.json`.

2. Adicione a propriedade `forwardPorts`.

   ```json
   "forwardPorts": [NUMBER],
   ```

   Substitua `NUMBER` pelo número da porta que você deseja encaminhar. Esta pode ser uma lista separada por vírgulas de números de portas.

3. Salve o arquivo.

## Etiquetar uma porta

Ao abrir um codespace no navegador ou no aplicativo da área de trabalho VS Code, você pode rotular uma porta encaminhada para facilitar a identificação em uma lista.

1. Abra o terminal no seu codespace.

2. Clique na guia **PORTAS**.

3. Clique com o botão direito do mouse na porta que deseja rotular e clique em **Definir Rótulo da Porta**.

   ![Captura de tela do menu pop-up de uma porta encaminhada, com a opção "Definir Rótulo da Porta" realçada com um contorno laranja.](/assets/images/help/codespaces/set-port-label.png)

4. Digite um rótulo para sua porta e pressione Enter.

   ![Captura de tela do rótulo "Preparo" adicionado como rótulo personalizado a uma porta encaminhada.](/assets/images/help/codespaces/label-text-box.png)

### Como rotular uma porta encaminhada automaticamente

Você pode rotular uma porta e gravar a alteração em um arquivo de configuração do contêiner de desenvolvimento do repositório. Se você fizer isso para uma porta que é encaminhada automaticamente, usando a propriedade `forwardPorts`, o rótulo será aplicado automaticamente a essa porta encaminhada para todos os codespaces futuros criados com base no repositório que usam esse arquivo de configuração.

1. Abra o terminal no seu codespace.

2. Clique na guia **PORTAS**.

3. Clique com o botão direito do mouse na porta cujo atributo de rótulo deseja adicionar à configuração do codespace e clique em **Definir Rótulo e Atualizar devcontainer.json**.

   ![Captura de tela do menu pop-up de uma porta encaminhada, com a opção "Definir Rótulo e Atualizar devcontainer.json" realçada com um contorno laranja.](/assets/images/help/codespaces/update-devcontainer-to-add-port-option.png)

4. Digite um rótulo para sua porta e pressione Enter.

   ![Captura de tela do rótulo "Preparo" adicionado como rótulo personalizado a uma porta encaminhada.](/assets/images/help/codespaces/label-text-box.png)

5. Se o repositório tiver mais de um arquivo de configuração do contêiner de desenvolvimento, você será solicitado a escolher qual arquivo deseja atualizar.

   O arquivo de configuração do contêiner de desenvolvimento é atualizado para incluir o novo rótulo na `portsAttributes` propriedade. Por exemplo:

   ```jsonc
   // Use 'forwardPorts' to make a list of ports inside the container available locally.
   "forwardPorts": [3333, 4444],

   "portsAttributes": {
     "3333": {
       "label": "app-standard-preview"
     },
     "4444": {
       "label": "app-pro-preview"
     }
   }
   ```

</div>

<div class="ghd-tool cli">

> \[!NOTE]
> Para saber mais sobre GitHub CLI, confira [Sobre GitHub CLI](/pt/github-cli/github-cli/about-github-cli).

Para encaminhar uma porta, use o subcomando `gh codespace ports forward`. Substitua `codespace-port:local-port` pelas portas remotas e locais que deseja conectar. Depois de entrar no comando, escolha entre a lista de codespaces exibidos.

```shell
gh codespace ports forward CODESPACE-PORT:LOCAL-PORT
```

Para obter mais informações sobre esse comando, confira [o manual da GitHub CLI](https://cli.github.com/manual/gh_codespace_ports_forward).

Para ver os detalhes das portas encaminhadas, digite `gh codespace ports` e depois escolha um codespace.

## Compartilhar uma porta

> \[!NOTE]
> Você só poderá tornar uma porta privada para uma organização se a sua organização usar o GitHub Team ou o GitHub Enterprise Cloud.

Se você quiser compartilhar uma porta encaminhada com outras pessoas, você pode tornar a porta privada da sua organização ou tornar a porta pública. Após tornar uma porta privada para a sua organização, qualquer pessoa na organização com a URL da porta poderá ver o aplicativo em execução. Após você tornar uma porta pública, qualquer pessoa que conheça a URL e o número da porta poderá ver o aplicativo em execução sem precisar efetuar a autenticação.

> \[!NOTE]
> Sua escolha de opções de visibilidade de porta pode ser limitada por uma política configurada para sua organização. Para saber mais, confira [Como restringir a visibilidade das portas encaminhadas](/pt/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports).

Para alterar a visibilidade de uma porta encaminhada, use o subcomando `gh codespace ports visibility`. Há três configurações de visibilidade:

* `private` – Visível somente para você. Essa é a configuração padrão quando você encaminha uma porta.
* `org` – Visível para os membros da organização que é o proprietário do repositório.
* `public` – Visível para qualquer pessoa que conheça a URL e o número da porta.

Substitua `codespace-port` pelo número da porta encaminhada. Substitua por `setting``private`, `org`ou `public`. Depois de entrar no comando, escolha entre a lista de codespaces exibidos.

```shell
gh codespace ports visibility CODESPACE-PORT:SETTINGS
```

Você pode definir a visibilidade de várias portas com um comando. Por exemplo:

```shell
gh codespace ports visibility 80:private 3000:public 3306:org
```

Para obter mais informações sobre esse comando, confira [o manual da GitHub CLI](https://cli.github.com/manual/gh_codespace_ports_visibility).

## Como usar ferramentas de linha de comando e clientes REST para acessar portas

Quando você encaminha uma porta, seu aplicativo fica disponível no URL `https://CODESPACENAME-PORT.app.github.dev`. Por exemplo, `https://monalisa-hot-potato-vrpqrxxrx7x2rxx-4000.app.github.dev`. Se você encaminhar uma porta privada do aplicativo da área de trabalho VS Code, seu aplicativo também ficará disponível em uma porta localhost, como `127.0.0.1:4000`.

Para acessar seu aplicativo usando um cliente REST, como o Postman, ou uma ferramenta de linha de comando como curl, você não precisará se autenticar se estiver usando uma porta localhost ou se estiver acessando uma porta pública no domínio remoto. No entanto, para se conectar a uma porta privada no domínio remoto, você precisa se autenticar com o token de acesso `GITHUB_TOKEN` na sua solicitação.

> \[!NOTE]
> O `GITHUB_TOKEN` é criado automaticamente quando você inicia um codespace e permanece igual durante a sessão do codespace. Se você interromper e reiniciar um codespace, um novo `GITHUB_TOKEN` será gerado.

<!-- Don't delete this comment. It prevents a formatting issue. -->

### Como localizar o endereço ao qual se conectar

Para localizar o endereço de uma porta encaminhada, insira `gh codespace ports`. Se você tiver mais de um codespace, selecione o codespace apropriado na lista exibida.

Copie o endereço e cole-o em algum lugar para uso posterior.

### Como encontrar o GITHUB\_TOKEN

1. Inicie uma sessão SSH para seu codespace.

   ```shell
   gh codespace ssh
   ```

2. Se você tiver mais de um codespace, selecione o codespace apropriado na lista exibida.

3. Exiba o `GITHUB_TOKEN`.

   ```shell
   echo $GITHUB_TOKEN
   ```

   O token é uma cadeia de caracteres que começa com `ghu_`.

4. Copie a o token.

   > \[!IMPORTANT]
   > Não compartilhe esse token de acesso com ninguém.

5. Saia da sessão do SSH.

   ```shell
   exit
   ```

### Como usar o curl para acessar uma porta encaminhada

Em um terminal no computador local, insira:

```shell
curl ADDRESS -H "X-Github-Token: TOKEN"
```

Substitua `ADDRESS` e `TOKEN` pelos valores que você copiou anteriormente.

### Como usar o Postman para acessar uma porta encaminhada

1. Abra o Postman.

2. Crie uma solicitação GET.

3. Cole o endereço copiado anteriormente como a URL da solicitação.

   ![Captura de tela da URL da porta encaminhada, colada no Postman como a URL de solicitação GET. O URL é destacado.](/assets/images/help/codespaces/postman-screenshot-url.png)

4. Na guia **Cabeçalhos**, crie uma entrada em que a chave é "X-Github-Token" e o valor é `GITHUB_TOKEN` que você copiou anteriormente.

   ![Captura de tela de um GITHUB\_TOKEN fictício, colado no Postman como o valor da chave X-GitHub-Token. A chave e o valor estão realçados.](/assets/images/help/codespaces/postman-screenshot-key-token.png)

5. Clique em **Enviar**.

## Encaminhando uma porta automaticamente

É possível adicionar uma porta encaminhada à configuração dos GitHub Codespaces do repositório para que a porta seja encaminhada automaticamente a todos os codespaces criados do repositório. Depois de atualizar a configuração, todos os codespaces criados anteriormente deverão ser reconstruídos para que a alteração seja aplicada. Para saber mais sobre o arquivo de configuração do contêiner de desenvolvimento, confira [Introdução aos contêineres de desenvolvimento](/pt/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers#applying-configuration-changes-to-a-codespace).

1. No codespace, abra o arquivo de configuração do contêiner de desenvolvimento que você deseja atualizar. Normalmente, esse arquivo é `.devcontainer/devcontainer.json`.

2. Adicione a propriedade `forwardPorts`.

   ```json
   "forwardPorts": [NUMBER],
   ```

   Substitua `NUMBER` pelo número da porta que você deseja encaminhar. Esta pode ser uma lista separada por vírgulas de números de portas.

3. Salve o arquivo.

## Etiquetar uma porta

Ao abrir um codespace no navegador ou no aplicativo da área de trabalho VS Code, você pode rotular uma porta encaminhada para facilitar a identificação em uma lista.

1. Abra o terminal no seu codespace.

2. Clique na guia **PORTAS**.

3. Clique com o botão direito do mouse na porta que deseja rotular e clique em **Definir Rótulo da Porta**.

   ![Captura de tela do menu pop-up de uma porta encaminhada, com a opção "Definir Rótulo da Porta" realçada com um contorno laranja.](/assets/images/help/codespaces/set-port-label.png)

4. Digite um rótulo para sua porta e pressione Enter.

   ![Captura de tela do rótulo "Preparo" adicionado como rótulo personalizado a uma porta encaminhada.](/assets/images/help/codespaces/label-text-box.png)

### Como rotular uma porta encaminhada automaticamente

Você pode rotular uma porta e gravar a alteração em um arquivo de configuração do contêiner de desenvolvimento do repositório. Se você fizer isso para uma porta que é encaminhada automaticamente, usando a propriedade `forwardPorts`, o rótulo será aplicado automaticamente a essa porta encaminhada para todos os codespaces futuros criados com base no repositório que usam esse arquivo de configuração.

1. Abra o terminal no seu codespace.

2. Clique na guia **PORTAS**.

3. Clique com o botão direito do mouse na porta cujo atributo de rótulo deseja adicionar à configuração do codespace e clique em **Definir Rótulo e Atualizar devcontainer.json**.

   ![Captura de tela do menu pop-up de uma porta encaminhada, com a opção "Definir Rótulo e Atualizar devcontainer.json" realçada com um contorno laranja.](/assets/images/help/codespaces/update-devcontainer-to-add-port-option.png)

4. Digite um rótulo para sua porta e pressione Enter.

   ![Captura de tela do rótulo "Preparo" adicionado como rótulo personalizado a uma porta encaminhada.](/assets/images/help/codespaces/label-text-box.png)

5. Se o repositório tiver mais de um arquivo de configuração do contêiner de desenvolvimento, você será solicitado a escolher qual arquivo deseja atualizar.

   O arquivo de configuração do contêiner de desenvolvimento é atualizado para incluir o novo rótulo na `portsAttributes` propriedade. Por exemplo:

   ```jsonc
   // Use 'forwardPorts' to make a list of ports inside the container available locally.
   "forwardPorts": [3333, 4444],

   "portsAttributes": {
     "3333": {
       "label": "app-standard-preview"
     },
     "4444": {
       "label": "app-pro-preview"
     }
   }
   ```

### Como ver os rótulos de porta na linha de comando

Você pode ver os rótulos de porta ao listar as portas encaminhadas para um codespace. Para fazer isso, use o comando `gh codespace ports` e selecione um codespace.

</div>