中国 帮助

快速开始

这一页只做一件事:把 wujiesadmin 在本地跑起来,并确认它连的是本机 8086 的后端。 环境要求 工具 版本 说明 Node.js = 18.18.0 与 package.json 的 engi

快速开始
封面

> 本文整理自平台文档 docs/wujies/5.x/frontends/admin/quickstart.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-26c9c383d383-cover.svg)

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

环境要求

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

安装依赖

cd wujies-admin
npm install

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

启动

npm run dev

Vite 启动时会先生成 app-market-dist/app-runtime/ 下的运行时垫片(appMarketStatic 插件的 configResolved),不需要任何前置脚本;默认打开 http://localhost:80。

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

关键环境变量

配置文件:.env.development

变量默认值作用
VITE_APP_BASE_API/dev-api前端请求前缀,Vite 代理会去掉它再转发
VITE_APP_PORT80开发服务器端口
VITE_APP_CONTEXT_PATH/部署子路径;部署在 /admin/ 时改成 /admin/
VITE_APP_TITLE无界创镜系统浏览器标题
VITE_APP_DOC_URLhttps://docs.wujies.cn文档站地址

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

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

验收

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

src="/images/docs/admin-login.png" caption="后台登录页(截图占位)" hint="建议 1920 × 1080,截登录表单与图形验证码。" />

生产构建

npm run build:prod

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

构建后建议再跑一次校验:

npm run tools:check   # 生成垫片 + 垫片对账 + 产物组件解析 + AutoImport 清单

常见问题

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

更多排查见 [远程应用接入](/docs/wujies/5.x/frontends/admin/remote-app) 与 [故障排查](/docs/wujies/5.x/deploy/ops/troubleshooting)。

本文导览

(https://console.wujies.cn/remote-apps/cms-assets/doc-26c9c383d383-guide.svg)

章节导览
THE END

喜欢就支持以下吧

评论区需要浏览器启用 JavaScript 才能加载。

回到内容