illerin/panopath

PanoPath镜像说明

镜像概述

PanoPath是一个自托管的Docker工具，用于构建交互式360°全景漫游。您可以上传全景图片，添加热点，配置品牌标识，放置平面图标记点，然后导出一个可独立部署的ZIP包，可在任何地方托管。

核心功能

• 上传等距全景图片（支持JPG、PNG、HEIC/HEIF、TIFF、WebP格式）
• 支持非全景图片
• 多分辨率立方体面切片（服务端处理，无需GPU）
• 信息热点（点击展开文本）和链接热点（场景间导航）
• 7种链接热点图标样式（相机、箭头、门、星星、眼睛、位置），颜色可完全自定义
• 平面图覆盖层，支持按场景放置标记点，可选圆形或方向箭头样式
• 品牌配置：logo、3个自定义文本/背景颜色的按钮及新标签页切换选项
• 设置：自动旋转、全屏按钮、缩放按钮、指南针、鼠标模式
• 为每个场景设置起始视图及默认加载场景
• 编辑器中实时预览品牌和热点颜色
• 样式预设：按名称保存和重新加载所有外观设置
• 导出为独立ZIP包（包含HTML + 切片 + project.json）
• 从服务器保存和加载项目，或通过ZIP导入
• 完全本地运行：无云上传，无需账户

使用场景

• 旅游景点虚拟导览：展示景区全景，方便用户在线游览
• 房地产虚拟看房：让潜在买家通过全景查看房屋布局和细节
• 博物馆/展览虚拟参观：提供沉浸式的线上展览体验
• 企业展厅展示：企业产品或办公环境的全景展示

配置说明

1. 部署镜像后，访问对应端口进入编辑器界面
2. 上传全景图片，创建新场景
3. 添加热点（信息或链接类型），自定义图标和颜色
4. 配置品牌标识（logo、按钮等）
5. 设置平面图及标记点
6. 调整全局设置（自动旋转、全屏等）
7. 导出ZIP包用于部署

Docker部署示例

Docker Run命令

bash
docker run -d -p 8080:80 --name panopath illerin/panopath

访问 http://localhost:8080 即可使用。

Docker Compose示例

yaml
version: '3'
services:
  panopath:
    image: illerin/panopath
    ports:
      - "8080:80"
    container_name: panopath
    restart: always

保存为 docker-compose.yml，执行 docker-compose up -d 启动服务。