> 本文整理自平台文档 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_PORT | 80 | 开发服务器端口 |
VITE_APP_CONTEXT_PATH | / | 部署子路径;部署在 /admin/ 时改成 /admin/ |
VITE_APP_TITLE | 无界创镜系统 | 浏览器标题 |
VITE_APP_DOC_URL | https://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 是否存在 |
| 页面白屏且控制台报双 Vue | index.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)


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