旺铺子 Cloud · 站长端自主安装教程

适用对象：会买云服务器、会装宝塔（BT）的客户。安装包：官方提供的「非中枢端」压缩包（文件名形如非中枢端_YYYYMMDD_HHMMSS旺铺子Cloud框架安装包.zip，内含代码保护）。不要装：官方中枢包；本教程只覆盖站长端 / 客户站。

0. 你需要提前准备什么

材料	说明
云服务器	Linux（推荐 CentOS 7+/Ubuntu 20+），建议 ≥2 核 4G
宝塔面板	已安装并可登录
域名	已解析到服务器公网 IP（安装时要填「绑定域名」）
安装包	官方下发的非中枢 zip
授权信息	授权码 + 密钥 + 绑定域名（三要素缺一不可，向官方索取）
中枢地址	正式环境固定为 https://cloud.wpzcloud.com（一般无需改）

软件环境（宝塔里装好）：

组件	建议版本
Nginx	最新稳定版
PHP	≥ 8.1（推荐 8.3），命令行 php 与网站用同一大版本
MySQL / MariaDB	5.7+ / 8.0+
Redis	开启即可
Composer	一般客户包已带 server/vendor，通常不必再 composer install

PHP 扩展建议勾选：pdo_mysql、redis、curl、openssl、mbstring、fileinfo、zip。

1. 上传并解压安装包

/www/wwwroot/你的域名/

上传 zip，解压到该目录，解压后应能看到：

你的站点根/
├── server/          ← 后端（Webman）
│   ├── public/      ← Nginx 网站根目录必须指向这里
│   ├── start.php
│   ├── customer-start.sh
│   ├── APP_ROLE.txt      （内容应为 customer）
│   └── DIST_FLAVOR.txt   （保护包为 protected）
├── admin/           ← 源码可选保留；后台静态资源已在 server/public/admin
└── …

确认没有 server/app/official 目录（非中枢包不应含中枢代码）。
确认没有 server/install.lock（有则说明曾装过，需清空后才能重装）。

2. 宝塔创建网站与目录权限

网站 → 添加站点（记得创建就的是异步项目）
目录权限（宝塔文件管理或 SSH）：

chown -R www:www /www/wwwroot/你的域名
chmod -R 755 /www/wwwroot/你的域名/server
mkdir -p /www/wwwroot/你的域名/server/runtime \
         /www/wwwroot/你的域名/server/public/upload
chmod -R 777 /www/wwwroot/你的域名/server/runtime \
             /www/wwwroot/你的域名/server/public/upload

3. 创建数据库与 Redis

3.1 MySQL

宝塔 → 数据库 → 添加数据库，例如：
字符集：utf8mb4

3.2 Redis

安装并启动 Redis。
若本机还跑了别的 Cloud 实例，请给本站使用独立 Redis 库号（如 3），避免缓存串站。
记下：主机（多为 127.0.0.1）、端口、密码（可空）、库号。

4. 配置 Nginx 反代到 Webman

站长端业务由 Webman 监听端口提供（不是传统 PHP-FPM 跑整站）。

4.1 安装阶段（推荐先用安装入口口）

cd /www/wwwroot/你的域名/server
chmod +x customer-start.sh
./customer-start.sh

未安装时监听安装入口默认口：HTTP 20000 / Push WS 3131 / Push API 3232。

若同机已被占用，customer-start.sh 会自动改用空闲口并写入 .env（以脚本打印为准）。

浏览器打开（任选其一）：

http://服务器IP:20000/install/
或先在宝塔放行安全组 / 防火墙的 20000 端口

若坚持用域名 HTTPS 打开安装页，需临时把 Nginx 反代指到 127.0.0.1:20000，装完再改成正式端口。

4.2 正式运行（安装完成后）

安装向导会自动挑选空闲端口写入 server/.env（如 HTTP_LISTEN=http://0.0.0.0:xxxxx），并尝试重启。

在网站「配置文件」中增加 / 调整反代（示例，把 19891 换成你 .env 里的实际端口）：

location / {
    proxy_pass http://127.0.0.1:19891;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header Connection "";
    client_max_body_size 50m;
}

# 静态资源可仍由 Nginx 直接读 public（按宝塔默认即可）
# 管理端静态：/admin/
# 安装页：/install/（装完后可不再使用）

申请 SSL 证书后，用 https://你的域名/admin/ 访问后台。

宝塔「网站运行」状态：以进程端口（ss -lntp | grep 端口）为准；面板显示「已停止」不等于 Webman 挂了。部署后请确认站点为运行中、Nginx 配置为启用状态。

5. 网页安装向导（核心步骤）

打开 /install/ 后按页面提示操作：

步骤 A：环境检测

确认 PHP、扩展、目录可写等项通过。

步骤 B：授权校验（三要素）

填写官方发给你的：

授权码
密钥
绑定域名（须与当前站点域名一致，如 shop.example.com，一般不带 https://）

校验通过后才会进入写库安装。

步骤 C：填写安装配置

项	说明
MySQL 主机/端口/库名/账号/密码	填第 3 节创建的库
表前缀	默认 ns_ 即可
Redis 主机/端口/密码/库号	填第 3 节
站点访问地址 APP_URL	如 https://shop.example.com
管理员账号/密码	安装后登录后台用
监听端口（HTTP / Push WS / Push API）	三者都会自动探测空闲口写入 .env；装完以这组正式口为准，安装入口口可忽略

中枢地址：客户包默认指向正式中枢 https://cloud.wpzcloud.com，无需填写中枢后台账号。

步骤 D：一键安装

等待完成。成功后会出现：

server/install.lock
写好的 server/.env
提示正式端口与后台地址

按提示用新端口 / 域名打开 https://域名/admin/，用你设的管理员账号登录。

6. 安装后自检清单

https://你的域名/admin/ 能打开登录页

能用安装时设置的管理员登录

「产品授权 / 授权信息」中能看到已绑定的授权码与域名

「应用」相关页面能拉取中枢市场（需服务器能访问外网中枢）

ss -lntp 能看到 .env 里配置的 HTTP 端口在监听

宝塔站点状态为运行；SSL 正常

7. 日常启停（Linux）

cd /www/wwwroot/你的域名/server

# 推荐：按 .env 启停
./customer-start.sh

# 或
php start.php start -d
php start.php stop
php start.php restart -d
php start.php status

改 .env 后必须重启 Webman 才生效。

8. 常见问题

现象	处理
提示请填写绑定域名	授权三要素不齐；域名须与发码/绑定一致
打开 /install/ 提示已安装	存在 install.lock；重装需清空库并删 lock（慎用）
502 Bad Gateway	Nginx 反代端口与 .env 中 HTTP_LISTEN 不一致，或 Webman 未启动
市场/升级请求失败	检查服务器出网、授权是否有效、中枢地址是否为 https://cloud.wpzcloud.com
Redis 菜单错乱	同机多站共用 Redis 时请改 REDIS_DATABASE 或设置 REDIS_PREFIX
面板显示站点停止	以端口进程为准；在宝塔把站点设为运行并确认 Nginx 配置已启用

9. 安全与边界（请务必遵守）

不要把本站改成中枢（勿设 APP_ROLE=official、勿拷入 app/official）。
不要对外暴露 Redis / MySQL 端口。
生产环境 APP_DEBUG=false。
授权码、密钥、数据库密码勿发给无关人员。
框架/应用升级请走后台升级流程；升级包与授权通道由官方控制。

10. 联系官方

对外官网：https://www.wangpuzi.cn
授权与安装包：向销售 / 实施同学索取
技术中枢（客户无需登录）：https://cloud.wpzcloud.com

自主安装流程（专业版）