本地测试环境用宝塔搭建网站，没有域名应该怎么添加站点？

在本地测试环境中，没有域名直接添加站点是开发调试中的常见场景。宝塔面板（BT Panel）本身是一个基于 Web 的管理工具，其核心逻辑是通过 Nginx/Apache 配置虚拟主机。在没有真实域名的情况下，我们通常通过修改本地 Hosts 文件或使用 IP + 端口/路径的方式来实现访问。

以下是几种主流且合规的操作方案，按推荐程度排序：

方案一：修改本地 Hosts 文件（最推荐，模拟真实环境）

这是最接近生产环境的做法。即使没有购买域名，你也可以在本地电脑上“伪造”一个域名指向你的服务器 IP。

1. 在宝塔中添加站点

• 登录宝塔面板。
• 进入【网站】->【添加站点】。
• 域名栏：输入你自定义的测试域名，例如 test.local、myapp.dev 或 localhost-test.com。
• 根目录：选择或新建一个文件夹（如 /www/wwwroot/test.local）。
• 其他选项：保持默认即可，PHP 版本根据项目需求选择。
• 点击【提交】。此时，宝塔会自动生成对应的 Nginx/Apache 配置文件。

2. 修改本机 Hosts 文件

你需要在你自己电脑（客户端）上操作，而不是服务器端。

• Windows 系统：

  • 找到文件：C:WindowsSystem32driversetchosts
  • 用记事本（以管理员身份运行）打开。
  • 在末尾添加一行：

    127.0.0.1 test.local

    注意：如果你的宝塔安装在远程云服务器上，则将 127.0.0.1 替换为服务器的公网 IP 或内网 IP。如果是本机安装的宝塔，则用 127.0.0.1。

• macOS / Linux 系统：

  • 终端执行：

    sudo nano /etc/hosts

  • 添加：

    127.0.0.1 test.local

  • 保存并退出（Ctrl+O, Enter, Ctrl+X）。

3. 验证访问

打开浏览器，访问 http://test.local，即可看到你的网站内容。

优点：完全模拟真实域名访问体验，支持 HTTPS（如果后续申请了证书），Cookie 和 Session 行为正常。
缺点：每台需要访问的电脑都需要修改 Hosts。

方案二：直接使用 IP + 端口访问（最简单，无需改 Hosts）

如果你不想修改 Hosts，可以直接通过 IP 地址访问，但需要注意 Nginx 的默认监听机制。

1. 在宝塔中添加站点

• 域名栏：留空，或者填写 *（部分版本支持，但更稳妥的做法是写一个占位符如 default，然后在配置中调整）。
• 更推荐做法：创建一个站点，域名填 localhost 或任意名称，然后在【设置】->【配置文件】中，确保 server_name 包含 _ 或 *，但这可能影响其他站点。

2. 更稳定的方式：使用非标准端口

由于 HTTP 默认端口 80 和 HTTPS 443 通常被绑定到具体域名，你可以为测试站点分配一个自定义端口。

• 在宝塔【网站】->【添加站点】时，可以设置监听端口（如果版本支持），或者在添加后：
  • 进入该站点的【设置】->【配置文件】。
  • 找到 listen 80;，改为 listen 8080;（或其他未被占用的端口，如 8888）。
  • 保存并重载 Nginx。

3. 访问方式

浏览器输入：http://<服务器IP>:8080

优点：无需任何本地配置，即时可用。
缺点：URL 不美观，不同测试项目需要不同端口，管理混乱；某些前端资源加载可能因跨域或协议问题出错（如强制 HTTPS 的资源在 HTTP 下加载失败）。

方案三：使用XX工具（适合远程调试）

如果你需要在手机、平板或其他网络环境下访问本地搭建的网站，可以使用XX工具。

• 常用工具：ngrok、frp、cpolar、花生壳等。
• 操作简述：
  1. 在服务器上安装穿透客户端。
  2. 启动服务，映射本地 80 端口。
  3. 获得一个临时公网 URL（如 https://abc123.ngrok.io）。
  4. 将此 URL 作为“伪域名”在宝塔中添加站点，或直接使用该 URL 访问。

优点：可外部访问，便于多设备测试。
缺点：依赖第三方服务稳定性，免费版本可能有速度限制或域名变化。

关键注意事项与常见问题

1. 为什么不能直接在宝塔里“不填域名”？

宝塔要求每个站点必须有唯一的标识。如果不填域名，Nginx 无法确定请求应路由到哪个站点。因此，必须提供一个“名称”，无论是真实的域名还是本地的 Hosts 别名。

2. SSL/HTTPS 问题

• 本地测试若启用 HTTPS，需手动生成自签名证书。
• 在宝塔【网站】->【设置】->【SSL】中，选择“其他证书”，粘贴私钥和公钥。
• 浏览器会提示“不安全”，点击“高级”->“继续访问”即可。这对于测试移动端 HTTPS 兼容性非常有用。

3. 数据库连接

• 如果应用代码中硬编码了域名（如 mysql:host=test.local），而实际使用的是 IP，可能导致连接失败。
• 建议：在开发环境中，统一使用 127.0.0.1 或 localhost 作为数据库主机地址，避免域名解析问题。

4. 清除 DNS 缓存

修改 Hosts 后，如果浏览器仍无法访问，请刷新本地 DNS 缓存：

• Windows: ipconfig /flushdns
• macOS: sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
• Chrome 浏览器：可在地址栏输入 chrome://net-internals/#dns 点击“Clear host cache”。

总结建议

对于绝大多数 IT 技术人员而言，方案一（Hosts 映射） 是最佳实践，它既保持了开发环境的隔离性，又提供了与生产环境一致的 URL 结构，便于排查问题。