FlyEnv(Web服务器和环境管理器)

FlyEnv 把本地 Web 开发中服务器与运行环境的配置管理搬到了图形界面上，开发者可以直观地完成 PHP、Node.js、Python 等运行环境的搭建。创建站点、切换环境都在界面里操作，不必反复手动改动系统配置文件，本地开发的流程因此省去不少麻烦。

FlyEnv 提供图形化界面，方便管理 PHP 多版本切换、Nginx 与 Apache 服务以及数据库环境，SSL 和伪静态这类常见开发配置也能直接操作，从而减少环境搭建与维护的负担，适合本地开发和测试使用。

FlyEnv使用指南

一、首次启动设置

1. 部署 FlyEnv 辅助工具

初次运行时，FlyEnv 将部署一个协助完成系统集成的辅助组件：

Windows：安装未成功时，可尝试右键以管理员权限启动安装程序

该助手安装一次后，即可用于服务管理与系统路径管理。

2. 自定义界面

FlyEnv 初始状态下会把全部模块都呈现出来，若想让界面更清爽，可以按需精简显示内容：

（1）轻触齿轮形状的“设置”按钮

（2）把用不着的功能模块关掉

（3）剩余模块可通过拖拽调整先后次序

给 PHP 开发者的一条建议：让 Apache/Nginx、PHP、MySQL、Redis 始终处于可见状态。

给 Node.js 开发者的一条建议：让 Node.js、Nginx、MongoDB 始终处于可见状态。

3、安装第一个版本

每个模块都得保证至少有一个版本已经装好：

（1）以 PHP 模块为例，只需点选该模块即可。

（2）进入“版本”标签页

（3）选定一个版本，比如 PHP 8.3

（4）点击 安装

FlyEnv 会自行完成对应版本的获取与设置。

二、创建你的第一个网站

步骤 1：启动所需服务

启动 Web 服务器与 PHP 环境，是搭建站点前需要先行完成的步骤。

（1）启用 Apache 或 Nginx 模块

（2）选择你安装的版本

（3）点击 启动 按钮

若 PHP 与 MySQL 也有同样需求，按上述方式处理即可。

步骤 2：创建站点

（1）进入 Host 模块

（2）点击“添加站点”按钮

（3）填写详细信息：

域名：myproject.test（任意域名均可）

根目录位置：/Users/you/projects/myproject

PHP 版本：请选定你所部署的那个版本

端口：80（默认）

（4）开启自动 SSL，即可通过 HTTPS 访问站点

（5）点击 保存

步骤 3：访问你的站点

保存后：

（1）若 Web 服务器尚未运行，请先将其启动。

（2）在 Host 列表中单击对应站点的链接即可访问

（3）也可以将 https://myproject.test 复制到浏览器地址栏中访问。

系统会默认信任该SSL证书。

三、设置环境变量

FlyEnv 具备系统 PATH 管理能力，让终端也能调用相关命令：

（1）打开任意模块

（2）将“设置到系统路径”按钮点击一下即可完成操作。

（3）选择要添加的版本

为 PHP 设置别名同样可行：

php74 对应 PHP 7.4

php83 对应 PHP 8.3

PATH 配置完成后，需要重新打开终端，新的设置才会起作用。

四、管理服务

1. 一键启动

需要同时启动多个模块时，可以开启 GroupStart 功能：

（1）打开模块服务面板

（2）将 GroupStart 复选框选中

（3）通过主界面中的“全部启动”开关进行操作

2. 查看日志

如果服务启动失败：

（1）在对应模块里按下“日志”按钮

（2）查看错误信息

（3）常见问题：端口被占用、依赖项缺失

常见问题 FAQ

1、FlyEnv 是否仅面向 PHP 开发？

FlyEnv 并非单一运行环境工具，它解决的是多运行时本地开发需求，涉及 PHP、Node.js、Python、数据库、本地站点以及配套工具等方面。

2、FlyEnv 能否取代 Docker？

日常本地开发场景下，这套方案基本够用。若你更看重完整的容器拓扑搭建或生产级别的容器编排能力，Docker 依然具备不可替代的作用。

3、AI 编程客户端能否与 FlyEnv 对接？

FlyEnv 本身就能管理它支持的 AI 编程 CLI，同时还可借助 FlyEnv MCP Server 把本地上下文暴露出来。