部署文档

本文档描述 LYShop 的常见部署方式。

环境要求

• Node.js 18+
• Go 1.21+
• SQLite（默认）或 MySQL 8+
• Redis（可选，按插件能力使用）

本地开发部署

后端服务

cd server
cp ../config.example.yaml ../config.yaml
go mod tidy
go run main.go -config ../config.yaml

config.example.yaml 默认使用 SQLite：

database:
  dsn: "lyshop.db"

如需改为 MySQL，只需将 database.dsn 替换为 MySQL 连接串。

redis.addr 留空时，后端会自动启用进程内嵌 Redis，适合个人单机运行。

管理后台

cd admin
npm install
npm run dev

移动端 H5

cd app
npm install
npm run dev:h5

商家移动端 eapp

cd eapp
npm install --legacy-peer-deps
npm run dev:h5

文档站

cd docs-site
npm install
npm run docs:dev

单机内嵌部署（个人用户推荐）

该模式会把 web/admin/app(H5) 构建产物嵌入后端二进制，并提供 Windows GUI 启动器。

pwsh -File scripts/build-standalone.ps1

产物目录：dist/

• lyshop.exe：命令行后端
• lyshop-gui.exe：Windows 无控制台 GUI 启动器

内嵌模式路由：

• 商城：/
• 管理后台：/admin/（接口仍为 /admin/api/*）
• H5：/h5/

生产构建

管理后台

cd admin
npm run build

商家移动端 eapp（H5）

cd eapp
npm run build:h5

若需要构建微信小程序：

cd eapp
npm run build:mp-weixin

文档站

cd docs-site
npm run docs:build

生成目录为 docs-site/docs/.vitepress/dist，可作为静态站点发布。

若部署到 GitHub Pages 项目页（例如 https://ijry.github.io/lyshop/），需在 docs-site/docs/.vitepress/config.mts 中配置：

base: "/lyshop/"

Nginx 托管示例

server {
  listen 80;
  server_name docs.example.com;

  root /var/www/lyshop-docs;
  index index.html;

  location / {
    try_files $uri $uri/ /index.html;
  }
}

Docker Compose

根目录 docker-compose.yml 可用于整体容器化部署。建议在生产环境补充：

• 环境变量与密钥管理
• 数据卷持久化
• 反向代理与 HTTPS
• 若使用 MySQL 容器，请在 config.yaml 中将 database.dsn 设置为 MySQL 连接串（例如 root:password@tcp(mysql:3306)/lyshop?...）。

eapp 部署影响

• 后端无新增配置项，继续复用现有 /admin/api/*。
• Nginx 需新增 eapp H5 静态目录映射（如 /eapp/）。
• 微信小程序与 App 仍按 uni-app 常规流程在对应平台发布，不依赖额外后端开关。