NaxOne

NaxOne 是面向 PHP 开发者的 Windows 桌面应用,把 Nginx、Apache、MySQL、Redis 与多版本 PHP 收进同一个面板:服务启停、虚拟主机、SSL、配置编辑、站点模板装包都在一个界面里完成。它采用 Rust + Tauri 2 + Vue 3 技术栈,官方给出的指标是安装包约 6MB、冷启动小于 1 秒、内存常驻低于 100MB,默认安装到 D:\NaxOne。

与常见的集成环境不同,NaxOne 不依赖 PHPStudy 也能独立运行;如果机器上已经有 PHPStudy,它会自动识别其 PHP/Nginx/MySQL 包并纳入管理,不需要重装,也不会破坏现有站点。

核心功能

NaxOne 的能力围绕「本地 PHP 站点从建站到上线调试」这条链路展开,覆盖服务、站点、版本、配置和诊断几个层面。

• 服务管理:一键启停全部服务;Nginx 与 Apache 互斥并联动 PHP-CGI;通过端口探测加进程名校验判断状态,避免假阳性。
• 虚拟主机:Nginx 与 Apache 配置双写,自动写入 hosts,一键用 mkcert 签发 HTTPS 证书,浏览器可直接显示绿锁。
• 站点模板:新建 vhost 时可选 WordPress、Laravel、ThinkPHP、Webman 或空白,自动下载或通过 composer 装包。
• PHP 多版本:每个站点可绑定独立 PHP 版本;全局 CLI php 一键切换,Composer、Node、MySQL 同样支持切换。
• 可视化配置:Nginx、MySQL、Redis、PHP 的上百项参数以图形界面编辑,保存前自动生成 .bak 备份。
• 活动日志:所有写操作归档,支持关键字搜索、分类过滤、失败行高亮,并可回查完整 stdout。
• 软件商店:PHP 官方源加 GitHub 镜像双通道,可按需下载历史版本,并提供 SHA-256 校验。
• 端口诊断:自动识别外部占用 80/3306/6379 端口的进程(包括 PHPStudy 的服务),支持一键结束。

界面与体验

官方 README 提供了 13 张界面截图,覆盖仪表板、站点创建、服务配置和软件商店等主要页面。下面按使用顺序说明其中最具代表性的几个界面。

仪表板:服务总览与控制台

仪表板是启动后看到的第一个页面,一行即可启停 Nginx、Apache、MySQL、Redis,多版本 PHP 在这里统一管理,右侧还提供活动日志快览,方便确认每次操作是否生效。

新建站点:基础、伪静态与 SSL 三个标签页

新建站点弹窗把配置拆成基础、伪静态、SSL 三个标签页,内置 Laravel、ThinkPHP、WordPress 等模板可一键装包,并可自动签发 HTTPS 证书,建站流程被压缩成一次表单填写。

服务配置:上百项参数可视化编辑

服务配置页把 Nginx 的 19 项、MySQL 的 25 项、Redis 的 20 项、PHP 的 34 项参数做成图形化表单,不需要手改配置文件,保存前还会做数值范围校验。

软件商店:多版本下载与镜像加速

软件商店集中管理 PHP、Nginx、MySQL 等组件的多版本下载,支持多镜像加速与 SHA-256 校验,历史版本可按需获取。

完整使用流程

NaxOne 的典型使用路径是:安装应用、下载运行环境、创建站点、验证访问。以下步骤均来自官方 README 说明。

1. 确认前置条件:需要 Windows 10 1809+ 或 Windows 11,x64 架构。
2. 下载安装包:国内推荐从 Gitee Releases 下载,海外可从 GitHub Releases 获取,双击安装即可,默认安装目录为 D:\NaxOne。
3. 处理首次启动警告:由于没有购买代码签名证书,Windows SmartScreen 会提示「未识别的应用」。可选三种方式之一:弹窗中点击「更多信息」再点「仍要运行」;右键 exe 打开属性勾选「解除阻止」;或执行 Unblock-File -Path "D:\NaxOne\NaxOne.exe"。仅首次需要。
4. 下载运行环境:在软件商店中选择所需的 PHP、Nginx、Apache、MySQL、Redis 版本下载,下载完成后由 NaxOne 统一纳管。
5. 启动服务:回到仪表板一键启动所需服务;若端口被外部进程占用,先用端口诊断识别并结束占用进程。
6. 创建站点:新建 vhost,填写域名与根目录,选择 WordPress / Laravel / ThinkPHP / Webman 模板或空白站点,按需配置伪静态规则并签发 SSL。
7. 验证结果:浏览器访问站点域名,确认页面正常返回;HTTPS 站点应显示浏览器信任的绿锁;同时可在活动日志中回查本次操作的完整输出。

亮点与差异

NaxOne 的差异点集中在「原生桌面应用的性能表现」和「与既有环境的兼容迁移」两处。

冷启动小于 1 秒、内存常驻低于 100MB、安装包约 6MB,是官方给出的核心性能指标;相比传统集成环境,它把配置编辑和站点管理都做成了可视化界面。

• 与 PHPStudy 共存:自动扫描 PHPStudy 的 Extensions 目录中的 PHP/Nginx/Apache/MySQL/Redis,生成的 vhost 配置格式与 PHPStudy 完全一致,可双向迁移。
• 兼容 PHP 官方包:可直接识别 windows.php.net 下载的 zip 解压目录。
• 配置安全:所有写操作前自动做 .bak 备份。
• 跨电脑迁移:数据全部存放在 %USERPROFILE%\.naxone\,单文件夹拷贝即可迁移。
• 架构清晰:采用六边形架构,naxone-core 为纯领域逻辑,naxone-adapters 实现端口 trait,naxone-tauri 为桌面壳,未来扩展其他平台只需替换适配层。

典型使用场景

NaxOne 主要服务于在 Windows 上做 PHP 开发的个人与团队,以下场景较为典型。

• 多项目并行开发:为每个站点绑定不同的 PHP 版本,避免升级一个项目影响另一个项目。
• 从 PHPStudy 迁移:已有 PHPStudy 环境时无需重装,由 NaxOne 接管现有包并沿用既有站点配置。
• 本地 HTTPS 调试:用 mkcert 一键签发受信任证书,便于调试依赖 HTTPS 的接口、Cookie 或支付回调。
• 框架快速起步:通过 WordPress、Laravel、ThinkPHP、Webman 模板一键装包,省去手工拉取依赖。
• 环境排障:端口被占用或服务起不来时,用端口诊断和活动日志定位问题。

定价

NaxOne 以 MIT 许可证开源,本身不收取费用。被管理的 PHP、Nginx、Apache、MySQL、Redis 二进制各自遵循其原有许可证(PHP License、BSD、Apache 2.0、GPL、BSD),NaxOne 只作为本地启停与配置工具,不重新分发这些二进制。

方案	价格	适合谁
开源版(MIT)	免费	所有在 Windows 上做 PHP 本地开发的个人与团队

版本与维护状态

当前官方资料显示的版本为 0.5.27,许可证为 MIT,版权标注为 2026 NaxOne Contributors。项目同时维护 Gitee 与 GitHub 两个仓库,并在 README 中提供 release、下载量、star 数等徽章,说明处于持续迭代阶段。

项目内置 Tauri auto-updater,会检查新版本,新版本通过签名验证后完成升级。

局限与注意

使用前需要了解以下限制与风险。

• 仅支持 Windows:官方明确要求 Windows 10 1809+ / Windows 11 且为 x64,没有 macOS 或 Linux 版本。
• 无代码签名:安装包未购买代码签名证书,首次运行会触发 SmartScreen 警告,需手动放行。
• 版本号仍为 0.x:处于早期版本阶段,接口与行为可能随迭代调整。
• 依赖外部组件:PHP、数据库等运行环境需自行在软件商店下载,首次使用需要额外下载时间。
• PHP 扩展依赖 PIE:扩展的一键装/卸基于 PIE,并要求 PHP 8.1+ 作为 runtime。

常见问题

以下问题整理自官方 README 已明确说明的内容。

• 首次运行弹出 Windows SmartScreen 警告怎么办? 这是缺少代码签名导致,可在弹窗点「更多信息」→「仍要运行」,或右键 exe 属性勾选「解除阻止」,或执行 Unblock-File -Path "D:\NaxOne\NaxOne.exe",仅首次需要。
• 会和已有的 PHPStudy 冲突吗? 不会。NaxOne 不依赖 PHPStudy,可独立使用;检测到 PHPStudy 时会自动识别其 PHP/Nginx/MySQL 包并纳入管理,生成的 vhost 配置格式与 PHPStudy 一致,可双向迁移。
• 换电脑后如何迁移? 数据全部位于 %USERPROFILE%\.naxone\,拷贝该文件夹即可。
• 配置改错了怎么恢复? 所有写操作前会自动生成 .bak 备份,可据此回退。
• 有没有视频或 GIF 演示? 官方仓库目前只提供静态截图,没有 GIF 或视频演示,页面中的截图轮播即为官方真实截图。

产品主页与下载

NaxOne 没有独立官网,以官方仓库作为产品主页,下载与问题反馈均通过仓库进行。

• 产品主页(Gitee):https://gitee.com/kz_y/naxone
• GitHub 仓库:https://github.com/OverfireWater/naxone
• 国内下载(Gitee Releases):https://gitee.com/kz_y/naxone/releases/latest
• 海外下载(GitHub Releases):https://github.com/OverfireWater/naxone/releases/latest
• 问题反馈:https://gitee.com/kz_y/naxone/issues

从源码构建

需要 Rust 1.75 及以上与 Node.js 20 及以上。

# 安装前端依赖
cd crates/naxone-tauri/frontend && npm install && cd ..

# 开发模式(Vite + Rust + Tauri 一条龙)
cargo tauri dev

# 打包 NSIS 安装包(输出在 target/release/bundle/nsis/)
cargo tauri build

# 运行测试
cargo test --workspace