芙云模板安装

约 1640 字大约 5 分钟

2026-07-21

文档说明

本文介绍 芙云财务主题套件（fuwww / fuuser / fucart + 管理后台）的安装方式。适用于已部署 魔方财务 3.5.x 的站点。

安装前准备

确认魔方已可用、域名已授权，并准备好安装包或使用云端最新版。

查看准备 →

浏览器安装

推荐方式：将 fufuinstall.zip 解压到魔方 public 目录后，访问安装页按进度完成安装。

开始安装 →

功能介绍

了解官网、会员中心、购物车与后台可配置能力。

查看功能 →

套件组成

组件	目录 / 路径	说明
官网主题	`public/themes/web/fuwww`	品牌首页、导航、页脚、内容页
会员中心	`public/themes/clientarea/fuuser`	账户、产品、工单、账单等
购物车	`public/themes/cart/fucart`	选购、配置、结算流程
管理后台	`public/fu-theme-admin`	可视化配置与在线更新
核心数据	`data/fu-theme`	版本号、授权、配置存储等

安装脚本会将上述内容写入魔方站点对应目录，并尽量保留已有 settings.json 等站点配置。

安装前准备

1. 环境要求

项目	要求
业务系统	魔方财务 3.5.x（目录中含 `think` 或 `public/themes`）
PHP	建议 7.4+，需开启 ZipArchive、curl（或 `allow_url_fopen`）
权限	站点 `public/`、`data/` 目录可写
授权	访问域名需已在授权中心开通芙云模板授权

2. 获取安装文件

通常你会收到：

fufuinstall.zip：网页安装包（解压到魔方站点 public 目录后即可访问安装页）
fu-theme-x.y.z.zip：主题套件安装包（可选；没有本地包时会从云端下载）

授权与防盗版说明

安装时会 自动读取当前访问域名 并校验是否已授权。
未授权将无法继续安装，请先通过正规渠道为该域名开通授权后再试。
请勿外传安装包；非官方授权渠道获得的安装包请勿使用。

3. 上传并解压安装包

将获取到的安装包 fufuinstall.zip 解压到魔方站点的 public 目录，例如：

/www/wwwroot/你的站点/public/

解压完成后，该目录下应出现 fufuinstall 文件夹（内含安装程序）。

浏览器安装（推荐）

步骤 1：访问安装页

在浏览器打开：

https://您的域名/fufuinstall

页面顶部会显示公告，并自动展示 当前识别到的域名。

步骤 2：填写表单

字段	是否必填	说明
魔方站点根目录	建议填写	含 `think` 或 `public/themes` 的那一层，例如 `/www/wwwroot/cloud.example.com`；多数情况可自动识别
指定版本	可选	留空则安装云端最新版；云端仅允许最新正式版
本地 zip 路径	可选	同目录已有 `fu-theme-*.zip` 时会自动检测
强制从云端下载	可选	勾选后忽略本地 zip，始终拉取云端包

更新源

更新源已内置为默认地址，无需也不再提供手填。未指定本地包时，将自动下载最新正式包。

步骤 3：开始安装并查看进度

点击 开始安装 后，页面会显示进度条与分步状态，大致如下：

进度	阶段
5%	检测域名
10%	验证授权
15%	检测站点根目录
20%	下载安装包
45%	解压文件
55%	安装各组件
85%	写入配置文件
90%	恢复配置
95%	清理临时文件
98%	清理安装目录
100%	完成

安装过程中会保留原有后台配置（如已存在的 settings.json / secrets.enc），避免覆盖站点自定义内容。

步骤 4：完成后的操作

安装成功后脚本会：

自动清理 安装目录 public/fufuinstall（若清理失败，请手动删除以保证安全）
询问是否 跳转到后台配置（/fu-theme-admin/）

建议立即进入后台完成初始化，并在魔方中启用主题套件。

安装后配置

1. 初始化管理后台

浏览器访问：

https://你的域名/fu-theme-admin/

首次进入按提示创建管理员账号（含滑块验证），登录后即可配置站务、导航、Banner、会员中心与购物车等。

2. 在魔方中启用主题

可在芙云管理后台工作台点击 一键启用套件，或在魔方后台分别启用：

类型	主题名
官网 / WEB	`fuwww`
会员中心	`fuuser`
购物车	`fucart`

3. 在线更新（可选）

后台路径：自定义 → 在线更新

显示本地版本与云端最新版本
一键检查并安装更新
更新不会覆盖已保存的站点配置（settings.json）

命令行安装（可选）

适合无法用浏览器访问、或需要脚本化部署的场景。进入解压后的安装目录执行：

# 进入 public/fufuinstall 目录后执行
php install.php --root=/www/wwwroot/你的站点

# 指定版本
php install.php --root=/www/wwwroot/你的站点 --version=1.0.11

# 使用本地 zip
php install.php --root=/www/wwwroot/你的站点 --local=/path/to/fu-theme-1.0.11.zip

命令行与授权

命令行环境下若无法自动识别公网域名，请改用 浏览器方式 在已授权域名下安装，以确保授权校验通过。

常见问题

提示未授权，无法继续安装

确认浏览器地址栏域名与授权中心开通的域名 完全一致（含是否带 www）。
通过正规渠道为当前域名开通授权后再试。

未找到魔方目录

手动填写正确的站点根目录，例如：

/www/wwwroot/cloud.example.com

该目录下应能看到 think 文件，或存在 public/themes。

下载失败 / 授权服务器不可达

检查服务器出网、DNS 与防火墙；确认可访问更新与授权相关域名。也可改为使用同目录本地 fu-theme-*.zip 安装。

安装完成后页面仍是旧主题

确认魔方已启用 fuwww / fuuser / fucart
清除魔方运行时缓存（如 data/runtime/temp）
浏览器强制刷新（Ctrl + F5）

安装目录没有被自动删除

请手动删除 public/fufuinstall 目录，避免他人再次访问安装入口。

文档	链接
功能介绍	/theme/features/
文档首页	/
SSH 按钮添加	/ssh/
芙芙云官网	https://www.fufuidc.com/