跳转到内容

mall4cloud-pc生产环境搭建

S2B2C 白洞版 · mall4cloud-pc生产环境搭建

示例值注意事项:本文中的 IP、域名、账号、密码等仅为示例,请按你的实际环境替换。

  • 适用于二开技术团队在对应模块下的开发、调试或配置工作。
  • 已拉取对应项目源码并具备基础运行环境。
  • 已根据实际环境替换文中的示例配置值。

mall4cloud-pc:pc代表pc端

项目要求 20.19+ || 22.12+,推荐使用 LTS 版本

如果不了解怎么安装nodejs的,可以参考

项目要求使用 包管理工具,版本要求:>=8 <11

使用编辑器打开项目,在根目录执行以下命令安装依赖

pnpm install

如果不想使用 pnpm,请删除 package.json 文件中 pnpm 相关内容后再进行安装

{
"scripts" : {
"preinstall": "npx only-allow pnpm" // 删除此行
},
"engines": {
"pnpm": ">=8 <11" // 删除此行
},
"pnpm": { // 删除此项
...
}
}

修改根目录下的.env.production

  • 以下域名,接口为示例,请结合申请的域名,接口进行修改
Terminal window
# 统一接口域名
VITE_APP_BASE_API = 'https://cloud-api.mall4j.com'
# 客服websocket接口请求地址,https对应wss,http对应ws
VITE_APP_WEBSOCKET_URL = 'wss://cloud-im.mall4j.com'
# 移动端域名地址配置 - 用于生成二维码跳转链接
VITE_APP_H5_DOMAIN = 'https://h5.mall4j.com/cloud'
# 图片域名
VITE_APP_RESOURCES_URL = 'https://mall4j-minio-test.mall4j.com/mall4cloud'
# 商家端后台地址
VITE_APP_MERCHANT_PLATFORM_URL = 'https://cloud-multishop.mall4j.com'
#供应商端后台地址
VITE_APP_SUPPLIER_PLATFORM_URL = 'https://cloud-supplier.mall4j.com'

如需部署在二级目录下,需要修改以下配置

Section titled “如需部署在二级目录下,需要修改以下配置”

假设部署在 pc 目录,即访问的地址为 https://xxxx.xxx/admin

  1. 路由配置 router/index.js

    const router = createRouter({
    // createWebHistory 传入字符串参数目录配置:/目录名/
    history: createWebHistory('/pc/'),
    })
  2. 项目配置 vite.config.js

    export default defineConfig({
    // 添加此项配置
    base: '/pc/',
    })
  3. nginx 配置

    location /pc {
    try_files $uri $uri/ /pc/;
    }
  1. 使用 npm run build 命令对项目进行打包

  2. 将步骤1中生成的文件夹,压缩

  3. 将压缩包上传到服务器指定位置,解压

nginx配置可以参考

location / {
try_files $uri $uri/
}
  • 根据文中步骤完成后,确认对应功能可访问或服务可正常启动。
  • 可先查看故障排查索引:../../04-故障排查/README.md
  • 当前目录索引:README.md