常见问题解答
本文档汇集了用户在使用 ServBay 本地 Web 开发环境时遇到的常见问题及其解答。
什么是ServBay？
ServBay是一个集成的本地网络开发环境管理工具，专为简化 Web 开发者在 macOS 上设置和管理各种软件包（如 Web 服务器、数据库、编程语言环境）的过程而设计。更多信息请参考 关于 ServBay。
如何安装ServBay？
您可以从ServBay 官方网站下载 ServBay 安装程序，并按照安装向导的步骤进行操作。如需详细的安装说明，请参考 安装 ServBay 文档。
如何卸载ServBay？
在 macOS 上，您可以直接将 ServBay 应用程序拖到“废纸篓”，然后清空“废纸篓”以卸载 ServBay。在执行卸载操作之前，请务必备份重要数据，因为此操作将删除 ServBay 的所有相关文件和配置。请参阅 卸载 ServBay 文档了解详细信息。
ServBay是否支持自动更新？
是的，ServBay 支持自动更新功能，可以方便地获取最新版本、新特性和安全补丁。请参考文档升级 ServBay。
ServBay是否支持Windows/Linux？
目前 ServBay 主要支持 macOS 操作系统。Windows 和 Linux 版本的支持正在计划中，敬请期待。
ServBay支持哪些语言？
ServBay 支持多种界面语言，包括英语、简体中文、繁体中文、西班牙语、阿拉伯语、葡萄牙语、俄语、日语、德语、法语、越南语、土耳其语、意大利语等。您可以根据需要在 ServBay 设置中轻松切换语言。有关切换语言的详细信息，请参阅 多语种支持 文档。
如何在ServBay备份数据？
ServBay 支持对您的开发环境数据进行手动及自动备份，包括 ServBay 的设置、网站文件、数据库内容以及 SSL 证书等关键信息。除了直接手动备份 /Applications/ServBay 整个安装目录外，ServBay 还提供了内置的备份工具和选项，以便更方便地管理和恢复您的数据。详情请查阅 手动及自动备份数据。
ServBay支持哪些软件包？
ServBay 支持丰富的 Web 开发相关软件包，涵盖 Web 服务器、数据库、缓存、编程语言及其版本管理等。主要支持的软件包包括但不限于：Caddy、NGINX、Apache、Mailpit、dnsmasq、多种版本的 PHP、Node.js、Python、Golang、Java、Ruby、Rust、.NET、MySQL、MariaDB、PostgreSQL、MongoDB、Redis、Memcached 等。您可以通过 ServBay 界面轻松管理和配置这些软件包。有关详细的软件包管理信息，请参阅 软件包管理 文档。
如何查看ServBay的发布说明？
您可以在 发布说明 页面查看 ServBay 的详细发布说明。我们定期发布更新，其中包含了新功能介绍、现有功能的改进以及错误修复。
我可以同时运行多个版本的PHP吗？
是的，ServBay 的核心优势之一就是支持同时安装和运行多个 PHP 版本。您可以在软件包管理界面上安装和管理不同的 PHP 版本，并在创建或配置网站时，为每个网站独立选择所需的 PHP 版本。这对于需要维护不同项目（可能依赖不同 PHP 版本）的开发者来说非常方便。有关更多信息，请参考添加第一个网站和如何使用 PHP 进行开发。
ServBay是否支持Laravel，WordPress等框架和CMS？
是的，ServBay 作为一个本地开发环境，完全支持流行的 PHP 框架和内容管理系统（CMS），包括但不限于 Laravel、WordPress、Symfony、CodeIgniter、Joomla、Drupal 等。您可以在 ServBay 中轻松搭建和运行这些应用。相关配置和使用教程请查看如何使用 PHP 进行开发。
ServBay是否支持Vue、React、Next.js、Nuxt.js等框架和CMS？
是的，ServBay 支持基于 Node.js 的流行 JavaScript 和 TypeScript 框架和库，包括但不限于 Vue、React、Angular、Next.js、Nuxt.js、Express.js、Hapi.js 等。您可以在 ServBay 中管理 Node.js 版本，并运行您的前端或后端 JavaScript 项目。相关教程请查看如何使用 Node.js 进行开发。
如何添加网站？
在 ServBay 中添加网站非常简单直观。通过 ServBay 的图形界面，您可以指定网站的根目录、域名、选择 Web 服务器和 PHP/Node.js 版本等。请参考如何添加第一个网站 文档，了解详细的添加和配置步骤。
ServBay如何支持自定义域名和SSL证书？
为了便于本地开发和测试，ServBay 提供了一套完善的本地网络解决方案。它包含一个本地 DNS 服务来解析您设置的自定义域名（例如 servbay.demo 或 yourproject.servbay.demo），以及内置的私有 CA（ServBay User CA）和公共 CA（ServBay Public CA）。这些 CA 可以用来为您的本地网站生成并信任 SSL 证书，从而实现 HTTPS 访问，模拟生产环境。有关详细的支持信息，请参阅 添加非标准顶级域（TLDs）网站 和 使用 SSL（HTTPS）加固网站安全 文档。
我可以在ServBay中使用自定义域名吗？
是的，ServBay 强大地支持使用自定义域名进行本地开发，例如使用 .test, .local, .servbay.demo 等作为顶级域（TLDs）。通过 ServBay 的本地 DNS 功能，您可以为每个网站设置独特的域名，并在浏览器中通过该域名访问您的本地项目。详细指南请参考 添加非标准顶级域（TLDs）网站。
如何在ServBay中为网站启用HTTPS？
在 ServBay 的网站管理界面中，您可以轻松地为您的本地网站启用 HTTPS。ServBay 支持通过多种方式获取和配置 SSL 证书：使用 ServBay 内置的 ServBay User CA 或 ServBay Public CA 生成信任的本地证书，或者通过 ACME 协议（如 Let's Encrypt 或 ZeroSSL）申请真实的公共信任证书（用于可公开访问的站点），您也可以导入自己已有的证书。更多信息请参考 使用 SSL（HTTPS）加固网站安全、使用 ACME 方式申请 SSL 证书、如何从 Let's Encrypt 申请 SSL 证书、如何从 ZeroSSL 申请 SSL 证书、如何从 Google Trust Services 申请 SSL 证书。
ServBay是否支持NGINX、Apache或其他Web服务器？
是的，ServBay 集成了多种主流的 Web 服务器供开发者选择，默认附带了 Caddy、NGINX 和 Apache。用户可以根据项目需求自由选择使用其中任何一个作为网站的 Web 服务器。请参考 如何设置默认 Web 服务器 以获得更多信息。
ServBay可以创建多少个网站？
ServBay 的不同版本对可创建的网站数量有限制：
ServBay Free版本支持创建最多 3 个网站。- 注册用户（免费注册）可创建最多 5 个网站。
- ServBay Pro 和 ServBay Team 版本支持创建无限数量的网站。 您可以在网站管理界面中添加和配置网站。
如何管理数据库？
ServBay 提供了便捷的数据库管理工具，以便您轻松操作 MySQL、MariaDB、PostgreSQL 和 MongoDB 数据库。ServBay 内置并集成了 phpMyAdmin 和 Adminer 这两款流行的 Web 端数据库管理工具，您可以通过 ServBay 界面直接访问它们。有关详细的数据库连接信息和管理指南，请参阅《数据库管理》章节。
如何使用命令行工具？
ServBay 提供了一系列命令行工具，方便开发者进行更高级的操作和自动化任务，包括软件包管理、环境切换以及 PHP 模块编译等。通过 ServBay 提供的 servbayctl 命令行工具，您可以更灵活地控制您的本地开发环境。若要了解更多关于命令行支持的信息，请参考命令行支持和命令行工具 servbayctl 文档。
如何设置默认软件包版本？
ServBay 允许您设置如 PHP、Python、Java、Go、Ruby、Rust、Node.js、MariaDB、PostgreSQL 等软件包在命令行中使用的默认版本。这对于在终端或脚本中直接调用命令（如 php, node, mysql）时非常有用，确保使用的是您期望的版本。同时还支持使用.servbay.config为每一个项目单独设定默认的软件包版本。有关详细的设置信息，请参阅 设置默认版本 、使用.servbay.config文档。
我可以自定义ServBay中的包安装路径吗？
为了维护系统的整洁性和简化管理成本，ServBay 将所有软件包集中安装在特定的目录结构下（主要在 /Applications/ServBay 内部）。目前不支持用户直接定制每个软件包的具体安装路径。
ServBay是否支持多用户和权限管理？
ServBay 目前主要为单用户本地开发环境而设计，不支持传统意义上的多用户账户和精细的权限管理功能。所有 ServBay 运行的服务和网站都在当前登录用户的环境下运行。
如何在ServBay中查看每项服务的日志？
您可以通过 ServBay 的图形界面方便地查看各个服务的运行日志。在软件包管理页面，点击特定软件包右侧的日志图标，即可打开该软件包的日志文件。这对于诊断服务启动失败或运行时遇到的问题非常有帮助。更多信息，请参阅查看 Log 文件 文档。
如何在ServBay中修改PHP配置？
修改 PHP 配置可以通过 ServBay 提供两种主要方式：
- 使用 ServBay UI 界面： ServBay 提供了强大的图形界面，允许您直接修改大部分常用的 PHP 配置参数，这是推荐的方式。详情参考 如何修改 PHP 的设置。
- 手动编辑配置文件： 您也可以直接编辑 PHP 的
php.ini文件。不同版本的 PHP 配置文件位于/Applications/ServBay/etc/php目录中。在此目录中找到对应版本的php.ini文件进行修改。更改后，记得在 ServBay 界面中重启相应的 PHP 服务以使配置生效。更多关于查看和编辑配置文件的信息，请参考查看配置文件。
MySQL/MariaDB 的默认 root 账号和密码是什么？
ServBay 在安装和启动时会为 MySQL 和 MariaDB 数据库设置默认的 root 账号和密码。这些信息通常可以在 ServBay 的数据库管理相关文档中找到。请参考数据库 root 账号密码及连接信息 文档以获取详情，该文档也包含了如何重置密码的说明。
PostgreSQL 的默认 root 账号和密码是什么？
与 MySQL/MariaDB 类似，ServBay 也会为 PostgreSQL 数据库设置默认的管理员账号和密码。这些信息可以在 ServBay 的数据库管理相关文档中找到。请参考数据库 root 账号密码及连接信息 文档以获取详情，该文档也包含了如何重置密码的说明。
ServBay 是否支持针对不同的项目使用不同版本的开发语言？
是的，ServBay 提供了强大的项目级别的运行环境配置功能。开发者可以通过在项目根目录放置.servbay.config配置文件，为不同的项目指定独立的 PHP、Node.js、Python、Go、Java 等开发语言版本，甚至可以配置环境变量。例如，您可以轻松地为项目 A 设置使用 PHP 8.3、Node.js 22，而项目 B 使用 PHP 8.1、Node.js 18。这种项目隔离机制确保了不同项目之间的开发环境互不干扰，极大地提高了开发效率和环境稳定性。