中国 帮助

快速开始

环境要求 工具 版本 Node.js = 18.18.0 npm = 8.9.0 后端 已启动,默认 http://127.0.0.1:8086 安装与启动 bash cd wujiesweb n

快速开始
封面

> 本文整理自平台文档 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-apihttps://api.wujies.cn/接口前缀
VITE_APP_PORT4230—开发端口
VITE_APP_CONTEXT_PATH//部署子路径
VITE_APP_TITLE无界创镜系统同左页面标题
VITE_APP_ENCRYPTfalsefalse接口加密开关,必须与后端一致
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_SSEtruetrue实时通道开关,关掉则不建立连接

> 生产环境如果走同域反向代理,把 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)

章节导览
THE END

喜欢就支持以下吧

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

回到内容