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

62 阅读4分钟

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

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

img


目录

  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 服务器

img


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…

img


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 扩展缺失:

    • 安装或启用常见扩展(如 curlmbstringpdo_mysql 等),保持与生产一致。

6. 参考链接

🎯 推荐关注

我创建了 代码全栈 平台,专注于:

  • ✅ 优质源码和开发工具分享
  • ✅ 提供资源代找定制服务
  • ✅ 技术问题交流讨论

👉 访问地址:code.allinmy.com

有任何问题欢迎在评论区留言,我会尽快回复!