安装部署手册
从一台装好宝塔的 Linux 服务器,到一个能对外接单、自动开通、自动出账的站点。全程用浏览器安装向导,不需要敲几条命令,也不需要手工建库。
装完你会得到什么
一套部署在自己服务器上的完整 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,再开始安装
data/ 数据目录与任何演示数据。解压即装,装完即全新站点。
安装(一):宝塔面板(主路线)
整个交付物只有一个 zip。商城前台、用户中心、管理后台、安装向导全部随包分发,不需要单独部署前端,也没有第二个程序要跑。
- 新建站点:宝塔「网站 → 添加站点」,填已解析的域名,PHP 版本选 8.1,数据库不创建(SQLite 免建库)。
- 上传并解压:进入站点根目录,删掉默认的 index 页面,上传安装包 zip,右键解压。解压后根目录应能看到
index.php、install/、plugins/等目录。 - 设置伪静态:站点「伪静态」里粘贴 伪静态规则(见下文),保存。系统带两级路由兼容,缺失伪静态也能访问,但商品页等 URL 更友好。
- 打开安装向导:浏览器访问
https://你的域名/install/,按向导完成四步:环境自检(全绿才放行)→ 管理员账号与站点信息 →(可选)数据库与授权 → 完成安装。向导会自动创建data/数据目录、写入配置并生成installed.lock。 - 登录后台:访问
https://你的域名/?r=admin/login,用向导里设置的管理员账号登录。首次登录建议先改密码。 - 配置 SSL:宝塔「SSL」用 Let's Encrypt 一键签发,勾选「强制 HTTPS」。
?r=admin 能登录后台;后台「应用商城」能看到插件列表并显示版本。三件事都过,安装就完成了。
安装(二):老站升级覆盖
已经是小白云IDC 老版本的站点,升级同样只有一个 zip,老数据零迁移:
- 后台「授权信息 → 检查更新」在线升级(推荐),或从授权中心下载新包手动覆盖。
- 手动覆盖时:保留 站点的
data/目录与install.lock(如有),其余文件用新包覆盖。 - 打开任意页面,系统自动完成数据表增量迁移,无需手动执行 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」。证书续期由宝塔计划任务自动完成,无需人工介入。
上游与支付对接
开通渠道与收款渠道都是插件,装好后在「插件管理」里填参数,保存即生效,无需重启:
| 要接什么 | 装哪个插件 | 需要准备 |
|---|---|---|
| 魔方云(KVM/NAT 自动开通) | 云服务器管理(mofang_cloud) | 主控管理 API 地址、管理员账号;商品编辑页里选节点/镜像/规格 |
| 宝塔主机(虚拟主机自动建站) | 宝塔主机对接(baota_panel) | 宝塔面板地址 + API 密钥 |
| 收款 | 支付宝 / 微信官方支付、易支付、余额 | 商户号与密钥,或易支付网关 |
| 通知 | SMTP 邮件 / 短信通知 / 群机器人 | SMTP 账号、短信模板或机器人 Webhook |
| 实名合规 | 实名认证(阿里云 / 腾讯云) | 对应云产品 AppCode 或密钥 |
对接魔方云时填写「主控 API 地址(含管理二级目录)」,商品编辑页会出现点选式开通参数面板(节点、镜像、CPU/内存/磁盘、转发条数),保存后订单支付成功即自动建机。
授权激活
后台「授权信息」页填入授权码,点「校验并保存」。系统会记录绑定域名并拉取最新版本与更新日志;此后每次「检查更新」自动完成。
- 授权与域名绑定:更换域名后需在授权中心重新绑定(联系供应商或自助换绑)。
- 授权正常才能使用「检查更新 / 在线升级」,离线环境可使用离线授权文件(见 接口文档)。
目录与数据
| 路径 | 内容 | 要备份 |
|---|---|---|
data/ | SQLite 数据库、站点配置、上传文件——整个站点的核心数据 | 必须 |
plugins/ | 已安装插件源码(重装插件可再生成,含自定义改动时要备) | 建议 |
install/ | 安装向导(安装完成后不再使用) | 否 |
| 其余根目录文件 | 程序源码,升级时由新包整体覆盖 | 否 |
data/ 目录是站点的全部身家。无论升级还是迁移,保住它就保住了用户、订单与账务。
备份与恢复
备份两样东西:数据库文件与上传文件,都在 data/ 里。
- 后台一键备份:管理后台「数据备份」点击备份,生成 zip 可直接下载。
- 宝塔计划任务(推荐):添加 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。数据库与程序版本不匹配时,打开任意页面会自动补齐表结构。
升级与回滚
在线升级(推荐)
后台「授权信息 → 更新版本」:拉取最新版本与更新日志 → 确认后自动下载安装包、校验哈希、排除数据目录覆盖升级。全程约一分钟,老数据零迁移。
手动升级
- 授权中心下载最新安装包 zip;
- 解压后删除包内 data/ 相关配置(纯净包本来就不含),把其余文件覆盖到站点根目录;
- 保留站点的
data/;打开任意页面自动完成迁移。
回滚
用旧版本包按手动升级步骤覆盖回去即可;升级前有备份的话,出问题先恢复 data/。
卸载
- 宝塔删除站点(确认已备份
data/); - 授权中心后台将该站点的授权码吊销或换绑;
- 删除站点目录与数据库(如有用 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 安装部署手册 · 与产品同版本发布 · 日常使用见《使用手册》,二次对接见《开放接口文档》