> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 启用 XBOX Device Portal

> 在 Dev Home 的 Remote Access Settings 中启用 XBOX Device Portal，从电脑上的浏览器进行连接，并设置自定义 SSL 证书以避免警告。

要在 XBOX 主机上启用或禁用 XBOX Device Portal，请在 Developer Home (Dev Home) 的**主页**界面的 **Remote Access** 选项卡中选择 **Remote Access Settings** 按钮，如以下截图所示。

![Remote Access Settings 按钮](https://mintcdn.com/microsoft-4404708b/MVw3uKm0dcJ_XQoZ/images/gdk/tools/xdp_1.webp?fit=max\&auto=format\&n=MVw3uKm0dcJ_XQoZ\&q=85\&s=4c68780467c35c2c69f0ee3b775ca208)

![Remote Access 选项卡](https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/gdk/tools/xdp_2.png?fit=max\&auto=format\&n=5IpvKlT-jmAaVkeY\&q=85\&s=631dc42ad1b4336c9aa0ca12196e43d0)

## 连接到 XBOX Device Portal

1. 在主机上，打开 Developer Home (Dev Home)。
2. 在**主页**界面上，找到 **Remote Access** 窗格。该窗格显示用于 XBOX Device Portal 的 IP 地址和端口。
3. 在开发 PC 的 Web 浏览器中，转到 `https://<ip-address>:<port>`。默认端口为 11443。请在地址中包含 `https://`。

XBOX Device Portal 在主机本身上运行。它不是公共网站，因此无法通过搜索打开。请将包含 `https://` 的完整地址直接输入到浏览器的地址栏中。如果浏览器显示的是搜索引擎结果，则说明它将该地址视为搜索查询。

你也可以使用其他设备上的 Web 浏览器，如 [XBOX Device Portal](https://docs.xbox.com/zh-CN/tools/tools-console/wdp/wdp.md) 中所述。该设备必须能够通过网络访问主机的 IP 地址。

如果页面无法加载：

* 确认已在 **Remote Access Settings** 中启用 XBOX Device Portal。
* 确认你使用的是 **Remote Access** 窗格中显示的 IP 地址和端口。

## 证书警告

当你从 Web 浏览器连接到 XBOX Device Portal 时，会出现一条关于所提供证书的警告消息（类似于以下截图）。这是因为由你的 XBOX 开发工具包签名的安全证书不被视为知名的可信颁发者。若要访问 XBOX Device Portal，请选择 **继续访问此网页**。

![证书警告中的“继续访问此网页”选择项](https://mintcdn.com/microsoft-4404708b/5IpvKlT-jmAaVkeY/images/gdk/tools/xdp_3.png?fit=max\&auto=format\&n=5IpvKlT-jmAaVkeY\&q=85\&s=ae9239e0536f31ea03d272ee4141797e)

警告的措辞因浏览器而异。在某些浏览器中，你需要先选择 **高级**，才能显示继续访问该页面的选项。

如果浏览器未提供继续访问的选项（例如，因为它报告该站点使用 HSTS），请按照下一节中的说明设置自定义 SSL 证书。浏览器信任开发工具包的证书后，该警告将不再阻止连接。

## 使用自定义 SSL 证书

要在连接到 XBOX Device Portal 时防止出现此警告消息，请将你的 Web 浏览器设置为信任你的开发套件。方法是提供你自己的根证书颁发机构（*root CA*）和 SSL 证书。根 CA 会对证书进行签名以建立可信连接。每个开发套件都需要一个由根 CA 签名的唯一证书。使用一个根 CA 和多个证书，可以将同一台开发 PC 连接到多个开发套件。在多台开发 PC 上使用同一个根 CA，可以使用相同的证书连接到相同的开发套件。

### 预配 XBOX Device Portal

1. 如果你或你的组织已有根 CA，请使用它为每个开发套件创建证书。

2. 如果你没有根 CA，则必须自行创建。有关如何执行此操作并将你的根 CA 安装到开发 PC 的“受信任的根证书颁发机构”中，请参阅[使用自定义 SSL 证书预配 Device Portal](https://learn.microsoft.com/windows/uwp/debug-test-perf/device-portal-ssl)。

3. 使用该根 CA 为开发套件创建一个已签名的证书。有关如何执行此操作，请参阅前面的链接。

4. 通过在无人参与安装脚本中使用 **Add XBOX Device Portal custom certificate** 操作，将该证书添加到 XBOX Device Portal。


## Related topics

- [XBOX Device Portal（XBOX 上的 Windows Device Portal）](https://docs.xbox.com/zh-CN/tools/tools-console/wdp/index.md)
- [使用 XBOX Device Portal 管理主机设置](https://docs.xbox.com/zh-CN/tools/tools-console/wdp/windows-device-portal-on-xbox-settings.md)
- [网络页面](https://docs.xbox.com/zh-CN/tools/tools-console/devhome/devhome-networking.md)
- [XBOX Manager：管理主机设置](https://docs.xbox.com/zh-CN/tools/tools-console/xbom/manager-tool-console-settings.md)
- [Xbox 服务沙盒概述](https://docs.xbox.com/zh-CN/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)
