ServBay

简体中文

English
繁體中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano

简体中文

English
繁體中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano

Appearance

添加您的第一个网站 ​

在 ServBay 中，添加一个新网站以启动您的本地开发项目既简单又直观。本篇文档将为您详细介绍如何在 ServBay 中添加您的第一个网站，包括操作步骤、重要的配置选项和一些实用技巧。

无论您是开发 PHP、Node.js、静态网站，还是需要设置反向代理或重定向，ServBay 都能提供灵活的支持。

概述 ​

ServBay 旨在为 Web 开发者提供一个强大且易于管理的本地开发环境。其用户友好的图形界面（GUI）让您能够轻松地添加、配置和管理多个本地网站。按照以下步骤，您可以快速地在 ServBay 中创建您的第一个本地网站，并根据项目需求配置相关设置。

前提条件 ​

在开始添加网站之前，请确保：

  • 您已成功在 macOS 系统上安装并启动 ServBay 应用程序。

添加网站的步骤 ​

以下是使用 ServBay GUI 添加新网站的详细步骤：

步骤 1：打开 ServBay 应用程序 ​

首先，在您的 macOS 应用程序文件夹中找到 ServBay 图标，双击打开应用程序。

步骤 2：导航至网站管理界面 ​

ServBay 应用程序启动后，您会看到主界面。在左侧的导航菜单中，点击标有 网站 的选项。这将带您进入 ServBay 的网站管理页面。

导航到网站管理

步骤 3：开始添加新网站 ​

在网站管理页面，查找并点击页面左下角的 + 按钮。点击后，在界面的右侧会出现一个新的表单区域，供您输入新网站的详细配置信息。

点击加号添加新网站

步骤 4：配置网站设置 ​

在新出现的网站配置表单中，您需要填写或选择以下关键信息：

  1. 名称: 为您的本地网站指定一个易于识别的名称。这仅用于您在 ServBay 内部管理和区分不同的网站配置。
  2. 域名: 输入您希望在本地访问该网站的域名。为了避免与真实世界的域名冲突，强烈建议使用 .demo 或 ServBay 配置的其他本地顶级域名（TLD），例如 servbay.demo 或 myproject.servbay.demo。ServBay 会自动处理本地 DNS 解析，让您可以通过这个域名在浏览器中访问本地网站。
  3. 协议: 选择网站支持的协议。通常默认选择 HTTP/HTTPS，ServBay 会自动为您处理本地 HTTPS 的配置。
  4. SSL 证书请求方式: 配置本地网站的 SSL/TLS 加密。
    • ServBay CA: 推荐用于本地开发。 ServBay 会通过内置的 ServBay PKI 自动为您生成并管理一个由 ServBay 根证书颁发的 SSL 证书。您只需要在系统中信任 ServBay 的根证书（ServBay User CA 或 ServBay Public CA），即可在浏览器中实现无警告的 HTTPS 访问。
    • ACME: 如果您需要模拟生产环境，可以使用 ACME 协议（如 Let's Encrypt, ZeroSSL, Google Trust Services 等）为您的本地域名（如果该域名可公开访问并指向您的本地 ServBay 实例）签发真实的公共信任证书。ServBay 支持通过 ACME 自动申请和续期证书。
  5. 网站类型: 根据您的项目技术栈选择合适的类型：
    • PHP: 适用于基于 PHP 的项目，如 WordPress, Laravel, Symfony 等。ServBay 将配置一个 Web 服务器（如 Nginx 或 Apache）与 PHP-FPM 协作来处理 PHP 请求。
    • Node.js: 适用于 Node.js 应用程序。ServBay 通常会配置一个反向代理将 Web 请求转发到您的 Node.js 应用程序监听的端口。
    • 静态: 适用于纯 HTML, CSS, JavaScript 等静态文件构成的网站。Web 服务器将直接提供文件服务。
    • 反向代理: 允许您将某个域名或路径的请求转发到其他本地或远程地址和端口。这对于代理到其他服务或应用非常有用。
    • 重定向: 将来自此域名的所有请求重定向到另一个 URL。
  6. PHP 版本: 如果网站类型选择了 PHP，您需要从下拉列表中选择一个已安装并运行的 PHP 版本来执行该网站的 PHP 脚本。请确保您需要的 PHP 版本已通过 ServBay 的软件包管理界面安装。
  7. URL 重写（伪静态）规则: 大多数现代 Web 框架和内容管理系统（CMS）为了实现美观的 URL 结构（如 /about 而不是 /index.php?page=about），需要 URL 重写规则。ServBay 为常见的应用（如 Laravel, WordPress, Discuz! 等）提供了预设的重写规则选项，您可以直接选择应用。如果您的框架或应用不在列表中，或者您有自定义规则，可能需要手动配置 Web 服务器（Nginx 或 Apache）的配置文件。
  8. 根目录: 指定您网站文件的物理路径。这是 Web 服务器查找和提供文件的起始目录。建议将您的项目文件存放在 ServBay 的默认 www 目录下，例如 /Applications/ServBay/www/servbay-demo。请确保此目录存在且 ServBay 进程有读取权限。

WARNING

对于使用了框架的开发者（比如使用了 Laravel），请注意把根目录指向为有index.php的public目录，而不是项目的根目录。

配置网站设置

步骤 5：保存并激活网站 ​

填写并检查所有配置信息无误后，点击表单下方的 添加 按钮。ServBay 将自动生成并加载新网站的配置到其 Web 服务器（如 Nginx 或 Apache）中，并更新本地 DNS 设置。

保存成功后，您的新网站配置将出现在网站列表页。您可以通过点击右上角的浏览器图标来快速访问您的网站。

步骤 6：利用快捷操作管理网站 ​

网站快捷操作

ServBay 为列表中的每个网站提供了一系列方便的快捷操作按钮，帮助您高效管理本地开发工作流：

  1. 使用 IDE 打开: 快速在您配置的默认代码编辑器或 IDE 中打开网站的根目录。
  2. 在浏览器中打开: 直接在默认 Web 浏览器中打开网站的 URL。
  3. 查看网站日志: 方便地查看该网站相关的 Web 服务器访问日志和错误日志，便于调试。
  4. 暂停/启动网站: 临时禁用或重新启用该网站的访问。
  5. 删除网站: 从 ServBay 配置中移除该网站。请注意，这不会删除网站的实际文件。

简单用例：创建一个静态 HTML 网站 ​

为了验证您的第一个网站是否设置成功，您可以进行以下简单测试：

  1. 按照上述步骤添加一个网站，例如域名设置为 servbay.demo，网站类型选择 静态，根目录设置为 /Applications/ServBay/www/servbay-demo-static。

  2. 在您的文件系统中，创建这个根目录 /Applications/ServBay/www/servbay-demo-static。

  3. 在该目录下创建一个名为 index.html 的文件。

  4. 使用文本编辑器打开 index.html 文件，并添加以下简单的 HTML 代码：

    html
    <!DOCTYPE html>
<html>
<head>
    <title>ServBay Static Test</title>
</head>
<body>
    <h1>恭喜！您的第一个 ServBay 网站已成功运行！</h1>
    <p>如果您看到了这个页面，说明 ServBay 已经成功配置并提供了您的静态网站。</p>
</body>
</html>

  5. 保存 index.html 文件。

  6. 返回 ServBay 网站管理界面，找到您刚刚添加的 servbay.demo 网站，点击快捷操作中的浏览器图标。

  7. 您的浏览器应该会打开 http://servbay.demo (或 https://servbay.demo，取决于您的 SSL 设置)，并显示您创建的 index.html 页面的内容。

注意事项 ​

  • 域名冲突: 避免使用可能与您本地网络或 VPN 冲突的域名。使用 .demo 是一个安全的选择。
  • 根目录权限: 确保 ServBay 运行用户（通常是您的当前用户）对指定的网站根目录及其子文件拥有读取权限。
  • 端口占用: ServBay 默认使用标准端口（HTTP 80, HTTPS 443）。如果这些端口被其他程序占用，ServBay 可能无法正常启动 Web 服务器，或者您的网站无法访问。请检查并关闭占用端口的程序。
  • ServBay CA 信任: 如果使用 ServBay CA 并希望无警告访问 HTTPS，您需要在 macOS 系统中信任 ServBay User CA 或 ServBay Public CA。ServBay 文档中通常有详细指导如何执行此操作。

常见问题解答 (FAQ) ​

  • Q: 为什么我的网站打开后，提示是HTTP Error 403 - Forbidden或者HTTP Error 404 - File not found？
    • A: 这是一般开发者最常见到的错误。
    • 首先检查网站根目录是否正确进行了指向。在大部分现代框架中（Laravel、Symfony、CakePHP 等），出于安全和项目管理考虑，项目的根目录（一般是存放了vendor、composer.json、package.json等文件）并不是网站的根目录/实际入口。
    • 所以，你需要把网站的根目录正确指向至存放了实际入口文件（index.php、index.htm、index.html）的目录。
    • 常见的入口目录：public、web、www、htdocs、wwwroot、webroot等。
  • Q: 我添加了网站，但在浏览器中访问域名显示“无法访问此网站”或“连接被拒绝”？
    • A: 首先检查 ServBay 是否正在运行，并且 Web 服务器（Caddy/Nginx/Apache）状态正常（在 ServBay 主界面查看）。
    • 确认您在浏览器中输入的域名与 ServBay 中配置的域名完全一致。
    • 检查 ServBay 的网站列表中该网站是否处于“运行”状态（非暂停状态）。
    • 确认网站的根目录路径是否正确，并且该目录下存在入口文件（如 index.html, index.php）。
    • 检查是否有其他程序占用了 80 或 443 端口。
  • Q: 我的 PHP 网站没有按预期工作，显示空白页或下载文件？
    • A: 确保您在网站配置中选择了正确的 PHP 版本，并且该 PHP 版本已通过 ServBay 软件包管理安装并正在运行。
    • 检查网站根目录下的文件权限。
    • 查看网站日志（通过快捷操作按钮）是否有 PHP 错误信息。
    • 确认您的项目是否存在 index.php 或其他 ServBay 配置为默认索引文件的文件。
  • Q: 我设置了 HTTPS，但浏览器显示证书警告？
    • A: 如果您使用的是 ServBay CA，您需要在操作系统或浏览器中信任 ServBay 的根证书。请参考 ServBay 官方文档关于信任 CA 证书的指南。
    • 如果您使用的是 ACME，确保您的域名正确指向了 ServBay 实例，并且证书已成功申请和安装。查看 ServBay 日志获取 ACME 申请过程的详细信息。
  • Q: URL 重写规则不生效，导致页面无法访问？
    • A: 确保您在网站配置中选择了与您的框架或应用匹配的 URL 重写规则。
    • 如果使用了 Apache，请确认 .htaccess 文件存在于您的网站根目录或子目录中，并且 ServBay 的 Apache 配置允许读取 .htaccess。
    • 如果使用了 Nginx、Caddy，重写规则通常配置在 ServBay 生成的配置文件中，检查规则是否正确加载。

总结 ​

通过遵循本文的步骤，您应该已经成功地在 ServBay 本地开发环境中添加并运行了您的第一个网站。ServBay 强大的网站管理功能、灵活的配置选项（如 SSL 证书、网站类型、PHP 版本、URL 重写）以及便捷的快捷操作，将极大地提升您的本地开发效率。继续探索 ServBay 的其他功能，如软件包管理、数据库管理等，以构建更完善的本地开发工作流。