前言

作为开发者，你是否经常遇到以下痛点：

  • 项目 A 需要 Node.js 16，项目 B 需要 Node.js 20，手动切换 nvm use 总是忘记
  • PHP 7.4 老项目和 PHP 8.3 新项目并存，改 PATH 改到头秃
  • 为了本地开发装了一堆工具：nvm、pyenv、phpstudy、Navicat…桌面乱成一锅粥
  • 想用 Docker 又嫌它吃内存，启动慢得像乌龟爬

FlyEnv 就是来解决这些问题的。它是一款 轻量化一体化原生开发环境管理工具，把运行时、数据库、Web 服务器、HTTPS、AI 编程工具全部收进一个桌面应用，而且不依赖 Docker 容器。

FlyEnv 是什么？

FlyEnv 是一款面向全栈开发者的本地环境管理工具，原生支持 macOS、Windows 和 Linux。它的核心理念是：用原生二进制替代容器，用一个工作区替代一堆零散工具。

简单来说，FlyEnv 能帮你：

能力 说明
多语言运行时管理 PHP、Node.js、Python、Go、Java、Ruby、Rust 等，支持多版本共存
数据库管理 MySQL、MariaDB、PostgreSQL、MongoDB、Redis 等一键安装启动
Web 服务器 Apache、Nginx、Caddy、Tomcat 等，支持反向代理和虚拟主机
本地站点管理 自定义域名、自动 HTTPS/SSL、日志查看
AI 编程集成 内置 Claude Code、Codex、OpenCode 等 AI 编程 CLI 和 MCP Server
项目级环境隔离 进入项目目录自动切换对应的运行时版本

FlyEnv 一站式原生全栈架构

macOS

推荐使用 Homebrew 安装：

1
brew update && brew install flyenv

也可以从 GitHub Releases 下载 DMG 安装包。

Windows

从 GitHub Release 或百度网盘下载 ZIP 包，解压后运行 FlyEnv.exe 即可。

Linux

支持 Debian/Ubuntu (.deb) 和 Red Hat/Fedora (.rpm)：

1
2
3
4
5
# Debian/Ubuntu
sudo dpkg -i flyenv_*.deb

# Red Hat/Fedora
sudo rpm -i flyenv_*.rpm

首次启动配置

1. 安装 FlyEnv 助手

首次启动时，FlyEnv 会安装一个系统助手程序。macOS/Linux 可能需要输入密码，Windows 需要管理员权限。这个助手用于管理服务和系统路径，只需安装一次。

2. 选择需要的模块

FlyEnv 默认显示所有模块，你可以根据自己的技术栈精简界面：

  • PHP 开发者：保留 Apache/Nginx、PHP、MySQL、Redis
  • Node.js 开发者：保留 Node.js、Nginx、MongoDB
  • 全栈开发者：全部保留

点击 设置（齿轮图标）可以关闭不需要的模块。

3. 安装运行时版本

每个模块至少需要安装一个版本：

  1. 点击模块（如 PHP）
  2. 切换到 版本 标签页
  3. 选择版本（如 PHP 8.3）
  4. 点击 安装

FlyEnv 会自动下载并配置，支持多个版本共存。

实战：搭建本地开发环境

场景一：Laravel 项目

1
2
3
4
5
6
7
8
9
10
11
12
# 1. 在 FlyEnv 中安装 PHP 8.3、Nginx、MySQL、Composer

# 2. 创建项目
composer create-project laravel/laravel myproject

# 3. 在 Host 模块添加站点
#    域名: myproject.test
#    根目录: /path/to/myproject/public
#    PHP 版本: 8.3
#    Nginx 重写规则: 选择 "Laravel" 模板

# 4. 启动服务，访问 https://myproject.test

场景二：Node.js + MongoDB 项目

1
2
3
4
5
6
7
# 1. 在 FlyEnv 中安装 Node.js 20、MongoDB、Nginx

# 2. 启动 MongoDB 服务

# 3. 使用 Nginx 反向代理到 Node.js 的 3000 端口

# 4. 项目自动使用 Node.js 20，无需 nvm

场景三：多版本 PHP 共存

1
2
3
4
5
6
# 在 FlyEnv 中同时安装 PHP 7.4 和 PHP 8.3

# 老项目 use PHP 7.4
# 新项目 use PHP 8.3
# 在 Host 模块为每个站点指定对应的 PHP 版本
# 无需修改任何 shell 配置

核心功能详解

项目级环境隔离

这是 FlyEnv 最亮眼的功能之一。当你 cd 进入项目目录时，FlyEnv 会自动加载该项目配置的运行时版本，无需手动执行 nvm use 或修改 PATH。

配置方式：

  1. 在 Host 模块为站点指定运行时版本
  2. 进入项目目录时自动生效
  3. 不影响其他项目的环境

一键启动服务组

把常用的模块组合成一个启动组：

  1. 打开模块服务面板
  2. 勾选 GroupStart 复选框
  3. 使用主界面上的 “全部启动” 开关，一键启动所有服务

本地域名与 HTTPS

FlyEnv 内置 MkCert，可以为本地站点自动签发可信 SSL 证书：

  1. 在 Host 模块添加站点时启用 自动 SSL
  2. 使用 .test、.local、.dev 等域名
  3. 浏览器直接访问，无需手动配置证书

AI 编程工具集成

FlyEnv 把 AI 编程客户端和本地环境打通：

  • 内置 AI CLI：Claude Code、Codex、OpenCode、Kimi 等
  • MCP Server：让 AI 客户端能读取本地服务、配置、日志
  • Ollama 集成：一键搭建本地离线 AI 环境

通过 MCP，AI 不再只看到代码，还能看到运行中的数据库、Web 服务和配置文件，真正理解你的本地环境。

FlyEnv vs 其他工具

对比项 FlyEnv Docker Desktop XAMPP/MAMP nvm + pyenv
启动速度 毫秒级 秒级 秒级 毫秒级
内存占用 低 高（GB 级） 中 低
多版本支持 全语言 需写 Dockerfile 单版本 各自管理
AI 集成 原生支持 需额外配置 无 无
项目级隔离 原生支持 容器级 不支持 需手动切换
HTTPS 自动配置 需手动 需手动 不支持
跨平台 ✅ ✅ ❌（仅 macOS/Windows） ✅

常见问题

Q：FlyEnv 需要会命令行吗？
A：不需要。所有操作都可以通过 GUI 完成。

Q：我已经有 Homebrew 安装的软件，能用吗？
A：可以。FlyEnv 会自动检测 Homebrew 和 MacPorts 已安装的软件。

Q：升级 FlyEnv 会丢失数据吗？
A：不会。程序文件和数据分开存储，升级不会影响站点和数据库。

Q：能替代 Docker 吗？
A：对于日常本地开发完全可以。如果需要完整的容器编排或生产环境模拟，Docker 仍有价值。

总结

FlyEnv 的价值不在于某一个功能特别强，而在于 把所有能力放在一个地方：运行时管理、数据库、Web 服务器、HTTPS、AI 编程工具——共享同一批项目和工作流。

过去你需要：nvm + pyenv + phpstudy + Navicat + Postman + 各种 shell 脚本

现在只需要：一个 FlyEnv

安装 → 配置 → 运行 → 调试 → 接入 AI → 交付，全部在一个工作区完成。

📥 下载地址：https://flyenv.com/zh/download.html
📖 官方文档：https://flyenv.com/zh/guide/what-is-flyenv.html
🐙 GitHub：https://github.com/xpf0000/FlyEnv