Vue 项目开发系统
VPDS 是一个基于 Vue.js 的全流程,前端研发系统,包括项目的初始化,构建脚本,项目发布等前端开发流程,而且 VPDS 利用私有的 NPM 仓库实现了一套模块管理平台,使得项目的开发,从面向页面到面向模块的的转变。
- 安装 Node.js 22.15 以上和 npm 10 以上(本次验证使用 Node.js 24.22.1)
git clone https://github.com/aOrz/vpds.gitcd vpdsnpm ci安装服务依赖,再执行npm --prefix server/src/app ci安装管理界面依赖(两层 npm 锁文件均包含在源码中;不再使用旧 Yarn 锁)- 将
sql文件夹下的 sql 导入数据库 cp config/index.demo.js config/index.js修改 config/index.js,配置七牛云 ak,sk,bucketName,url等,以及配置数据库。- 安装 Sinopia npm 私有仓库,或者直接使用 npmjs.org,在命令行中登陆 npm 账号
npm run build:ui构建管理界面(生成server/src/app/dist),然后npm start启动。- 修改服务代码可用
npm run dev;运行npm test会先重新构建管理界面,再执行不依赖真实数据库/云服务的完整回归测试。 npm run audit检查两层完整依赖;npm run audit:production检查生产依赖。- 管理界面热更新:保持后端运行,执行
npm run dev:ui后访问http://127.0.0.1:8010。
当前管理界面、共享构建工具及四种模板已升级为 Vue 3.5.44 / Webpack 5.112.2,UI 使用 Element Plus 2.14.7。这是一次不向后兼容的主版本迁移;现有 Vue 2 项目不能不经修改直接使用新工具链。详见 升级说明。后续已将两层 npm 审计告警清零(含生产与开发依赖),详见 依赖审计修复。审计为零不等于全面生产安全认证,本工具仍不应作为多用户线上服务。
服务默认仅监听 127.0.0.1:3000。此工具可执行依赖安装、构建及发布,且没有用户认证;不要将它直接暴露到公网。VPDS_HOST 仅允许 127.0.0.1、::1 或 localhost,不支持远程访问。服务会拒绝不受信任的 Host 和跨源 API 请求;这不能替代本机操作系统的访问控制。不要提交 config/index.js 中的数据库和七牛凭据。
安装、复制、创建、发布、构建和启动开发服务的 API 请求必须携带 X-VPDS-Request: 1;前端会自动添加。命令行脚本也需显式设置该请求头,例如 curl -H 'X-VPDS-Request: 1' http://localhost:3000/api/page/build/example。服务不提供 CORS 支持,请勿添加允许跨源请求的代理配置;自定义请求头用于防止其他网站通过浏览器触发本机操作,不是用户身份认证。
| 打赏 | 加小助手进微信群 |
|---|---|
![]() |
![]() |

