为自托管的 Puter 配置域名

本地网络配置

先决条件

确保托管设备拥有静态 IP 地址，以防止因 IP 地址变更而导致的潜在连接问题。此设置将允许您在本地网络中无缝访问 Puter 及其服务。

使用 Hosts 文件

Hosts 文件是一种将域名映射到个别设备上的 IP 地址的直接方式。它的设置很简单，但需要在需要访问这些域名的每个设备上手动更改。

Windows

  1. 以管理员身份打开记事本。
  2. 打开位于 C:\Windows\System32\drivers\etc\hosts 的文件。
  3. 以下列格式添加您的域名和子域名以及服务器的 IP 地址：
  1. 192.168.1.10 puter.local
  2. 192.168.1.10 api.puter.local

对于 macOS 和 Linux：

  1. 打开一个终端。
  2. 使用文本编辑器编辑 hosts 文件，例如 sudo nano /etc/hosts。

  3. 以下列格式添加您的域名和子域名以及服务器的 IP 地址：

    1. 192.168.1.10 puter.local
    2. 192.168.1.10 api.puter.local

  4. 保存并退出编辑器。

使用路由器配置

一些路由器允许您添加自定义 DNS 规则，让您能够在不触碰每台设备的情况下，整个网络范围内配置域名。

  1. 访问您的路由器管理界面（通常通过 Web 浏览器）。
  2. 查找 DNS 或 DHCP 设置。
  3. 为 puter.local 和 api.puter.local 添加自定义 DNS 映射到托管设备的 IP 地址。
  4. 保存更改并必要时重启路由器。

这种方法的可用性和步骤可能因您的路由器型号和固件而异。

使用本地 DNS

在您的网络上设置本地 DNS 服务器允许灵活且可扩展的域名解析。一旦设备配置为使用 DNS 服务器，此方法便可以自动在所有设备上工作。

DNS 软件选项：

  • Pi-hole：充当广告拦截器和 DNS 服务器。对于简单的设置和维护来说非常理想。
  • BIND9：为复杂设置提供全面的 DNS 服务器功能。
  • Dnsmasq：轻量级，适合小型网络或那些新手运行 DNS 服务器的人。

贡献者注： 随意添加您知道的任何可能有助于此的软件到列表中。同样，随意为特定软件在这里添加说明；我们的目标是使 Puter 易于使用您已经熟悉的工具进行设置。

一般步骤：

  1. 在网络内的设备上选择并安装 DNS 服务器软件。
  2. 配置 DNS 服务器以解析 puter.local 和 api.puter.local 到您的 Puter 托管设备的 IP 地址。
  3. 更新您的路由器的 DHCP 设置，以将 DNS 服务器的 IP 地址分发给网络上的所有设备。

通过设置本地 DNS 服务器，您将获得对网络域名解析的最大程度的灵活性和控制，确保所有设备都可以在不手动配置的情况下访问 Puter 及其 API。

生产环境配置

请注意，自托管功能仍处于 Alpha 版本，目前不建议在公共生产环境中部署。然而，如果您希望公开托管，可以按照通常用于配置域名的相同步骤进行操作，并确保 api 子域名也指向服务器。