环境变量与回调地址
环境变量
| 变量 | 必填 | 说明 |
|---|---|---|
DB_URL | prod 必填 | 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_PASSWORD | prod 必填 | 数据库账号 |
REDIS_HOST / REDIS_PORT / REDIS_PASSWORD | prod 必填 | Redis |
JWT_SECRET | prod 必填 | 登录令牌签名密钥,至少 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
部署在反向代理后面时,后端按请求推算的地址可能是内网地址,以下两处需要外网地址:
- OAuth 回调:平台授权后浏览器跳回
{public-url}/ecom/oauth/callback/<平台>; - 刊登图片:系统内的商品图片
/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 填到店铺授权中 |
| 虾皮 Shopee | https://erp.example.com/api/ecom/oauth/callback/shopee(开放平台校验回调域名,需在应用设置中登记后端域名) |
| Lazada | https://erp.example.com/api/ecom/oauth/callback/lazada(应用管理中的 Callback URL) |
| TikTok Shop | https://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 Ads | https://erp.example.com/api/ecom/oauth/callback/amazon-ads(LWA 安全配置文件的 Allowed Return URLs) |
| 1688 | https://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 设置 |
| 钉钉、企业微信、飞书 | 系统管理 → 第三方集成 |