FlyEnv 快速入门指南：5 分钟快速上手
你已经下载了 FlyEnv，接下来呢？本指南帮助你在 5 分钟内完成从安装到运行本地网站的整个过程——无需复杂的终端操作。
安装
macOS
选项 1：Homebrew（推荐）
brew update && brew install flyenv选项 2：下载 DMG
| 架构 | 下载 |
|---|---|
| Intel (x86_64) | GitHub Release |
| Apple Silicon (M1/M2/M3) | GitHub Release |
macOS 用户注意： 如果你只需要简单的 PHP 托管环境，可以在 Mac App Store 查看 FlyPHPServer——这是一个轻量级配套应用。
Windows
下载并解压 ZIP 文件：
| 下载源 | 链接 |
|---|---|
| GitHub Release | 下载 |
| 百度网盘 | 下载 |
解压后运行 FlyEnv.exe。
Linux
支持 Debian/Ubuntu (.deb) 和 Red Hat/Fedora/SUSE/CentOS (.rpm)：
| 发行版 | 架构 | 包类型 |
|---|---|---|
| Debian/Ubuntu | x86_64 | .deb |
| Debian/Ubuntu | arm64 | .deb |
| Red Hat/Fedora | x86_64 | .rpm |
| Red Hat/Fedora | arm64 | .rpm |
从 GitHub Releases 下载。
首次启动设置
1. 安装 FlyEnv 助手
首次启动时，FlyEnv 会安装一个用于系统集成的助手程序：
- macOS/Linux：可能会提示输入密码
- Windows：如果安装失败，请以管理员身份运行
此助手用于管理服务和管理系统路径，只需安装一次。
2. 自定义界面
FlyEnv 默认显示所有模块，你可以简化视图：
- 点击 设置（齿轮图标）
- 关闭你不需要的模块
- 通过拖放重新排列剩余模块
推荐给 PHP 开发者： 保持 Apache/Nginx、PHP、MySQL、Redis 可见。
推荐给 Node.js 开发者： 保持 Node.js、Nginx、MongoDB 可见。
3. 安装第一个版本
每个模块至少需要一个已安装的版本：
- 点击一个模块（例如 PHP）
- 切换到 版本 标签页
- 选择一个版本（例如 PHP 8.3）
- 点击 安装
FlyEnv 会自动下载并配置该版本。
专业提示： 如果你在不同的项目中工作，可以安装多个版本，它们可以和平共存。
创建你的第一个网站
步骤 1：启动所需服务
在创建站点之前，先启动 Web 服务器和 PHP：
- 打开 Apache 或 Nginx 模块
- 选择你安装的版本
- 点击 启动 按钮
如果需要，对 PHP 和 MySQL 执行相同操作。
步骤 2：创建站点
打开 Host 模块
点击 "添加站点"
填写详细信息：
- 域名：
myproject.test（任何域名都可以） - 根目录：
/Users/you/projects/myproject - PHP 版本：选择你安装的版本
- 端口：80（默认）
- 域名：
启用 自动 SSL 以获得 HTTPS 访问
点击 保存
步骤 3：访问你的站点
保存后：
- 启动你的 Web 服务器（如果尚未运行）
- 点击 Host 列表中的站点链接
- 或在浏览器中打开
https://myproject.test
SSL 证书会被你的系统自动信任。
设置环境变量
FlyEnv 可以管理你的系统 PATH 以支持终端访问：
- 打开任意模块
- 点击 "设置到系统路径"
- 选择要添加的版本
对于 PHP，你还可以创建别名：
php74-> PHP 7.4php83-> PHP 8.3
设置 PATH 后重启终端，更改才能生效。
快速项目设置示例
Laravel 项目
# 创建项目
composer create-project laravel/laravel myproject
# 在 FlyEnv Host 模块中
# - 域名: myproject.test
# - 根目录: /path/to/myproject/public
# - PHP: 8.2 或 8.3
# - Nginx 重写规则: 选择 "Laravel" 模板WordPress 站点
# 下载 WordPress
curl -O https://wordpress.org/latest.tar.gz
tar -xzf latest.tar.gz
# 在 FlyEnv 中
# - 在 MySQL 模块中创建数据库
# - 域名: wordpress.test
# - 根目录: /path/to/wordpress
# - 启用 URL 重写静态 HTML 站点
# 创建文件夹
mkdir mystaticsite
echo "<h1>Hello FlyEnv</h1>" > mystaticsite/index.html
# 在 FlyEnv 中
# - 域名: static.test
# - 根目录: /path/to/mystaticsite
# - 设置为 "静态站点"（无 PHP）Node.js/NestJS 项目
# 创建 NestJS 应用
npm i -g @nestjs/cli
nest new myapi
# 在 FlyEnv 中
# - 启动 Node.js 服务
# - 使用 Nginx 反向代理到 3000 端口
# - 查看反向代理指南了解详情管理服务
一键启动
为需要一起启动的模块启用 GroupStart：
- 打开模块服务面板
- 勾选 GroupStart 复选框
- 使用主界面上的 "全部启动" 开关
查看日志
如果服务启动失败：
- 点击模块中的 日志 按钮
- 查看错误信息
- 常见问题：端口冲突、缺少依赖
升级 FlyEnv
FlyEnv 包含自动更新功能：
- 在 设置 -> 关于 中检查更新
- 或手动下载最新版本
你的数据是安全的： 程序文件和数据分开存储，升级不会删除你的站点或数据库。
卸载
如果你需要移除 FlyEnv：
macOS
# 移除应用
rm -rf /Applications/FlyEnv.app
# 移除数据（可选）
rm -rf ~/Library/FlyEnv
rm -rf ~/Library/PhpWebStudyWindows
- 删除 FlyEnv 文件夹
- 数据文件夹位于同一目录下的
FlyEnv-Data
Linux
# 移除包
sudo apt remove flyenv # 或 rpm 等效命令
# 移除数据
rm -rf ~/.config/FlyEnv故障排除
"端口已被占用" 错误
原因：其他应用程序正在使用 80、443 或 3306 端口
解决方案：
# 查找使用 80 端口的进程
sudo lsof -i :80
# 或在设置中更改 FlyEnv 端口macOS 上出现 "权限被拒绝"
解决方案：在系统偏好设置 -> 安全性与隐私中，授予 FlyEnv 完全磁盘访问权限
站点显示 "502 Bad Gateway"
原因：
- PHP-FPM 未运行
- 为站点选择了错误的 PHP 版本
- Nginx/Apache 配置不正确
解决方案：检查 PHP-FPM 是否已启动，并查看日志中的错误。
更改未生效
解决方案：
- 清除浏览器缓存
- 重启 Web 服务器
- 检查文件权限
常见问题 (FAQ)
Q：使用 FlyEnv 需要了解命令行吗？
A：不需要。虽然提供终端访问，但所有操作都可以通过 GUI 完成。
Q：我可以使用现有的 Homebrew 安装吗？
A：可以。FlyEnv 会自动检测 Homebrew 和 MacPorts 安装。
Q：如何备份我的站点？
A：你的项目文件在你选择的目录中。数据库导出可以通过 MySQL 模块完成。
Q：我可以导入现有项目吗？
A：当然可以。只需将 Host 根目录路径指向你现有的项目文件夹。
Q：我可以使用哪些域名？
A：任何以 .test、.local、.dev 结尾的域名或自定义 TLD。在某些网络上避免使用 .local，因为可能存在 mDNS 冲突。
下一步
现在你已经运行起来了，探索这些功能：
- 项目级版本隔离 — 自动版本切换
- 自定义域名和 SSL — 专业本地开发
- 构建本地 AI 代理 — 使用 Ollama 的离线 AI
如果还没有 下载 FlyEnv，祝你编码愉快！