FlyEnv 是一款免费开源的一体化全栈开发环境管理工具,适合在本地快速搭建贴近生产的开发环境,覆盖 Nginx/Apache、PHP、NodeJS、Python、数据库、缓存与消息队列等常用组件。
适用场景:Laravel、WordPress、Yii2、FastAdmin、NestJS、SpringBoot、Gin、Beego、Django、Flask 等框架的本地开发与调试。
目录
- 快速特性概览
- 安装与启动(Windows / Ubuntu)
- WordPress 本地开发到生产流程
- Windows/Ubuntu 兼容与注意事项
- 常见问题与排错
- 参考链接
1. 快速特性概览
- 全栈环境一键集成:从 Python/NodeJS/PHP/Go/Java 到 Nginx/Apache/Caddy,再到数据库和消息队列,减少繁琐配置。
- 极速多版本切换:可在 PHP、NodeJS、Java 等不同版本间无缝切换(例如 PHP 5.6 与 8.3)。
- 跨平台一致性:支持 macOS / Windows / Linux,确保环境一致。
- 项目级环境隔离:进入项目目录即自动切换对应语言版本与依赖。
- 原生性能与轻量:以原生静态二进制运行,资源占用低、启动快。
- 开发者友好:直接访问配置与日志,支持本地站点托管、HTTPS、自签名证书。
- 面向生产:配置贴近真实生产环境,便于迁移部署。
- 工具箱:提供 Markdown 预览、JSON 解析、正则测试、SSL 证书、加密解密、编码转换、二维码生成等。
支持模块(示例,不限于):
- AI 助手:Ollama、DeepSeek、Chatbox
- Web 服务器:Apache、Nginx、Caddy、Tomcat、Consul
- 数据库:MySQL、MariaDB、PostgreSQL、MongoDB
- 邮件:Mailpit
- 语言:PHP、Java、NodeJS、Python、Go、Erlang、Ruby、Rust、Bun、Deno
- 队列与缓存:Redis、Memcached、RabbitMQ、etcd
- 搜索:Elasticsearch、Meilisearch
- 对象存储:Minio
- 其他:DNS、FTP、静态 HTTP 服务器
2. 安装与启动(Windows / Ubuntu)
下载地址(官方):
快速安装参考(以 Windows10 64 位与 Ubuntu 为例):
# Windows(PowerShell)示例
# 说明:从官网下载安装包,安装后直接启动 FlyEnv GUI/CLI
# 提示:首次启动可能需要管理员权限以绑定本地端口
# 启动 FlyEnv(如果安装可执行在 PATH 中)
FlyEnv.exe # 或从开始菜单/桌面快捷方式启动
# 查看当前可用模块(如 CLI 支持)
FlyEnv.exe list-modules # 示例命令,具体以官方文档为准
# Ubuntu(终端)示例
# 说明:从官网下载安装对应的 Linux 包或 AppImage
# 提示:首次运行前确保可执行权限,并检查端口占用
# 假设下载为 appimage
chmod +x FlyEnv.appimage
./FlyEnv.appimage
# 查看模块(如 CLI 支持)
./FlyEnv.appimage --list-modules # 示例命令,具体以官方文档为准
注:FlyEnv 的具体 CLI 命令以官方指南为准。推荐阅读官方快速上手文档:www.flyenv.com/zh/guide/ge…
4. Windows/Ubuntu 兼容与注意事项
-
路径与大小写:
- Windows 使用 `` 作为路径分隔,Ubuntu 使用
/;建议统一在配置中使用相对路径或通过PHP拼接路径。 - Ubuntu 文件系统大小写敏感,Windows 不敏感;命名时请统一规范(例如全部小写)。
- Windows 使用 `` 作为路径分隔,Ubuntu 使用
-
端口占用:
- 常见端口:
80/443(HTTP/HTTPS)、3306(MySQL)、6379(Redis)。 - 若启动失败,检查是否被其他服务占用(IIS、Apache、Docker 等)。
- 常见端口:
-
防火墙与权限:
- Windows 首次启动 FlyEnv 可能需要管理员权限允许端口监听。
- Ubuntu 请检查
ufw/安全组规则,确保外网/内网访问策略符合需求。
-
PHP/Node 多版本:
- FlyEnv 支持项目级版本切换,进入项目目录自动切换;注意 Composer/npm 的缓存与锁定文件。
-
编码与换行:
- 统一使用
UTF-8 (LF),避免 Windows 的CRLF造成脚本解析异常;Git 可配置core.autocrlf=false。
- 统一使用
5. 常见问题与排错
-
无法启动 Web 服务:
- 检查端口占用与权限;查看 FlyEnv 日志输出与对应服务日志(Nginx/PHP-FPM)。
-
HTTPS 证书问题:
- 本地可使用自签名证书;生产建议使用 Let’s Encrypt(自动续期)。
-
PHP 扩展缺失:
- 安装或启用常见扩展(如
curl、mbstring、pdo_mysql等),保持与生产一致。
- 安装或启用常见扩展(如
6. 参考链接
- 下载页面:www.flyenv.com/zh/download…
- 快速指南:www.flyenv.com/zh/guide/ge…
- WordPress 官方:wordpress.org/
- Let’s Encrypt:letsencrypt.org/
🎯 推荐关注
我创建了 代码全栈 平台,专注于:
- ✅ 优质源码和开发工具分享
- ✅ 提供资源代找定制服务
- ✅ 技术问题交流讨论
👉 访问地址:code.allinmy.com
有任何问题欢迎在评论区留言,我会尽快回复!