Skip to content

Docker 部署 ​

docker/ 目录提供后端、前端(Nginx)镜像的 Dockerfile 和 docker-compose.yml(MySQL + Redis + 后端 + 前端)。需要 Docker 20.10+ 与 Compose v2。

从源码构建并启动 ​

bash
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 和对应版本):

bash
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 中加一行:

yaml
      LEMON_ECOM_PUBLIC_URL: ${LEMON_ECOM_PUBLIC_URL:-}

再在 .env 中设置 LEMON_ECOM_PUBLIC_URL=https://erp.example.com/api,详见 环境变量与回调地址。

构建与推送镜像 ​

bash
./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 服务器的镜像

常用命令 ​

bash
docker compose ps                    # 查看状态
docker compose logs -f backend       # 后端日志
docker compose restart backend       # 修改 .env 后重启后端
docker compose down                  # 停止(保留数据卷)

注意

docker compose down -v 会删除数据卷,数据库和上传文件都会丢失。

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