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 暴露本地上下文。