买成品源码最怕两件事：源码到手不会装，和装完找不到人。所以这一页把我们交付文档里 「从压缩包到线上可访问」的完整步骤原样公开——你不用先付款就能看到自己要做几件事、 我们替你做到哪一步。以下命令取自实际交付的 Docker Compose 部署包，域名、密钥、密码一律用占位符。
| 服务器 | 1 台云服务器，建议 2 核 4G 起（日活几千的轻量业务 2 核 2G 也能跑），Ubuntu 22.04 / 20.04 或 CentOS 7+；系统盘留 20G 以上。 |
|---|---|
| 域名与备案 | 1 个已完成 ICP 备案的域名，A 记录解析到服务器公网 IP；小程序端还要求域名是 HTTPS 且备案主体与你的小程序主体一致。 |
| 证书 | SSL 证书（含部署版代为申请与配置，可先用平台免费证书）。 |
| 账号 | 微信小程序 AppID + AppSecret（用你自己的主体注册）、微信支付商户号（可选，没有先用扫码收款兜底）、大模型 API Key（可自备）。 |
curl -fsSL https://get.docker.com | sh systemctl enable --now docker docker compose version # 看到版本号即可
mkdir -p /opt/app && cd /opt/app unzip wenshu88-<系统名>.zip -d <系统名>/ cd <系统名>/
包内结构固定为：backend/（后端源码）、web/ 或 h5/（前端）、
admin/（管理后台）、sql/（建表脚本 + 版本升级脚本）、
docker-compose.yml、.env.example、nginx/、DEPLOY.md。
把 .env.example 复制成 .env 后按需修改。交付包里这份清单是逐项注释过的，
常见必改项只有这几类（示例键名，不含任何真实值）：
cp .env.example .env # 数据库与访问 DB_HOST= DB_PASSWORD= APP_PORT= CORS_ORIGINS=https://你的域名 # 微信与支付 WX_APPID= WX_SECRET= WXPAY_MCHID= WXPAY_KEY= # 大模型与告警 LLM_API_KEY= LLM_BASE_URL= ALERT_ENABLED=true ALERT_DINGTALK_WEBHOOK=
其中 ADMIN_TOKEN、ADMIN_OPERATE_PASSWORD 这类后台口令，
交付时是空值或占位值，必须由你在首次部署时改成自己的——我们不留后门，你也别沿用示例值。
docker compose up -d mysql redis backend docker compose logs --tail=50 backend # 看到 uvicorn running 即成功
Compose 里已经把 mysql:8.0、redis:7-alpine 和后端容器用内网串好，
后端只在容器内监听端口，公网访问统一走 Nginx 反代。
docker exec -i <系统名>-mysql-1 mysql -uroot -p"$MYSQL_ROOT_PASSWORD" <系统库名> < sql/init.sql # 老库升级：按文件名里的版本号从小到大依次执行 for f in sql/upgrade_v*.sql; do echo "$f"; done
升级脚本是不可重复执行的（含 ALTER TABLE），所以文档里每一步都写了
"先备份再执行"，并给了一条 mysqldump 备份命令。交付包里通常带十几个这样的脚本，
对应这套系统一路加过的模块（会员、分销、合婚、题库等），你可以据此判断它的迭代深度。
server {
listen 443 ssl;
server_name 你的域名;
ssl_certificate /etc/nginx/ssl/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/privkey.pem;
location /api/ { proxy_pass http://127.0.0.1:8000; }
location / { root /opt/app/web/dist; try_files $uri /index.html; }
}
交付包里带的 nginx/ 目录就是这份配置的可用版本，改三处即可：域名、证书路径、前端目录。
cd web && npm ci && npm run build # 纯静态版本直接上传目录即可，不需要构建
小程序端在「开发管理 → 服务器域名」里把 request / uploadFile / downloadFile 三个白名单填成你的域名， 必须 HTTPS 且已备案。这一步只能你自己在小程序后台做，因为账号在你名下。
| ① 首页与核心流程能在手机上走完（下单 → 支付 → 出结果） |
| ② 管理后台能登录，且已改掉默认口令 |
③ 数据库已导入且 SELECT COUNT(*) 有基础数据 |
| ④ HTTPS 无证书报错，HTTP 已跳转 HTTPS |
| ⑤ 支付回调地址、大模型 Key、告警通道三项已换成你自己的 |
| ⑥ 备份计划：数据库每日一次、保留 7 天（文档里给了 cron 写法） |