Docker 部署
docker/ 目录提供后端、前端(Nginx)镜像的 Dockerfile 和 docker-compose.yml(MySQL + Redis + 后端 + 前端)。需要 Docker 20.10+ 与 Compose v2。
从源码构建并启动
cd docker
cp .env.example .env # 修改其中的密码和 JWT_SECRET
docker compose up -d --build启动完成后访问 http://服务器地址(端口为 .env 中的 WEB_PORT,默认 80),默认账号 admin / admin123。
- 数据库
lemon_ecom在 MySQL 容器第一次启动时由sql/init.sql初始化;数据卷保留后再次启动不会重复初始化。 - 上传文件、附件、面单保存在数据卷
lemon-files中。 - 前端镜像中的 Nginx 托管静态文件并把
/api代理到后端。
使用发布的镜像
每个 Release 会把镜像推送到 GitHub Packages(linux/amd64、linux/arm64),并上传 Docker 部署包 lemon-ecom-docker-<版本>.zip(docker-compose.yml 已去掉构建配置,.env.example 已指向 ghcr.io/makesomefakenews/lemon-ecom 和对应版本):
unzip lemon-ecom-docker-1.0.0.zip && cd lemon-ecom-docker-1.0.0/docker
cp .env.example .env # 修改密码和 JWT_SECRET
docker compose up -d镜像:ghcr.io/makesomefakenews/lemon-ecom-backend、ghcr.io/makesomefakenews/lemon-ecom-web。
生成演示数据
在 .env 中设置:
LEMON_ECOM_DEMO_DATA=true后端首次启动完成后自动生成一个跨境卖家的完整业务数据(约 1–2 分钟),已生成过则跳过。正式使用的环境保持 false。
配置平台回调
接入 OAuth 平台(eBay、虾皮、Lazada、TikTok Shop、美客多、Amazon Ads、1688)时需要后端的外网地址。docker-compose.yml 的后端服务目前没有传入 LEMON_ECOM_PUBLIC_URL,需要时在 backend.environment 中加一行:
LEMON_ECOM_PUBLIC_URL: ${LEMON_ECOM_PUBLIC_URL:-}再在 .env 中设置 LEMON_ECOM_PUBLIC_URL=https://erp.example.com/api,详见 环境变量与回调地址。
构建与推送镜像
./docker/build.sh # 构建 lemon-ecom-backend:latest、lemon-ecom-web:latest
./docker/build.sh -t 1.0.0 # 指定标签
./docker/build.sh -p registry.example.com/lemon/lemon-ecom -t 1.0.0 --push
./docker/build.sh --npm-registry https://registry.npmmirror.com
./docker/build.sh --platform linux/amd64 # 在 Apple 芯片上构建给 x86 服务器的镜像常用命令
docker compose ps # 查看状态
docker compose logs -f backend # 后端日志
docker compose restart backend # 修改 .env 后重启后端
docker compose down # 停止(保留数据卷)注意
docker compose down -v 会删除数据卷,数据库和上传文件都会丢失。