FlyEnv 全栈开发环境：快速上手部署项目

FlyEnv 是一款免费开源的一体化全栈开发环境管理工具，适合在本地快速搭建贴近生产的开发环境，覆盖 Nginx/Apache、PHP、NodeJS、Python、数据库、缓存与消息队列等常用组件。

适用场景：Laravel、WordPress、Yii2、FastAdmin、NestJS、SpringBoot、Gin、Beego、Django、Flask 等框架的本地开发与调试。

目录

1. 快速特性概览

2. 安装与启动（Windows / Ubuntu）

3. WordPress 本地开发到生产流程

4. Windows/Ubuntu 兼容与注意事项

5. 常见问题与排错

6. 参考链接

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）

下载地址（官方）：

• https://www.flyenv.com/zh/download.html

快速安装参考（以 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 命令以官方指南为准。推荐阅读官方快速上手文档：https://www.flyenv.com/zh/guide/getting-started.html

4. Windows/Ubuntu 兼容与注意事项

• 路径与大小写：

  • Windows 使用 \ 作为路径分隔，Ubuntu 使用 /；建议统一在配置中使用相对路径或通过 PHP 拼接路径。

  • Ubuntu 文件系统大小写敏感，Windows 不敏感；命名时请统一规范（例如全部小写）。

• 端口占用：

  • 常见端口：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. 参考链接

• 下载页面：https://www.flyenv.com/zh/download.html

• 快速指南：https://www.flyenv.com/zh/guide/getting-started.html

• WordPress 官方：https://wordpress.org/

• Let’s Encrypt：https://letsencrypt.org/