mall4cloud-pc生产环境搭建
S2B2C 白洞版 · mall4cloud-pc生产环境搭建
统一接口域名
Section titled “统一接口域名”示例值注意事项:本文中的 IP、域名、账号、密码等仅为示例,请按你的实际环境替换。
- 适用于二开技术团队在对应模块下的开发、调试或配置工作。
- 已拉取对应项目源码并具备基础运行环境。
- 已根据实际环境替换文中的示例配置值。
mall4cloud-pc:pc代表pc端
安装nodejs
Section titled “安装nodejs”项目要求 20.19+ || 22.12+,推荐使用 LTS 版本
如果不了解怎么安装nodejs的,可以参考
2.安装依赖启动项目
Section titled “2.安装依赖启动项目”项目要求使用 包管理工具,版本要求:>=8 <11
使用编辑器打开项目,在根目录执行以下命令安装依赖
pnpm install如果不想使用 pnpm,请删除 package.json 文件中 pnpm 相关内容后再进行安装
{ "scripts" : { "preinstall": "npx only-allow pnpm" // 删除此行 }, "engines": { "pnpm": ">=8 <11" // 删除此行 }, "pnpm": { // 删除此项 ... }}3.修改配置文件
Section titled “3.修改配置文件”修改根目录下的.env.production
- 以下域名,接口为示例,请结合申请的域名,接口进行修改
# 统一接口域名VITE_APP_BASE_API = 'https://cloud-api.mall4j.com'
# 客服websocket接口请求地址,https对应wss,http对应wsVITE_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
-
路由配置 router/index.js
const router = createRouter({// createWebHistory 传入字符串参数目录配置:/目录名/history: createWebHistory('/pc/'),}) -
项目配置 vite.config.js
export default defineConfig({// 添加此项配置base: '/pc/',}) -
nginx 配置
location /pc {try_files $uri $uri/ /pc/;}
4.打包,上传到服务器
Section titled “4.打包,上传到服务器”-
使用
npm run build命令对项目进行打包 -
将步骤1中生成的文件夹,压缩
-
将压缩包上传到服务器指定位置,解压
5. nginx配置
Section titled “5. nginx配置”nginx配置可以参考
location / { try_files $uri $uri/}- 根据文中步骤完成后,确认对应功能可访问或服务可正常启动。
- 可先查看故障排查索引:
../../04-故障排查/README.md
- 当前目录索引:
README.md