Переадресация портов в кодовом пространстве

Примечание. Использование GitHub Codespaces с URI JetBrains в настоящее время находится в общедоступной бета-версии и может быть изменено.

Сведения о переадресованных портах

Переадресация портов обеспечивает доступ к TCP-портам, работающим в кодовом пространстве. Например, если веб-приложение выполняется через определенный порт в кодовом пространстве, можно настроить переадресацию этого порта. Это позволяет получать доступ к приложению из браузера на локальном компьютере для тестирования и отладки.

Когда приложение, выполняющееся в кодовом пространстве, выводит выходные данные в терминал, содержащий URL-адрес localhost, например, http://localhost:PORT или http://127.0.0.1:PORT, выполняется автоматическая переадресация порта. Если GitHub Codespaces используется в браузере или в Visual Studio Code, строка URL-адреса в терминале преобразуется в ссылку, по которой можно перейти, чтобы просмотреть веб-страницу на локальном компьютере. По умолчанию GitHub Codespaces пересылает порты по протоколу HTTP.

Можно также выполнить переадресацию порта вручную, пометить переадресованные порты, предоставить доступ к переадресованным портам членам организации, предоставить общий доступ к переадресованным портам и добавить переадресованные порты в конфигурацию кодового пространства.

Примечание. Владельцы организации могут сделать перенаправляемые порты общедоступными или доступными только внутри организации. Дополнительные сведения см. в разделе Ограничение видимости переадресованных портов.

Переадресация порта

Можно вручную выполнить переадресацию порта, который не был переадресован автоматически. 1. Откройте терминал в codespace.

Перейдите на вкладку ПОРТЫ .
В списке портов нажмите кнопку Добавить порт.
Введите номер порта или адрес, а затем нажмите клавишу ВВОД.

Использование переадресации HTTPS

По умолчанию GitHub Codespaces пересылает порты по протоколу HTTP, но при необходимости вы можете обновить любой порт для использования ПРОТОКОЛА HTTPS. При обновлении порта с общедоступной видимостью для использования ПРОТОКОЛА HTTPS видимость порта автоматически изменится на частный.

Откройте терминал в codespace.
Перейдите на вкладку ПОРТЫ .
Щелкните правой кнопкой мыши порт, который требуется обновить, и наведите указатель мыши на пункт Изменить протокол порта.
Выберите протокол, необходимый для этого порта. Выбранный протокол будет запоминаться для этого порта на время существования кодового пространства.

Общий доступ к порту

Примечание. Сделать порт частным для организации можно, только если организация использует GitHub Team или GitHub Enterprise Cloud.

Если требуется предоставить доступ к переадресованному порту другим пользователям, можно сделать порт частным для организации или общедоступным. После того как вы сделаете порт частным для организации, любой пользователь в организации с URL-адресом порта сможет просмотреть выполняющееся приложение. После того как вы сделаете порт общедоступным, любой пользователь, который знает URL-адрес и номер порта, сможет просмотреть выполняющееся приложение без необходимости проходить проверку подлинности.

Примечание. Выбор параметров видимости портов может быть ограничен политикой, настроенной для организации. Дополнительные сведения см. в разделе Ограничение видимости переадресованных портов.

Откройте терминал в codespace.
Перейдите на вкладку ПОРТЫ .
Щелкните правой кнопкой мыши порт, к которому вы хотите предоставить общий доступ, выберите пункт Видимость портов, а затем выберите пункт Из частного в организацию или Общедоступный.
Справа от локального адреса порта щелкните значок копирования.
Отправьте скопированный URL-адрес пользователю, которому требуется предоставить доступ к порту.

Использование средств командной строки и клиентов REST для доступа к портам

При пересылке порта приложение становится доступным по URL-адресу, https://USERNAME-CODESPACE-NAME-vrpqrxxrx7x2rxx-4000.preview.app.github.devнапример . Если вы перенаправите частный порт из классического приложения VS Code, приложение также будет доступно на порту localhost, 127.0.0.1:4000например .

Чтобы получить доступ к приложению с помощью клиента REST, например Postman, или программы командной строки, например curl, не нужно проходить проверку подлинности, если вы используете порт localhost или обращаетесь к общедоступному порту в удаленном домене. Однако для подключения к частному порту в удаленном домене необходимо пройти проверку подлинности с помощью маркера GITHUB_TOKEN доступа в запросе.

Примечание. Объект GITHUB_TOKEN автоматически создается при запуске codespace и остается неизменным в течение сеанса codespace. При остановке, а затем перезапуске codespace создается новое GITHUB_TOKEN .

### Поиск адреса для подключения

Откройте терминал в codespace.
Перейдите на вкладку ПОРТЫ . Здесь перечислены все переадресованные порты.
Щелкните правой кнопкой мыши порт, к которому вы хотите подключиться, и выберите команду Копировать локальный адрес.
Вставьте скопированный адрес в другое место для последующего использования.

Поиск GITHUB_TOKEN

В окне терминала в codespace введите echo $GITHUB_TOKEN.

Токен — это строка, начинающаяся ghu_с .
Скопируйте маркер.

Важно! Не делитесь этим маркером доступа ни с кем.

### Использование curl для доступа к переадресованным портам

В терминале на локальном компьютере введите:

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

Замените ADDRESS и TOKEN значениями, скопированными ранее.

Использование Postman для доступа к переадресованным портам

Откройте Postman.
Создайте новый запрос GET.
Вставьте скопированный ранее адрес в качестве URL-адреса запроса.
На вкладке Заголовки создайте новую запись, где ключом является X-Github-Token, а значением является GITHUB_TOKEN скопированное ранее.
Нажмите кнопку Отправить. ## Маркировка порта

При открытии пространства кода в браузере или в классическом приложении VS Code можно пометить перенаправленный порт, чтобы упростить его идентификацию в списке.

Откройте терминал в codespace.
Перейдите на вкладку ПОРТЫ .
Наведите указатель мыши на порт, который требуется маркировать, а затем щелкните значок метки.
Введите метку для порта и нажмите клавишу ВВОД.

## Добавление порта в конфигурацию кодового пространства

Можно добавить переадресованный порт в конфигурацию GitHub Codespaces для репозитория, чтобы автоматически выполнять переадресацию порта для всех кодовых пространств, созданных из репозитория. После обновления конфигурации все ранее созданные кодовые пространства необходимо перестроить, чтобы применить изменение. Дополнительные сведения см. в разделе Основные сведения о контейнерах разработки.

Переадресованные порты можно вручную настроить в .devcontainer.json файле с помощью forwardPorts свойства или использовать панель "Порты" в пространстве кода, открытом в браузере, или в классическом приложении VS Code.

Откройте терминал в codespace.
Перейдите на вкладку ПОРТЫ .
Щелкните правой кнопкой мыши порт, который требуется добавить в конфигурацию кодового пространства, а затем выберите пункт Задать метку и обновить devcontainer.json.
Введите метку для порта и нажмите клавишу ВВОД.

Когда приложение, выполняющееся в кодовом пространстве, выводит выходные данные в терминал, содержащий URL-адрес localhost, например, http://localhost:PORT или http://127.0.0.1:PORT, выполняется автоматическая переадресация порта. Если GitHub Codespaces используется в браузере или в Visual Studio Code, строка URL-адреса в терминале преобразуется в ссылку, по которой можно перейти, чтобы просмотреть веб-страницу на локальном компьютере. По умолчанию GitHub Codespaces пересылает порты по протоколу HTTP.

Можно также выполнить переадресацию порта вручную, пометить переадресованные порты, предоставить доступ к переадресованным портам членам организации, предоставить общий доступ к переадресованным портам и добавить переадресованные порты в конфигурацию кодового пространства.

Примечание. Владельцы организации могут сделать перенаправляемые порты общедоступными или доступными только внутри организации. Дополнительные сведения см. в разделе Ограничение видимости переадресованных портов.

Переадресация порта

Можно вручную выполнить переадресацию порта, который не был переадресован автоматически. 1. Откройте терминал в codespace.

Перейдите на вкладку ПОРТЫ .
В списке портов нажмите кнопку Добавить порт.
Введите номер порта или адрес, а затем нажмите клавишу ВВОД.

Общий доступ к порту

Примечание. Сделать порт частным для организации можно, только если организация использует GitHub Team или GitHub Enterprise Cloud.

Если требуется предоставить доступ к переадресованному порту другим пользователям, можно сделать порт частным для организации или общедоступным. После того как вы сделаете порт частным для организации, любой пользователь в организации с URL-адресом порта сможет просмотреть выполняющееся приложение. После того как вы сделаете порт общедоступным, любой пользователь, который знает URL-адрес и номер порта, сможет просмотреть выполняющееся приложение без необходимости проходить проверку подлинности.

Примечание. Выбор параметров видимости портов может быть ограничен политикой, настроенной для организации. Дополнительные сведения см. в разделе Ограничение видимости переадресованных портов.

Откройте терминал в codespace.
Перейдите на вкладку ПОРТЫ .
Щелкните правой кнопкой мыши порт, к которому вы хотите предоставить общий доступ, выберите пункт Видимость портов, а затем выберите пункт Из частного в организацию или Общедоступный.
Справа от локального адреса порта щелкните значок копирования.
Отправьте скопированный URL-адрес пользователю, которому требуется предоставить доступ к порту.

Использование средств командной строки и клиентов REST для доступа к портам

При пересылке порта приложение становится доступным по URL-адресу, https://USERNAME-CODESPACE-NAME-vrpqrxxrx7x2rxx-4000.preview.app.github.devнапример . Если вы перенаправите частный порт из классического приложения VS Code, приложение также будет доступно на порту localhost, 127.0.0.1:4000например .

Чтобы получить доступ к приложению с помощью клиента REST, например Postman, или программы командной строки, например curl, не нужно проходить проверку подлинности, если вы используете порт localhost или обращаетесь к общедоступному порту в удаленном домене. Однако для подключения к частному порту в удаленном домене необходимо пройти проверку подлинности с помощью маркера GITHUB_TOKEN доступа в запросе.

Примечание. Объект GITHUB_TOKEN автоматически создается при запуске codespace и остается неизменным в течение сеанса codespace. При остановке, а затем перезапуске codespace создается новое GITHUB_TOKEN .

### Поиск адреса для подключения

Откройте терминал в codespace.
Перейдите на вкладку ПОРТЫ . Здесь перечислены все переадресованные порты.
Щелкните правой кнопкой мыши порт, к которому вы хотите подключиться, и выберите команду Копировать локальный адрес.
Вставьте скопированный адрес в другое место для последующего использования.

Поиск GITHUB_TOKEN

В окне терминала в codespace введите echo $GITHUB_TOKEN.

Токен — это строка, начинающаяся ghu_с .
Скопируйте маркер.

Важно! Не делитесь этим маркером доступа ни с кем.

### Использование curl для доступа к переадресованным портам

В терминале на локальном компьютере введите:

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

Замените ADDRESS и TOKEN значениями, скопированными ранее.

Использование Postman для доступа к переадресованным портам

Откройте Postman.
Создайте новый запрос GET.
Вставьте скопированный ранее адрес в качестве URL-адреса запроса.
На вкладке Заголовки создайте новую запись, где ключом является X-Github-Token, а значением является GITHUB_TOKEN скопированное ранее.
Нажмите кнопку Отправить. ## Маркировка порта

При открытии пространства кода в браузере или в классическом приложении VS Code можно пометить перенаправленный порт, чтобы упростить его идентификацию в списке.

Откройте терминал в codespace.
Перейдите на вкладку ПОРТЫ .
Наведите указатель мыши на порт, который требуется маркировать, а затем щелкните значок метки.
Введите метку для порта и нажмите клавишу ВВОД.

## Добавление порта в конфигурацию кодового пространства

Можно добавить переадресованный порт в конфигурацию GitHub Codespaces для репозитория, чтобы автоматически выполнять переадресацию порта для всех кодовых пространств, созданных из репозитория. После обновления конфигурации все ранее созданные кодовые пространства необходимо перестроить, чтобы применить изменение. Дополнительные сведения см. в разделе Основные сведения о контейнерах разработки.

Переадресованные порты можно вручную настроить в .devcontainer.json файле с помощью forwardPorts свойства или использовать панель "Порты" в пространстве кода, открытом в браузере, или в классическом приложении VS Code.

Откройте терминал в codespace.
Перейдите на вкладку ПОРТЫ .
Щелкните правой кнопкой мыши порт, который требуется добавить в конфигурацию кодового пространства, а затем выберите пункт Задать метку и обновить devcontainer.json.
Введите метку для порта и нажмите клавишу ВВОД.

Дополнительные сведения о GitHub CLI см. в разделе Сведения о GitHub CLI.

Для переадресации порта используйте подкоманду gh codespace ports forward. Замените codespace-port:local-port удаленными и локальными портами, которые требуется подключить. Выполнив команду, выберите требуемый вариант из представленного списка кодовых пространств.

gh codespace ports forward CODESPACE-PORT:LOCAL-PORT

Дополнительные сведения об этой команде см. в руководстве по GitHub CLI.

Чтобы просмотреть сведения о переадресованных портах, введите gh codespace ports и выберите кодовое пространство.

Общий доступ к порту

Примечание. Сделать порт частным для организации можно, только если организация использует GitHub Team или GitHub Enterprise Cloud.

Если требуется предоставить доступ к переадресованному порту другим пользователям, можно сделать порт частным для организации или общедоступным. После того как вы сделаете порт частным для организации, любой пользователь в организации с URL-адресом порта сможет просмотреть выполняющееся приложение. После того как вы сделаете порт общедоступным, любой пользователь, который знает URL-адрес и номер порта, сможет просмотреть выполняющееся приложение без необходимости проходить проверку подлинности.

Примечание. Выбор параметров видимости портов может быть ограничен политикой, настроенной для организации. Дополнительные сведения см. в разделе Ограничение видимости переадресованных портов.

Для изменения видимости переадресованного порта используйте подкоманду gh codespace ports visibility. Существует три варианта видимости.

private — объект виден только вам. Это вариант по умолчанию при переадресации порта.
org — объект виден членам организации, которой принадлежит репозиторий.
public — объект виден всем, кто знает URL-адрес и номер порта.

Замените codespace-port номером переадресованного порта. Замените setting на private, org или public. Выполнив команду, выберите требуемый вариант из представленного списка кодовых пространств.

gh codespace ports visibility CODESPACE-PORT:SETTINGS

Задать видимость для нескольких портов можно с помощью одной команды. Пример:

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

Дополнительные сведения об этой команде см. в руководстве по GitHub CLI.

Использование средств командной строки и клиентов REST для доступа к портам

При пересылке порта приложение становится доступным по URL-адресу, https://USERNAME-CODESPACE-NAME-vrpqrxxrx7x2rxx-4000.preview.app.github.devнапример . Если вы перенаправите частный порт из классического приложения VS Code, приложение также будет доступно на порту localhost, 127.0.0.1:4000например .

Чтобы получить доступ к приложению с помощью клиента REST, например Postman, или программы командной строки, например curl, не нужно проходить проверку подлинности, если вы используете порт localhost или обращаетесь к общедоступному порту в удаленном домене. Однако для подключения к частному порту в удаленном домене необходимо пройти проверку подлинности с помощью маркера GITHUB_TOKEN доступа в запросе.

Примечание. Объект GITHUB_TOKEN автоматически создается при запуске codespace и остается неизменным в течение сеанса codespace. При остановке, а затем перезапуске codespace создается новое GITHUB_TOKEN .

Поиск адреса для подключения

Чтобы найти адрес переадресованного порта, введите gh codespace ports. Если у вас несколько codespace, выберите соответствующее пространство кода из отображаемого списка.

Скопируйте адрес и вставьте его в другое место для последующего использования.

Поиск GITHUB_TOKEN

Запустите сеанс SSH для codespace.
```
gh codespace ssh
```
Если у вас несколько codespace, выберите соответствующее пространство кода из отображаемого списка.
Отображение .GITHUB_TOKEN
```
echo $GITHUB_TOKEN
```
Токен — это строка, начинающаяся ghu_с .
Скопируйте маркер.

Важно! Не делитесь этим маркером доступа ни с кем.
Выйдите из сеанса SSH.
```
exit
```

Использование curl для доступа к переадресованным портам

В терминале на локальном компьютере введите:

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

Замените ADDRESS и TOKEN значениями, скопированными ранее.

Использование Postman для доступа к переадресованным портам

Откройте Postman.
Создайте новый запрос GET.
Вставьте скопированный ранее адрес в качестве URL-адреса запроса.
На вкладке Заголовки создайте новую запись, где ключом является X-Github-Token, а значением является GITHUB_TOKEN скопированное ранее.
Нажмите кнопку Отправить. ## Маркировка порта

При открытии пространства кода в браузере или в классическом приложении VS Code можно пометить перенаправленный порт, чтобы упростить его идентификацию в списке.

Откройте терминал в codespace.
Перейдите на вкладку ПОРТЫ .
Наведите указатель мыши на порт, который требуется маркировать, а затем щелкните значок метки.
Введите метку для порта и нажмите клавишу ВВОД.

Метки портов отображаются при перечислении перенаправленных портов для codespace. Для этого используйте gh codespace ports команду , а затем выберите codespace.

Добавление порта в конфигурацию кодового пространства

Можно добавить переадресованный порт в конфигурацию GitHub Codespaces для репозитория, чтобы автоматически выполнять переадресацию порта для всех кодовых пространств, созданных из репозитория. После обновления конфигурации все ранее созданные кодовые пространства необходимо перестроить, чтобы применить изменение. Дополнительные сведения см. в разделе Основные сведения о контейнерах разработки.

Переадресованные порты можно вручную настроить в .devcontainer.json файле с помощью forwardPorts свойства или использовать панель "Порты" в пространстве кода, открытом в браузере, или в классическом приложении VS Code.

Откройте терминал в codespace.
Перейдите на вкладку ПОРТЫ .
Щелкните правой кнопкой мыши порт, который требуется добавить в конфигурацию кодового пространства, а затем выберите пункт Задать метку и обновить devcontainer.json.
Введите метку для порта и нажмите клавишу ВВОД.

Переадресация порта

Сведения о том, как перенаправить порт в codespace на порт на локальном компьютере, см. в разделе "Перенаправление портов" статьи "Модель безопасности" документации JetBrains.

Кроме того, для пересылки порта можно использовать GitHub CLI. Для получения дополнительных сведений перейдите на вкладку "GitHub CLI" в верхней части этой страницы.

Переадресация портов в кодовом пространстве

В этой статье