krpano本地测试服务器 | krpano Testing Server

更新 krpano 1.20.5

krpano Testing Server 是一个轻便简单易用的静态文件本地主机服务器。无需安装或设置。可以跳过本地文件安全限制且无需上传就能测试效果。其他本地网络的计算机和设备也可以在浏览器中输入ip地址来浏览文件。另外它也可以控制浏览器缓存、限制下载速度来模拟更慢的网络条件,每一次更换文件时也无需清空浏览器缓存。

windows系统

krpano 测试服务器(图形界面版本)

krpano 测试服务器(命令行版本)

MAC OSX系统

krpano 测试服务器(图形界面版本)

krpano 测试服务器(命令行版本)

命令行版本和图形界面所提供的功能是一样的,但命令行版本体积更小,而且不带有krpano标志,更适用于部署。

命令行参数:

  • -root=###
    • 设置服务器根文件夹。
    • 所有在该文件夹下的文件和文件夹可通过网络服务器获取。
    • 默认下使用当前文件夹。
  • -url=###
    • 设置启动服务器时应在浏览器中自动打开的url地址(相对于根文件夹)。
    • 默认下将打开根目录。
    • 如果在目录下有 index.html 或tour.html 或krpano.html ,则该文件会自动打开。
  • -interface=#
    • 选择IP地址。
    • 需要获取可用的IP,调用-interface=list
  • -port=###
    • 设置自定义网络端口。
    • 默认下使用随机的空闲端口。
  • -cors=###
    • 设置CORS HTTP header 允许其他域名的访问。
    • 设置值:true (默认)或者 false
  • -nocache=###
    • 设置http头控制浏览器缓存。
    • 设置值:
      • default – 只有文本文件没有缓存(html、xml、js等)。
      • all – 所有文件都没有缓存。
      • off – 没有明确的缓存控制。
  • -open=###
    • 在启动时打开什么。
    • 设置值:
      • default – 在默认浏览器上打开网络地址。
      • no – 什么都不做。
      • an app path – 将网络地址作为参数调用该应用。
  • -cert=###
    • 后缀为pem的ssl验证文件的路(针对HTTPS
  • -q
    • 静默模式,不输出信息窗口。

目录列表

krpano测试服务器提供了CSS样式化的目录列表,可供浏览文件和文件夹。如果需要自定义目录列表,可在服务器根目录下放置一个名为krpanotestingserver.css 的文件。

 

下载

krpano测试服务器包含在下载包中,图形界面版本在下载包根目录下,名为为krpano Testing Server,命令行版本在为html/templates/文件夹内,windows系统是tour_testingserver.exe 文件形式,Mac OSX系统是tour_testingserver_macos file 文件形式。

krpano测试服务器是独立的程序,可以重命名,适合于部署给终端用户。

 

HTTPS支持

最新的浏览器正在因越来越多的特性而强制使用https,例如今天的陀螺仪和VR,未来可能会涉及对全屏的支持。对于本地ip地址的https支持是可能的,但需要一些手动设置。注意,该设置只针对开发者和内容制作者并用于内部测试,切勿对一般终端用户使用。

步骤:

  1. 第一步,要将测试服务器所运行的计算机设置为固定ip地址。因为需要针对这个ip生成证书,如果ip地址更改,则需要生成新的证书。
  2. 使用mkcert可以非常方便地生成和管理证书。可以如这个地址所示手动安装,或者从这里下载预构建的二进制文件
  3. mkcert安装好后,运行一次下面命令:
    这将在系统上安装一个“证书颁发机构”证书,用于验证稍后将在浏览器中使用的证书。
  4. 然后使用这个证书生成一个你当前ip地址的证书,例如:
    A完成这个步骤后,你当前工作目录下就会生成192.168.0.100.pem192.168.0.100-key.pem文件。
  5. 这一步是针对iOS设备的:
    1. 复制192.168.0.100.pem文件到测试服务器(仍然以HTTP运行)的根目录。
    2. 在Safari浏览器中打开测试服务器地址,打开192.168.0.100.pem文件。浏览器会询问你加载证书,确认。
    3. 证书加载后需要手动安装,今日iOS设置app。可以看到一个新添加的证书。选择证书并安装(需确认多次)。
  6. 打卡krpano测试服务器的设置书签,通过SSL Certificate Browse按钮选择两个.pem文件中的一个,krpano测试服务器会自动寻找另一个.pem文件,也会将其加载。如果是使用命令行,则执行下面命令:
    来加载证书文件,让服务器以HTTPS服务器的形式运行。
  7. 几乎快要完成,现在在浏览器中打开测试服务器地址,但这次是使用https://而不是http://
    注意 – 这里不存在http或https重定向!必须输入正确的地址!
  8. 之前已经打开的其他浏览器会显示一个警告,这是因为“证书颁发机构”(这个情况下就是你的计算机)不是一个已知悉和可信任的机构
    但是浏览器应该浏览网站,不管是直接查看还是隐藏在“更多信息”或“高级”按钮后面。在确认这些警告(应该只需要一次)之后,路径现在应该可以使用https。

 

在 “krpano本地测试服务器 | krpano Testing Server” 上有 10 条评论

  1. 以前都不知道kr有这么好用的工具,还一直用Apache。看了肥宗大哥这篇文章,真的长知识了,多谢分享!

发表评论