Pano2VR 全景项目后台管理工具 · 使用说明

版本：v1.0
更新日期：2026-10-24
适用系统：Windows 10 / 11（64 位）
官网：https://www.010720.cn/p/pano2vrcms
帮助文档：https://www.010720.cn/help/pano2vrcms

一、软件概述

Pano2VR 全景项目后台管理工具 是一款 Windows 桌面软件，用于一键为 Pano2VR 生成的全景项目添加在线管理后台。

核心价值

🎯 零编程：无需 PHP / Vue / 前端知识
⚡ 一键生成：选好 Pano2VR 输出目录，点一个按钮即可生成完整的管理后台
🌐 客户自助：客户在浏览器中直接修改文字、上传图片/视频/PDF，无需回到 Pano2VR
🔒 安全可靠：密码登录、5 次失败锁定、HTTPS 兼容
📦 静态部署：仅需 PHP ≥ 7.4，无需数据库

适用场景

场景	价值
给甲方交付全景项目	客户改文字不用找你，自己在线改
政府/景区/博物馆展示	内容更新频繁，避免反复联系开发
长期运营的项目	客户上手即改，省维护成本

二、免费版 vs 专业版

功能对比

功能模块	免费版	专业版
项目打包（pano/ + admin/）	✅	✅
场景编辑（标题/作者/描述）	✅	✅
热点基础编辑（标题/介绍）	✅	✅
自动生成管理密码	✅	✅
CDN 前缀配置（tiles/pic/html）	❌	✅
CDN 上传清单生成	❌	✅
CDN 素材清单查看	❌	✅
对已有项目应用 CDN	❌	✅
首页分享 meta 编辑	❌	✅
热点文件上传/替换（图片/视频/PDF）	❌	✅
工程文件保存/加载（.pano2vr.json）	❌	✅
CDN 应用范围细粒度勾选	❌	✅

规模限制

维度	免费版上限	专业版
场景数	12 个	不限
热点总数	20 个	不限
单次输出包大小	500 MB	不限
工程文件持久化	❌ 每次新建	✅ 自动保存

三、快速上手（5 分钟）

步骤 1：准备 Pano2VR 输出

在 Pano2VR 中完成全景项目制作，点击"生成输出"，得到如下目录：

D:\全景\我的项目\
├── index.html
├── pano.xml
├── skin.js
├── pano2vr_player.js
├── tiles\          ← 瓦片目录
├── images\         ← 图片素材
├── media\          ← 视频/音频素材
└── ...

步骤 2：打开本工具

双击运行 Pano2VR全景项目后台管理工具.exe。

主界面包含：

顶部菜单栏（文件 / 构建 / 工具 / 帮助）和工具栏
① 源项目目录选择
② 目标项目配置（项目名 / 输出位置 / 管理密码）
③ 项目信息显示区
④ 进度条和【生成完整项目包】按钮
右上角显示当前版本（免费版 / 专业版）

步骤 3：选择源项目目录

点击 【📁 选择 Pano2VR 输出目录】，选中刚才的目录（如 D:\全景\我的项目）。

软件会自动检测：

场景数量
热点数量
素材目录大小
CDN 引用情况

步骤 4：填写项目信息

字段	说明	示例
项目名称	英文/拼音，将用作目录名	`20261024_pano`
输出位置	默认 `D:\全景输出\`	自定义可改
管理密码	自动生成，可复制	`Xy9kL3mPq2R`

步骤 5：点击【🚀 生成完整项目包】

软件会自动完成：

复制 Pano2VR 输出到 输出位置\项目名\pano\
生成管理后台到 输出位置\项目名\admin\
（可选）应用 CDN 前缀
生成 README-部署说明.txt 和 CDN上传清单.txt

完成后弹出成功提示，点 【打开输出目录】 即可查看。

步骤 6：部署到服务器

打开 README-部署说明.txt，按提示上传：

整个项目文件夹 → 网站根目录
访问 https://你的域名.com/项目文件夹/admin/assets/ → 输入密码登录

四、主界面详解

顶部菜单栏

菜单	主要功能	快捷键
文件(F)	新建项目 / 打开工程 / 保存工程 / 退出	Ctrl+N/O/S/Q
构建(B)	生成完整项目包 / 应用 CDN / 打开输出目录	F5 / F6
工具(T)	CDN 素材清单 / 复制管理密码 / 检查更新	—
帮助(H)	注册 / 帮助文档 / 关于	F1

顶部工具栏

[📂 打开工程] [💾 保存工程]  |  [🚀 生成完整项目包] [📋 CDN清单]   ───弹簧───   [🔓 免费版]

左侧：常用动作（与菜单一一对应）
右侧：授权状态按钮（点击 = 打开注册对话框）

主面板区域

① 项目源目录

选择 Pano2VR 输出目录，软件自动扫描并显示项目统计信息。

② 项目信息

项目名称：英文/拼音（用于目录命名）
输出位置：默认 D:\全景输出\
管理密码：自动生成 16 位强密码，可复制/重新生成

③ CDN 配置（专业版）

CDN 前缀：如 https://cdn.example.com/foo/
应用范围：勾选哪类资源走 CDN
☑ 全景 tiles（瓦片图）
☑ 其他相对路径（pic/ html/ 等热点页面）

④ 首页分享 meta（专业版）

首页标题：浏览器标签显示的标题
分享描述：微信/微博分享时的描述文案

⑤ 项目信息框

只读，实时显示：

场景数 / 热点数
素材目录大小
CDN 引用统计

⑥ 进度条 + 主操作按钮

点击 【🚀 生成完整项目包】 开始打包。

五、核心功能详解

5.1 项目打包

输入：Pano2VR 输出目录
输出：包含管理后台的完整项目

输出结构：

输出位置\项目名\
├── pano\                  ← Pano2VR 原始输出（原样复制）
│   ├── index.html
│   ├── pano.xml
│   ├── tiles\
│   └── ...
├── admin\                 ← 管理后台（新增）
│   ├── assets\           ← Vue3 SPA
│   ├── api\              ← PHP API
│   ├── lib\              ← PHP 库
│   └── config.php        ← 配置文件（含密码）
├── README-部署说明.txt    ← 部署指南
└── CDN上传清单.txt        ← CDN 上传清单（如有）

5.2 CDN 配置（专业版）

什么是 CDN？

把大文件（瓦片图、视频）放到 CDN 加速，提升加载速度。

应用范围

类型	默认勾选	说明
全景 tiles	✅	瓦片图（最大头，强烈建议 CDN）
其他相对路径	✅	pic/ html/ 等热点页面
images/ media/	❌	不走 CDN（skin.js 硬引用）
http/https 外链	❌	永不动（如 `https://720.6wf.cn`）
{nodeN} 占位符	❌	永不动（场景切换）

跳过拷贝

勾选某类型后，本地不再拷贝对应目录（节省空间），改为生成 CDN上传清单.txt。

5.3 首页分享 meta（专业版）

修改 <title> 和 Open Graph 标签，让微信/微博分享显示自定义标题和描述。

5.4 工程文件（专业版）

保存：Ctrl+S → 保存为 .pano2vr.json，记录所有界面字段
打开：Ctrl+O → 加载工程文件，自动填充所有字段
自动恢复：上次保存的工程文件在下次启动时自动加载（可关闭）

5.5 对已有项目应用 CDN（专业版）

场景：项目已部署，后来想加 CDN，不想重新生成。

操作：

菜单 构建 → 对已有项目应用 CDN
选择项目根目录
输入 CDN 前缀
自动改写 pano.xml 中的所有匹配 URL

六、部署到服务器

6.1 服务器要求

项目	要求
Web 服务器	Apache / Nginx / IIS 均可
PHP	≥ 7.4（推荐 8.2+）
数据库	不需要
HTTPS	强烈推荐（密码明文 HTTP 不安全）

6.2 部署步骤

例如：/var/www/html/我的项目/

确认 PHP 可用

访问 https://你的域名.com/我的项目/admin/api/read.php
应返回 JSON（即使报错也说明 PHP 在跑）

访问全景项目

https://你的域名.com/我的项目/pano/

访问管理后台

https://你的域名.com/我的项目/admin/assets/
输入密码登录

6.3 CDN 上传（如启用）

打开 CDN上传清单.txt，按提示把目录上传到 CDN。

目录结构必须保持一致：

CDN 服务器:
https://cdn.example.com/foo/
├── tiles/         ← 从本地 tiles\ 上传
├── pic/           ← 从本地 pic\ 上传
└── ...

七、客户使用管理后台

7.1 登录

浏览器打开：https://你的域名.com/项目文件夹/admin/assets/

页面中央显示登录卡片，输入管理密码后点击【登录】。

输入密码（在 README-部署说明.txt 或服务器 admin/config.php 中）。

7.2 主界面

登录成功后进入主界面：

顶部：项目名 + 连接状态标签（● 已连接 / ○ 未连接）+ 退出按钮
左侧菜单：
项目全局设置（站点信息、CDN、首页分享）
场景列表（每个场景一个条目）
维护（恢复出厂）
右侧：编辑面板（根据左侧选中项切换）

7.3 编辑场景

点击左侧某个场景，右侧显示：

场景标题（用户数据 title）
作者 / 描述 / 版权
热点列表：可编辑每个热点的标题/描述，上传图片/视频

7.4 上传热点文件

在某个热点下点击 【上传图片/视频/PDF】，选择本地文件，自动上传到服务器并替换。

7.5 恢复出厂

如果改乱了，点 维护 → 恢复出厂，一键回到最初打包时的状态。

⚠️ 会丢失所有后台修改！

八、注册与升级

8.1 查看当前版本

主界面右上角显示当前版本：

🔓 免费版：未注册
✅ 专业版（至 2026-12-31）：已注册（有期限）
✅ 专业版（永久）：已注册（永久）

8.2 注册流程

点击右上角版本按钮 → 打开注册对话框

对话框内容：

顶部黄色提示条（免费版功能限制说明）
机器码显示框 + 【复制机器码】按钮
注册码输入框
【取消】【注册 / 重新注册】按钮

复制机器码（点击"复制机器码"按钮）
发送机器码给管理员 → 获取注册码
粘贴注册码 → 点击"注册 / 重新注册"
注册成功后，界面立即解锁所有专业版功能

8.3 取消注册

菜单 帮助 → 注册 / 取消注册 → 点击"取消注册"，二次确认后恢复为免费版。

⚠️ 取消后机器码会保留，下次注册无需重新获取。

九、常见问题 FAQ

Q1: 生成的项目能在手机上看吗？

✅ 能。Pano2VR 输出本身就是响应式的，管理后台也是。

Q2: 修改后会立即生效吗？

✅ 是。保存后立即写入 pano.xml，前端刷新即可看到。

Q3: 支持多少个场景？

免费版：≤ 12 个
专业版：不限

Q4: 热点数量限制？

免费版：≤ 20 个
专业版：不限

Q5: 忘记密码怎么办？

登录服务器，打开 admin/config.php，里面明文存储密码。

Q6: 客户改乱了怎么恢复？

后台 维护 → 恢复出厂，一键回到最初状态。

Q7: 免费版有什么限制？

限制	影响
场景 ≤ 12	大项目做不了
热点 ≤ 20	复杂项目受限
输出 ≤ 500MB	大素材项目受限
不能用 CDN	加载速度慢
无工程文件持久化	每次需重新填写配置

Q8: 专业版多少钱？

联系管理员获取报价。支持一次性买断 / 按年订阅。

Q9: 提示"网络连接失败"怎么办？

检查电脑是否联网
检查防火墙是否拦截
如果多次失败，重启软件

Q10: 能在 Mac / Linux 上用吗？

❌ 暂不支持。仅 Windows 10/11 64 位。

十、技术支持

官网：https://www.010720.cn/p/pano2vrcms
帮助文档：https://www.010720.cn/help/pano2vrcms
购买授权：https://www.010720.cn/p/pano2vrcms

附录 A：快捷键一览

快捷键	功能
`Ctrl+N`	新建项目
`Ctrl+O`	打开工程文件
`Ctrl+S`	保存工程文件
`Ctrl+Q`	退出
F5	生成完整项目包
F6	对已有项目应用 CDN
F1	帮助文档
Esc	关闭对话框

附录 B：文件结构

输入（Pano2VR 输出）

Pano2VR 输出目录\
├── index.html
├── pano.xml
├── skin.js
├── pano2vr_player.js
├── tiles\        ← 多分辨率瓦片
├── images\       ← 图片素材
├── media\        ← 视频/音频
├── fonts\        ← 字体
└── ...

输出（含管理后台）

输出位置\项目名\
├── pano\                  ← Pano2VR 原始输出
├── admin\                 ← 管理后台
│   ├── assets\           ← Vue3 SPA（前端）
│   ├── api\              ← PHP API
│   ├── lib\              ← PHP 库
│   └── config.php        ← 配置（含密码）
├── README-部署说明.txt
└── CDN上传清单.txt        ← 如有 CDN

文档版本：v1.0
最后更新：2026-10-24
适用软件版本：v1.0+