> 本文整理自平台文档 docs/wujies/5.x/frontends/pc/quickstart.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-bb151d9f3ba6-cover.svg)
环境要求
| 工具 | 版本 |
|---|---|
| Node.js | >= 18.18.0 |
| npm | >= 8.9.0 |
| 后端 | 已启动,默认 http://127.0.0.1:8086 |
安装与启动
cd wujies-web
npm install
npm run dev
默认访问 http://localhost:4230。开发代理同样把 /dev-api 转发到 127.0.0.1:8086:
proxy: {
[env.VITE_APP_BASE_API]: { // 开发态即 /dev-api
target: 'http://127.0.0.1:8086',
changeOrigin: true,
ws: true,
rewrite: (path) => path.replace(new RegExp('^' + env.VITE_APP_BASE_API), ''),
},
}
环境变量
文件:.env.development / .env.production
| 变量 | 开发默认 | 生产示例 | 说明 |
|---|---|---|---|
VITE_APP_BASE_API | /dev-api | https://api.wujies.cn/ | 接口前缀 |
VITE_APP_PORT | 4230 | — | 开发端口 |
VITE_APP_CONTEXT_PATH | / | / | 部署子路径 |
VITE_APP_TITLE | 无界创镜系统 | 同左 | 页面标题 |
VITE_APP_ENCRYPT | false | false | 接口加密开关,必须与后端一致 |
VITE_APP_CLIENT_ID | 与后台端同一份 | 同左 | 登录时随 /auth/login 提交的客户端标识,要能对上后端 sys_client 里 pc 那行 |
VITE_APP_RSA_PUBLIC_KEY / VITE_APP_RSA_PRIVATE_KEY | 已配 | 同左 | 仅在 VITE_APP_ENCRYPT=true 时参与加解密,取值与后端保持一致 |
VITE_APP_WEBSOCKET / VITE_APP_SSE | true | true | 实时通道开关,关掉则不建立连接 |
> 生产环境如果走同域反向代理,把 VITE_APP_BASE_API 改回 /prod-api,由 Nginx 转发;直接写后端域名时要确认 CORS 已放开。
验收
1. http://localhost:4230 首页能打开,商品 / 内容区有数据; 2. 开发态里 /site/ 由 vite.config.ts 代理到 127.0.0.1:8086(键写的是正则 ^/site([/?]|$),改成 '/site' 会把多入口改写后的 /sites/... 入口一起转走,整栈变 404); 3. 登录后进入会员中心——会员中心页面在 wujies-admin(/member/),不在这一侧; 4. 打开浏览器 Network,/open/ 或 /portal/ 返回 200; 5. 如果返回 404,先去「我的应用」确认对应应用已安装(见 [C 端接口与应用](/docs/wujies/5.x/frontends/pc/open-api))。
src="/images/docs/pc-login.png" caption="PC 用户端登录页(截图占位)" hint="建议 1920 × 1080。" />
生产构建
npm run build:prod
产物在 dist/(含 gzip 资源),是一次构建出多个入口:dist/index.html 与 dist/sites/mall/index.html 共用同一个 dist/assets/。把整个目录交给 Nginx 即可,SPA 路由需要 fallback:
location /mall {
try_files $uri /sites/mall/index.html;
}
location / {
try_files $uri $uri/ /index.html;
}
前缀站点那条要排在 location / 前面,否则 /mall/xxx 会被根入口吃掉,页面空白或 404。npm run preview 验不了这段(vite preview 不带这条 try_files)。
/site/** 不在静态产物里 —— 那一段要交给后端直出,Nginx 上单独一条 location /site 反代到应用服务,与 SPA 同域共存。
构建前确认 .env.production 的 VITE_APP_BASE_API 指向正确后端;构建后再改就得重新打包。
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-bb151d9f3ba6-guide.svg)


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