Skip to content

环境变量与回调地址 ​

环境变量 ​

变量必填说明
DB_URLprod 必填MySQL 连接,需带 nullCatalogMeansCurrent=true,例如 jdbc:mysql://db:3306/lemon_ecom?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&nullCatalogMeansCurrent=true&allowPublicKeyRetrieval=true&useSSL=false
DB_USERNAME / DB_PASSWORDprod 必填数据库账号
REDIS_HOST / REDIS_PORT / REDIS_PASSWORDprod 必填Redis
JWT_SECRETprod 必填登录令牌签名密钥,至少 32 字节(openssl rand -base64 48);同时派生店铺、海外仓、1688 等授权的加密密钥,上线后不要更换
LEMON_ECOM_PUBLIC_URL接入 OAuth 平台或刊登时必填后端外网地址,含 /api,如 https://erp.example.com/api
LEMON_ECOM_DEMO_DATA否true 时首次启动后自动生成演示数据,默认 false
LEMON_TENANT_ENABLED否SaaS 多租户,默认 false
LEMON_DEMO_ENABLED否演示模式(只能查看),默认 false
LEMON_AI_SECRET_KEY否加密 AI API Key 的密钥,为空时使用 JWT_SECRET
LEMON_MINIAPP_APP_ID / LEMON_MINIAPP_APP_SECRET用小程序时微信小程序 AppID / AppSecret
LEMON_MINIAPP_SUBSCRIBE_TEMPLATE_ID否审批提醒的订阅消息模板 ID
JAVA_OPTS否后端 JVM 参数,Docker 默认 -Xms512m -Xmx1g

Docker 部署另有 WEB_PORT、MYSQL_ROOT_PASSWORD、IMAGE_PREFIX、IMAGE_TAG、NPM_REGISTRY,见 docker/.env.example。

外网地址 lemon.ecom.public-url ​

部署在反向代理后面时,后端按请求推算的地址可能是内网地址,以下两处需要外网地址:

  1. OAuth 回调:平台授权后浏览器跳回 {public-url}/ecom/oauth/callback/<平台>;
  2. 刊登图片:系统内的商品图片 /api/files/... 转为 {public-url}/files/... 交给平台下载。

各 OAuth 平台的店铺授权表单中有回调地址的登记说明(连接器的 redirectNote)。Nginx 要把 /api/ 完整代理到后端,并保证这两个路径能从公网访问。

各平台回调地址登记 ​

以 LEMON_ECOM_PUBLIC_URL=https://erp.example.com/api 为例,需要在各平台开发者后台登记的回调地址(Redirect URI):

平台回调地址
eBay回调用 RuName 表示:在 eBay 开发者后台「User Tokens」中把 RuName 的 Your auth accepted URL 设为 https://erp.example.com/api/ecom/oauth/callback/ebay,再把 RuName 填到店铺授权中
虾皮 Shopeehttps://erp.example.com/api/ecom/oauth/callback/shopee(开放平台校验回调域名,需在应用设置中登记后端域名)
Lazadahttps://erp.example.com/api/ecom/oauth/callback/lazada(应用管理中的 Callback URL)
TikTok Shophttps://erp.example.com/api/ecom/oauth/callback/tiktok(Partner Center 应用设置中的 Redirect URL,平台不使用授权链接中的回调地址)
美客多https://erp.example.com/api/ecom/oauth/callback/mercado_libre(必须与应用后台登记的 Redirect URI 完全一致)
Amazon Adshttps://erp.example.com/api/ecom/oauth/callback/amazon-ads(LWA 安全配置文件的 Allowed Return URLs)
1688https://erp.example.com/api/ecom/oauth/callback/alibaba1688

亚马逊 SP-API、速卖通、Shopify、Temu、沃尔玛、Ozon 在店铺上直接填写密钥 / 令牌,不需要回调地址。回调路径中的平台标识是平台枚举的小写,新接入的 OAuth 平台同样按 /ecom/oauth/callback/<平台小写> 登记。

TIP

回调接口不需要登录,靠签名的 state 确定租户与店铺,state 30 分钟内有效;授权页打开后请在 30 分钟内完成授权。

其他第三方的配置位置 ​

第三方配置位置
物流商(4PX、云途)物流管理 → 物流渠道:选择对接的物流商,填写授权、环境
海外仓(谷仓、万邑通、4PX)物流管理 → 海外仓账号:授权、测试环境、自定义地址、自动同步
17TRACK订单管理 → 物流跟踪 → 跟踪设置
大模型智能 → AI 设置
钉钉、企业微信、飞书系统管理 → 第三方集成

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