Skip to content

生产部署 ​

打包运行 ​

bash
./gradlew build                     # 生成 lemon-admin/build/libs/lemon-ecom.jar
cd lemon-web && npm ci && npm run build   # 生成 lemon-web/dist,交给 Nginx 托管
bash
# 生产环境配置全部取环境变量(application-prod.yml 没有默认值)
export DB_URL=... DB_USERNAME=... DB_PASSWORD=... REDIS_HOST=... REDIS_PASSWORD=...
export JWT_SECRET=$(openssl rand -base64 48)      # 只生成一次并妥善保存
export LEMON_ECOM_PUBLIC_URL=https://erp.example.com/api
java -jar lemon-ecom.jar --spring.profiles.active=prod

也可以直接下载 Release 中的 lemon-ecom-<版本>.jar、lemon-web-<版本>.zip 和 init.sql。

MySQL 与 Redis ​

  • MySQL 8.0+,字符集 utf8mb4:
bash
mysql -uroot -p -e "CREATE DATABASE lemon_ecom DEFAULT CHARSET utf8mb4"
mysql -uroot -p lemon_ecom < sql/init.sql      # 会删除并重建全部表,只在新库执行
  • Flowable 的 ACT_* 表由后端启动时自动创建;DB_URL 必须带 nullCatalogMeansCurrent=true。
  • Redis 6.2+,用于会话、权限、字典、业务参数等缓存。多实例部署必须用 Redis(lemon.cache.type: redis)。
  • 演示数据的生成进度保存在内存中,多实例时只在一个实例上触发。

Nginx ​

nginx
server {
    listen 443 ssl;
    server_name erp.example.com;

    location / {
        root /path/to/lemon-web/dist;
        try_files $uri $uri/ /index.html;
    }
    # AI 问数的流式回答需要关闭缓冲
    location /api/ai/ {
        proxy_pass http://127.0.0.1:8080;
        proxy_buffering off;
        proxy_read_timeout 300s;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
    location /api/ {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        client_max_body_size 50m;     # 导入结算报告、上传图片
    }
}
  • 后端开启了 server.forward-headers-strategy: native,只信任内网代理传来的 X-Forwarded-For;代理不在内网时用 server.tomcat.remoteip.internal-proxies 配置。
  • OAuth 回调(/api/ecom/oauth/callback/)和商品图片(/api/files/)需要能从公网访问。

文件与备份 ​

内容位置备份
数据库MySQL lemon_ecom每天 mysqldump,含 ACT_* 表
商品图片、头像lemon.upload.path(默认 ./uploads)与数据库一起备份
附件、面单lemon.upload.attachment-path(默认 ./attachments)与数据库一起备份
JWT_SECRET环境变量丢失后所有授权需要重新填写

上线检查清单 ​

  • JWT_SECRET 已设置为随机强密钥并妥善保存;数据库、Redis 使用强密码且不对公网开放。
  • 修改了 admin、test 的默认密码(或停用 test);在「参数设置」中开启登录验证码和密码策略。
  • LEMON_ECOM_DEMO_DATA=false,正式库中没有 DEMO- 开头的演示店铺。
  • 配置了 LEMON_ECOM_PUBLIC_URL,各 OAuth 平台登记了回调地址,后端可以访问外网。
  • 在「财务管理 → 币种汇率」中维护了店铺结算币种的月汇率(没有汇率时订单无法折算本位币)。
  • 在「系统监控 → 定时任务」中确认订单同步、库存回传等任务已启用,Cron 符合需要。
  • 正式接入的平台、海外仓、物流商已用真实账号联调。

面向跨境电商卖家的开源 ERP · 基于 GPL-3.0 协议
联系我们:电话 17701123202 · 微信 BG7LIF · 邮箱 zmissu@163.com