ServBay安装配置详细教程与操作指南
ServBay 是一款 Mac 平台的集成式本地开发工具，支持一键安装 Web 服务器等环境。它更贴近日常 macOS 使用场景，处理高频操作时整体会更顺手一些。
新手入门 ServBay 本地开发环境，详解安装包下载、Dashboard 状态监控、Packages 组件安装、Services 服务控制及 Websites 项目配置。掌握 .servbay.config 版本管理与日志排查技巧，快速搭建稳定的 PHP、Node.js 等多语言开发环境。
ServBay 是一款面向本地 Web 开发的集成环境管理工具，允许用户在一个统一的界面中安装和管理 PHP、Node.js、Python、数据库及 Web 服务器等组件。对于初次接触的用户而言，理解主面板、软件包管理、服务控制与网站配置之间的逻辑关系，是高效使用该软件的关键。以下将按界面功能区域，梳理从安装到运行本地项目的操作路径。
ServBay 安装过程中的权限授权界面
关于【下载安装与授权】
首先需根据操作系统从 ServBay 官方下载页获取对应的安装包。macOS 用户通常下载 .dmg 文件，Windows 用户则使用相应的安装程序。在安装前，建议确认系统版本符合当前发行版的要求，并检查是否有其他本地服务占用了 Web 服务器或数据库的默认端口，以避免冲突。
首次运行安装程序时，系统可能会请求管理员权限，用于安装 ServBay Helper 或配置服务管理所需的底层组件。请务必确认安装包来源可靠后再授权。若拒绝权限请求，ServBay 可能无法启动后台服务、绑定端口或正常管理软件包，导致后续功能受限。
关于【Dashboard 主面板】
安装完成并启动 ServBay 后，首先映入眼帘的是 Dashboard（主面板）。该区域主要用于概览核心服务的运行状态，并提供快捷控制入口。用户可以在此直观地看到 Web 服务器、各类运行时环境以及数据库是否处于“运行中”状态。
当本地网站无法访问时，应优先检查主面板的状态指示，而非直接修改项目代码。如果 Web 服务器或对应的运行时显示为停止、错误或配置异常，点击进入服务详情页查看初步日志，再决定是否需要重启服务。这种先观察后操作的习惯能有效减少盲目调试的时间。
ServBay Dashboard 主面板显示服务状态
关于【Packages 软件包】
左侧导航栏中的【Packages】区域是管理开发组件的核心入口。在这里，用户可以浏览和安装语言运行时、Web 服务器、数据库、缓存服务以及其他开发工具。列表通常会清晰展示组件名称、可用版本、已安装版本以及当前的运行状态。
当项目需要特定版本的运行时，只需在列表中找到对应项，点击安装并等待状态变更为“Running”或“已安装”。ServBay 支持同一组件安装多个版本并存，但需注意，安装多个版本并不意味着项目会自动切换至目标版本，后续还需在网站配置或项目配置中明确指定所使用的版本。
关于【Services 服务管理】
【Services】面板按服务或软件包维度列出当前状态，并提供启动、停止、重启、查看日志以及安装或删除等控制选项。Web 服务器、PHP、Node.js 和数据库之间存在着紧密的配合关系：一个网站要正常访问，通常要求 Web 服务器、项目所需的运行时以及数据库均处于正确的运行状态。
在切换版本或调整配置时，应先确认哪些项目正在使用该版本的服务，然后再执行停止或重启操作。除非正在进行环境重置且已保存所有工作，否则不建议为了处理单个网站的问题而一键停止所有核心服务，以免影响其他正在开发的项目。
Packages 区域展示可安装的运行时和数据库版本
关于【Websites 网站管理】
【Websites】区域用于添加和管理本地的网站项目。在网站详情配置中，通常包含项目根目录、本地域名、Web 服务器类型、PHP 或其他运行时版本的选择，以及 HTTPS 和反向代理等高级设置。
添加新项目时，首先选择实际的网站根目录路径，然后指定该项目需要的 Web 服务器和运行时版本。保存配置后，应检查网站状态和本地域名解析情况。打开一个最小化的测试页面，确认请求确实指向了该项目目录，而不是被其他同名或默认配置的网站拦截。
关于【版本选择与项目配置】
ServBay 提供了灵活的多层级版本管理机制。全局设置中可以定义默认的运行时版本，而单个网站可以在【Websites】中指定独立的 PHP 或 Web 服务器版本。此外，项目根目录下的 .servbay.config 文件允许为 PHP、Node.js、Python、Go、Java 等项目更精细地指定环境版本和包管理配置。
创建 .servbay.config 时，需确保文件名准确无误，内容遵循 KEY=VALUE 格式，每行一个配置项。配置生效后，重新加载网站，并在 ServBay Terminal 或项目终端中使用 php -v、node -v 等命令核对版本。若项目未设置特定配置，系统将自动回退到全局默认值。
关于【Settings 与 CLI】
【Settings】区域用于调整 ServBay 的全局选项、命令行工具集成及其他环境配置。如果需要在终端中直接调用 ServBay 集成的 PHP、Node.js 或数据库命令，需先在 Settings 中安装或启用 Command Line Tool 支持，随后重新打开终端以检查命令路径是否生效。
需要注意的是，命令行中执行的版本与网站运行时使用的版本可能并不一致。网站版本由【Websites】设置决定，而终端命令可能受全局设置或 .servbay.config 影响。当遇到“网页显示版本正确，但终端查询版本不一致”的情况时，应分别在这两个位置进行核对和修正。
关于【Settings 与 CLI】
关于【Logs 日志】
当出现安装失败、服务无法启动或网站返回错误时，查看对应服务的日志是首要的排查步骤。通过日志内容，可以区分问题是源于端口占用、配置语法错误、权限不足、版本依赖冲突，还是项目代码本身的错误。
每次修改配置后，建议重新启动或重新加载相关服务，并进行一次最小化测试，避免同时修改 Web 服务器、PHP、数据库和项目文件，以便准确定位问题源。若日志中包含账号、路径或密钥等敏感信息，在截图求助前务必进行打码处理。
安装完成后的验证关系
在完成所有配置后，建议按照“Packages 已安装 — Services 正常运行 — Website 指向正确目录 — 运行时版本匹配 — CLI 命令可用”的顺序进行最终检查。首先使用静态页面确认域名解析和 Web 服务器工作正常，接着使用最小动态页面确认运行时环境无误，最后尝试连接数据库以确保数据层通畅。
尽管 ServBay 的不同版本可能在导航名称和面板布局上有所调整，但其核心配置逻辑始终遵循“组件安装、服务运行、网站绑定、项目版本覆盖、日志验证”这一链条。遵循此顺序进行设置，不仅能使本地开发环境更易于复用，也能在出现问题时更快速地定位是服务层、网站配置层还是项目本身的问题。
安装完成后的验证关系
Figma 是面向产品团队的界面与原型设计平台，Mac 客户端支持 Intel 和 Apple 芯片，可直接调用本机字体。它将矢量绘制、自动布局、组件库、交互原型、评论及多人实时编辑集中在统一工作区。
Final Cut Pro 是 Apple 面向 Mac 用户推出的专业视频剪辑软件，提供磁性时间线、媒体资源库、多机位剪辑、字幕生成、对象跟踪、调色、音频处理和多格式输出等工具。软件针对 Apple 芯片优化。
FreeCAD是一款免费开源的三维参数化建模软件，可通过草图、约束和特征历史构建尺寸精确且便于修改的模型。软件提供零件设计、装配、工程制图、建筑信息模型、有限元分析、数控加工及三维打印等工作台，并支持插件、宏和Python脚本扩展。
IntelliJ IDEA 是 JetBrains 推出的专业集成开发环境，重点服务于 Java、Kotlin 与 JVM 项目开发。软件集成代码补全、静态检查、重构、调试、测试、版本控制及构建工具，并可借助插件扩展语言和框架支持。
PhpStorm 是 JetBrains 推出的专业 PHP 集成开发环境，可在 Mac 上完成代码编写、智能检查、重构、调试、测试和数据库管理。它支持主流 PHP 框架、Composer、Git、Docker 与远程解释器。
JetBrains PyCharm 是面向 Python 开发者的集成开发环境，提供智能补全、代码检查、重构、调试、测试、版本控制及虚拟环境管理功能。Mac 版兼容 Intel 与 Apple 芯片，核心功能可免费使用。
JetBrains WebStorm 是面向 JavaScript、TypeScript 和现代 Web 技术的专业集成开发环境，可智能理解项目结构，提供代码补全、重构、错误检查、运行调试、测试及 Git 工具。
Logic Pro 是 Apple 为 Mac 打造的专业音乐制作软件，集音频与 MIDI 录制、编曲、节拍制作、采样、混音和母带处理于一体。它提供丰富的软件乐器、效果插件、声音资源以及智能创作工具。
Navicat Premium 是适用于 Mac 的一体化数据库开发与管理工具，可在统一界面中连接 MySQL、PostgreSQL、MongoDB、MariaDB、SQL Server、Oracle、SQLite、Redis 和 Snow
Pixelmator Pro 是 Apple 面向 Mac 用户提供的专业图像编辑与视觉设计软件，集照片调色、对象移除、图层合成、蒙版、矢量绘图、文字排版和数字绘画于一体。软件深度利用 Apple 芯片、Metal 与系统服务。
Postman是一套面向API全生命周期的开发与测试平台，可在Mac上发送和调试多种协议请求，管理集合、环境及认证信息，并完成脚本测试、模拟服务、监控、文档发布和团队协作。它适合开发、测试及运维人员使用，提供个人免费方案。
Pro Tools 是 Avid 推出的专业数字音频工作站，覆盖多轨录音、无损剪辑、MIDI 编曲、插件处理、自动化混音及声音与画面同步等工作。它拥有 Intro、Artist、Studio 和 Ultimate 等方案。
Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件，支持 Windows、macOS 和 iPad 等平台，广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。
Blender 是一款免费开源、跨平台的专业 3D 创作软件，集建模、动画、渲染、视频编辑与视觉合成等功能于一体，广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎，并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统，安装包轻巧、运行流畅，依托活跃的全球开发者社区持续更新，是从初学者到专业创作者都值得选择的正版 3D 创作工具。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。