白 小白云IDC授权中心
白
小白云IDC · v3.7
安装部署 · 与产品同版本发布

安装部署手册

从一台装好宝塔的 Linux 服务器,到一个能对外接单、自动开通、自动出账的站点。全程用浏览器安装向导,不需要敲几条命令,也不需要手工建库。

适用版本
3.7 及以上
目标系统
Linux(宝塔面板)
安装方式
zip 上传 + 浏览器向导
预计耗时
10–15 分钟

装完你会得到什么

一套部署在自己服务器上的完整 IDC 站点,三个入口各司其职:

入口地址给谁用能做什么
https://你的域名/访客与客户产品展示、下单支付、活动公告,商城前台内容全部在后台可改
https://你的域名/?r=client你的客户管理服务与订单、续费充值、提交工单、打开云服务器控制面板
https://你的域名/?r=admin你和员工商品与订单管理、插件安装、财务报表、系统设置

管理后台是独立入口(默认 ?r=admin/login),与用户账号体系彻底分离;上线后建议按 上线检查表 加固。

环境要求

机器

  • Linux 服务器(宝塔面板 7.x 及以上),1 核 2G 起步,磁盘 20G 以上
  • PHP 8.1 及以上(宝塔软件商店安装,需启用 pdo_sqlite、curl、mbstring、gd 扩展,默认全带)
  • Nginx(宝塔默认安装),无需 MySQL——系统默认使用 SQLite 免建库,也可切换 MySQL

网络

  • 入站放行 80 / 443,用于 Let's Encrypt 证书校验与 http 跳转
  • 出站需能访问:授权中心(激活与在线升级)、上游面板(魔方云 / 宝塔接口)、支付网关
  • 先把域名 A 记录解析到服务器公网 IP,再开始安装
安装包里有什么:一个 zip(约 37MB),包含全部源码与 51 个官方插件,不含 data/ 数据目录与任何演示数据。解压即装,装完即全新站点。

安装(一):宝塔面板(主路线)

整个交付物只有一个 zip。商城前台、用户中心、管理后台、安装向导全部随包分发,不需要单独部署前端,也没有第二个程序要跑。

  1. 新建站点:宝塔「网站 → 添加站点」,填已解析的域名,PHP 版本选 8.1,数据库不创建(SQLite 免建库)。
  2. 上传并解压:进入站点根目录,删掉默认的 index 页面,上传安装包 zip,右键解压。解压后根目录应能看到 index.php、install/、plugins/ 等目录。
  3. 设置伪静态:站点「伪静态」里粘贴 伪静态规则(见下文),保存。系统带两级路由兼容,缺失伪静态也能访问,但商品页等 URL 更友好。
  4. 打开安装向导:浏览器访问 https://你的域名/install/,按向导完成四步:环境自检(全绿才放行)→ 管理员账号与站点信息 →(可选)数据库与授权 → 完成安装。向导会自动创建 data/ 数据目录、写入配置并生成 installed.lock。
  5. 登录后台:访问 https://你的域名/?r=admin/login,用向导里设置的管理员账号登录。首次登录建议先改密码。
  6. 配置 SSL:宝塔「SSL」用 Let's Encrypt 一键签发,勾选「强制 HTTPS」。
装完自查:前台打开是商城首页;?r=admin 能登录后台;后台「应用商城」能看到插件列表并显示版本。三件事都过,安装就完成了。

安装(二):老站升级覆盖

已经是小白云IDC 老版本的站点,升级同样只有一个 zip,老数据零迁移:

  1. 后台「授权信息 → 检查更新」在线升级(推荐),或从授权中心下载新包手动覆盖。
  2. 手动覆盖时:保留 站点的 data/ 目录与 install.lock(如有),其余文件用新包覆盖。
  3. 打开任意页面,系统自动完成数据表增量迁移,无需手动执行 SQL。
覆盖前先做一次备份(见 备份与恢复)。跨多个大版本升级不要跳版本,逐版升更稳。

首次初始化与登录

安装向导就是初始化:建数据表、写站点配置、创建管理员。账号密码只在向导里输入一次,后续从后台「账号安全」里改。

  • 管理员账号:独立于用户体系,只用于管理后台。
  • 站点信息:商城名称、联系方式、客服入口随时在后台「设置中心」改。
  • 授权码:向导里可先跳过,登录后在「授权信息」页填写授权码并「校验并保存」。

伪静态规则

宝塔站点「伪静态」粘贴以下规则(Nginx):

location / {
    if (!-f $request_filename) {
        rewrite ^(.*)$ /index.php?$1 last;
        break;
    }
}

规则作用:让 ?r= 与 ?p= 两套路由兼容共存,同时避免「App 控制台 / API 伪静态丢失」类问题。修改后 nginx -t 校验再 reload。

域名与 HTTPS

证书用宝塔的 Let's Encrypt 一键签发即可:站点「SSL」→ Let's Encrypt → 勾选域名 → 申请,成功后打开「强制 HTTPS」。证书续期由宝塔计划任务自动完成,无需人工介入。

签发失败的常见原因:① 域名还没解析到本机;② 80 端口被安全组挡住;③ 短时间内反复申请触发频率限制,等一小时再试。

上游与支付对接

开通渠道与收款渠道都是插件,装好后在「插件管理」里填参数,保存即生效,无需重启:

要接什么装哪个插件需要准备
魔方云(KVM/NAT 自动开通)云服务器管理(mofang_cloud)主控管理 API 地址、管理员账号;商品编辑页里选节点/镜像/规格
宝塔主机(虚拟主机自动建站)宝塔主机对接(baota_panel)宝塔面板地址 + API 密钥
收款支付宝 / 微信官方支付、易支付、余额商户号与密钥,或易支付网关
通知SMTP 邮件 / 短信通知 / 群机器人SMTP 账号、短信模板或机器人 Webhook
实名合规实名认证(阿里云 / 腾讯云)对应云产品 AppCode 或密钥

对接魔方云时填写「主控 API 地址(含管理二级目录)」,商品编辑页会出现点选式开通参数面板(节点、镜像、CPU/内存/磁盘、转发条数),保存后订单支付成功即自动建机。

授权激活

后台「授权信息」页填入授权码,点「校验并保存」。系统会记录绑定域名并拉取最新版本与更新日志;此后每次「检查更新」自动完成。

  • 授权与域名绑定:更换域名后需在授权中心重新绑定(联系供应商或自助换绑)。
  • 授权正常才能使用「检查更新 / 在线升级」,离线环境可使用离线授权文件(见 接口文档)。

目录与数据

路径内容要备份
data/SQLite 数据库、站点配置、上传文件——整个站点的核心数据必须
plugins/已安装插件源码(重装插件可再生成,含自定义改动时要备)建议
install/安装向导(安装完成后不再使用)否
其余根目录文件程序源码,升级时由新包整体覆盖否
记住一条:data/ 目录是站点的全部身家。无论升级还是迁移,保住它就保住了用户、订单与账务。

备份与恢复

备份两样东西:数据库文件与上传文件,都在 data/ 里。

  1. 后台一键备份:管理后台「数据备份」点击备份,生成 zip 可直接下载。
  2. 宝塔计划任务(推荐):添加 Shell 脚本任务,每天凌晨打包:
#!/usr/bin/env bash
# 每天 03:30 备份站点数据,保留 14 天
SITE=/www/wwwroot/你的站点目录
DIR=/www/backup/bgcloud
mkdir -p "$DIR"
tar czf "$DIR/bgcloud-$(date +%Y%m%d).tar.gz" -C "$SITE" data
find "$DIR" -type f -mtime +14 -delete
备份别和站点放同一块盘:定期把 /www/backup 同步到另一台机器或对象存储,磁盘坏了才救得回来。

恢复:停站(宝塔暂停站点)→ 用备份的 data/ 覆盖回去 → 恢复站点属主为 www → 重启 PHP。数据库与程序版本不匹配时,打开任意页面会自动补齐表结构。

升级与回滚

在线升级(推荐)

后台「授权信息 → 更新版本」:拉取最新版本与更新日志 → 确认后自动下载安装包、校验哈希、排除数据目录覆盖升级。全程约一分钟,老数据零迁移。

手动升级

  1. 授权中心下载最新安装包 zip;
  2. 解压后删除包内 data/ 相关配置(纯净包本来就不含),把其余文件覆盖到站点根目录;
  3. 保留站点的 data/;打开任意页面自动完成迁移。

回滚

用旧版本包按手动升级步骤覆盖回去即可;升级前有备份的话,出问题先恢复 data/。

回滚不会撤销数据库迁移:新版本加的表/字段会保留。跨版本升级先备份,回滚后字段对不上就用升级前备份恢复。

卸载

  1. 宝塔删除站点(确认已备份 data/);
  2. 授权中心后台将该站点的授权码吊销或换绑;
  3. 删除站点目录与数据库(如有用 MySQL)。

排错手册

安装向导提示环境检测不通过

逐项看检测项:缺 PHP 扩展在宝塔 PHP 管理页「安装扩展」补;data/ 无法写入多为目录属主不对,执行 chown -R www:www 站点目录。

装完打开是 404 或空白

先确认伪静态已保存且 nginx -t 通过;再看是否解压到子目录(源码必须在站点根);PHP 版本低于 8.1 也会直接白屏。

后台登录提示 CSRF 校验失败

多为站点配置层把大表单丢掉了:检查 Nginx 是否有非法的 fastcgi_param PHP_VALUE 行(多指令空格分隔是非法写法,会把 post_max_size 解析坏),删除后完整重启 Nginx 与 PHP-FPM。

「检查更新」报授权校验失败

在「授权信息」页重新「校验并保存」;仍失败检查服务器能否访问授权中心(curl 授权中心首页),以及授权码是否被吊销或域名换绑未同步。

插件安装后列表不显示

后台「应用商城」先同步插件列表再安装;若插件已装但不出现在功能里,检查「插件管理」里该插件状态是否为启用,以及商品是否已绑定该对接插件。

订单支付成功但没自动开通

按顺序查:商品是否绑定了开通插件 → 插件参数是否填全(节点/镜像/规格)→ 后台「自动开通」队列里该订单的失败原因。上游接口报错会记录在任务备注里,修复后可直接重试开通。

上传大文件 / 图片失败

宝塔站点配置里把 client_max_body_size 提到 64m 以上;PHP 的 upload_max_filesize、post_max_size 同步调大。

上线检查表

检查项怎么确认
HTTPS 生效、http 自动跳转浏览器打开 http://域名 应跳到 https,证书有效期正常
授权已激活「授权信息」页状态正常,版本与授权中心一致
管理员密码已修改不用安装向导时的默认弱口令;每个员工独立账号
伪静态已配置商品页、用户中心各页直接刷新无 404
备份任务在跑宝塔计划任务列表有记录,备份目录里已有文件
支付与通知真实跑通小额真实下单一次:下单 → 支付 → 自动开通 → 收到通知
插件与商品绑定核对每个在售商品都绑定了正确的开通插件与规格参数
无测试数据残留测试商品、测试工单、演示卡密清理或下架

小白云IDC 安装部署手册 · 与产品同版本发布 · 日常使用见《使用手册》,二次对接见《开放接口文档》