宿链云
文档

装之前先看这六页

买软件最怕的是「买了装不上」。所以把最容易卡住的几步先写出来，你可以在下单前就判断出自己装不装得了。

从环境要求开始先看演示

环境要求 约 3 分钟

装之前先确认这台机器够不够用，别装到一半才发现内存不够。

  1. 操作系统：Ubuntu 22.04 / Debian 12 / CentOS Stream 9（64 位）
  2. 基础软件：Docker 24+ 与 Docker Compose v2（1Panel、宝塔均可）
  3. 小程序商城：2 核 4G 起，磁盘 40G；企业建站：1 核 2G，磁盘 20G
  4. 资产台账 SaaS 版不用部署，注册就能用；私有化版 2 核 4G，磁盘 40G
  5. 数据库用容器自带的 MySQL 8 即可；已有实例也可复用，需提供独立库名与账号
  6. 需要开放 80 / 443；小程序接口域名必须已备案并配好 HTTPS
  7. 建议先装好 1Panel，下面所有步骤都能在它的「容器」里点
卡住时看这里
  • 内存 2G 跑商城：MySQL 会 OOM，表现为安装完成但后台 502。加到 4G 或调小 innodb_buffer_pool_size。
  • 域名没备案：小程序请求会被微信拦掉，页面白屏但没有报错。

安装步骤 约 8 分钟

从上传安装包到后台能登录，正常 20-30 分钟。

  1. 从客户门户下载与你授权匹配的安装包（.tar.gz），上传到服务器 /opt 下
  2. 解压后进入目录，复制 .env.example 为 .env
  3. 编辑 .env：填写域名、数据库密码、管理员账号、授权码
  4. 执行 docker compose up -d，等待 3-5 个容器全部 healthy
  5. 浏览器打开 https://你的域名/install，按向导初始化数据库与管理账号
  6. 登录后台 → 系统设置 → 授权，确认授权状态为「已激活」
  7. 配置 Nginx 反代与 SSL（文档里有现成配置），最后跑一次自检
卡住时看这里
  • 容器起来就退出：先 docker compose logs api 看日志，九成是数据库密码或时区配置写错。
  • 安装向导 404：Nginx 少了 try_files，参考文档里的 server 段。
  • 授权提示域名不匹配：授权码绑定的是 www 还是裸域要和后台填写一致。

授权激活 约 4 分钟

授权码怎么用、换域名怎么办、断网会不会挂。

  1. 授权码在客户门户「我的授权」里，形如 WSOFT-XXXX-XXXX-XXXX
  2. 首次激活需要联网：在后台「系统设置 → 授权」粘贴授权码，点激活
  3. 激活成功后本地留存授权文件，之后不再依赖联网校验
  4. 换域名：在门户里提交变更申请，审核通过后旧授权自动失效，新域名重新激活
  5. 多站点授权：每个域名单独激活，门户里能看到已激活列表
卡住时看这里
  • 服务器不能出网：联系我们签发离线授权文件，导入后同样可用（离线授权有效期 12 个月，续费时换新文件）。
  • 授权失效但系统还能跑：这是设计如此。授权失效只影响更新与工单支持，不影响已部署的系统运行。

版本升级 约 5 分钟

升级前必须备份，这是唯一不能省的一步。

  1. 在门户「更新日志」确认目标版本与当前版本，跨大版本要按顺序升
  2. 后台执行一次完整备份（数据库 + 上传目录），或手动 mysqldump
  3. 下载新版本安装包，覆盖程序目录（不要覆盖 .env 与 upload 目录）
  4. 执行 docker compose pull && docker compose up -d
  5. 如版本说明里带数据库脚本，按顺序执行 migrations
  6. 升级后检查：登录、下单、支付回调、定时任务四项
卡住时看这里
  • 升级后后台白屏：清一次浏览器缓存，并确认前端静态资源已更新（Nginx 缓存策略）。
  • 支付回调失效：新版本回调地址有变更，需在小程序后台重新配置。

常见问题排查 约 6 分钟

按现象查，不按功能查。

  1. 后台打不开但容器在跑：先看 Nginx 反代与端口映射
  2. 小程序白屏：微信开发者工具看请求，多半是域名未备案或证书链不全
  3. 支付回调不到账：检查回调地址是否公网可达、是否被防火墙拦、签名密钥是否与商户平台一致
  4. 上传图片失败：检查 upload 目录权限与磁盘是否满（df -h）
  5. 定时任务不执行：容器时区是否 UTC，crontab 是否随容器启动
卡住时看这里
  • 以上都排查完还没解决的，提工单时把 docker compose logs 最近 200 行一起贴上，能省一轮来回。

二次开发指引 约 10 分钟

源码结构、编译方式、扩展点在哪。

  1. 后端：标准 Spring Boot 多模块工程，业务模块按领域分包，新增模块复制现有模块结构即可
  2. 后台前端：Vue 3 + Vite，页面按路由目录组织，接口统一走 request 封装
  3. 小程序端：Taro + React，页面与接口分离，新增页面在 app.config.ts 注册
  4. 数据库：表名前缀区分模块，新增表请沿用前缀，避免升级脚本冲突
  5. 扩展点：支付、短信、存储、物流都是接口实现，替换实现类即可换供应商
  6. 编译产物与官方包同构，升级时可用 git 三方合并保留你的改动
卡住时看这里
  • 改了核心类导致升级冲突：建议把自定义逻辑放在扩展点和独立模块里，不要直接改核心文件。
完整文档（含截图、参数表、API）在客户门户里。 已购买的客户用订单手机号登录 https://my.websoft.top 即可查看与下载。

看完还是不确定能不能装？

把你的服务器配置发我们，一句话就能判断，不收费也不用先买。

问一下
打电话在线演示