快速开始

这一页只做一件事：把 wujies-admin 在本地跑起来，并确认它连的是本机 8086 的后端。

环境要求

工具	版本	说明
Node.js	`>= 18.18.0`	与 `package.json` 的 `engines` 一致
npm	`>= 8.9.0`	也可以用 pnpm，但仓库脚本按 npm 写
后端	已启动	默认 `http://127.0.0.1:8086`

安装依赖

cd plus-ui
npm install

如果遇到 peer dependency 报错，再加 --legacy-peer-deps；不要随意升级 Vue / Element Plus 大版本。

启动

npm run dev

predev 会先执行 npm run gen:runtime，生成 app-market-dist/app-runtime/ 下的运行时垫片；然后 Vite 启动，默认打开 http://localhost:80。

80 端口在 Windows 上通常需要管理员权限。如果起不来，改 .env.development 的 VITE_APP_PORT 即可，不必改代码。

关键环境变量

配置文件：.env.development

变量	默认值	作用
`VITE_APP_BASE_API`	`/dev-api`	前端请求前缀，Vite 代理会去掉它再转发
`VITE_APP_PORT`	`80`	开发服务器端口
`VITE_APP_CONTEXT_PATH`	`/`	部署子路径；部署在 `/admin/` 时改成 `/admin/`
`VITE_APP_TITLE`	`无界创镜系统`	浏览器标题
`VITE_APP_DOC_URL`	`https://docs.wujies.cn`	文档站地址
`VITE_APP_MARKET_EDITION`	未设置	市场形态兜底；正常应问后端 `GET /app/edition`

代理目标写在 vite.config.ts：

proxy: {
  '/dev-api': {
    target: 'http://127.0.0.1:8086',
    changeOrigin: true,
    ws: true,
    rewrite: (path) => path.replace(/^\/dev-api/, ''),
  },
}

验收

打开 http://localhost:80，能看到登录页；
登录后进入工作台，左侧出现「应用市场 / 我的应用」等菜单；
打开「应用市场」，能看到应用卡片（说明后端接口通了）；
浏览器控制台没有 [app-market] 的红色报错。

生产构建

npm run build:prod

产物在 dist/。构建插件 appMarketStatic 会把 app-market-dist/ 一起复制进 dist/，所以远程应用产物目录不需要单独部署——它跟着宿主静态站走。

构建后建议再跑两个校验：

npm run check:runtime   # 运行时垫片与生成器是否一致
npm run check:globals   # AutoImport 清单是否与宿主一致

常见问题

现象	先查
登录页出来了，验证码不显示	后端是否启动、`/dev-api` 代理是否指向 `8086`
应用市场 404	后端是否装了应用市场模块、是否有 `app:market:list` 权限
点应用菜单提示「远程视图不可用」	应用是否安装、`app-market-dist/remote-apps/<code>/index.js` 是否存在
页面白屏且控制台报双 Vue	`index.html` 的 import map 与运行时垫片是否被改过

更多排查见远程应用接入与故障排查。

环境要求复制标题链接

安装依赖复制标题链接

启动复制标题链接

关键环境变量复制标题链接

验收复制标题链接

生产构建复制标题链接

常见问题复制标题链接

目录

环境要求

安装依赖

启动

关键环境变量

验收

生产构建

常见问题