常见问题汇总（v2.0）

[freejishu]

有关Core.php

为什么更换了数据来源，从 StatusPages 的接口变为了 v2 API 呢？

出于 json 数据经常变动的考虑。根据不完全观测，UptimeRobot 官方每更新一次 StatusPages ，相应的 json 数据就会出现变动。出现最多的还是字段名变动，而字段名变动之后因为没有太好的自适应的识别方案，只能非手工校改，会导致经常出现不可用的情况。为了提高可用性，同时为了引入更多功能做考虑，最终选择使用 json 结构不会经常变动的 v2 API 的接口（即https://uptimerobot.com/api/ ）。

UptimeRobot v2 API 会传递 url 、 http_username 、 http_password 、 port 等敏感字段，而我是不希望访客可以获得这些信息的，如何处理？

StatusLive v2.x 中提供了升级的隐私模式：以上信息会在core.php内被过滤掉，继而访客无法通过抓包获取这些字段。只需要参照隐私模式部署说明部署core.php即可。
如果还有更多想要屏蔽的字段，可以修改core.php的代码：

StatusLive/public/core.php

Lines 39 to 44 in 8affbe2

	for ($i = 0; $i < count($o['monitors']); $i++) {
	$o['monitors'][$i]['url'] = "";
	$o['monitors'][$i]['http_username'] = "";
	$o['monitors'][$i]['http_password'] = "";
	$o['monitors'][$i]['port'] = "";
	}

为什么新的Core.php部署在云函数等平台会出错？

出错位置可能出现在Line 49：

StatusLive/public/core.php

Line 49 in 8affbe2

file_put_contents($file_name, json_encode($json));

此处的写入文件操作，而无服务器云函数等此类平台往往不允许写入函数写入或没有写入权限。
如果想快速解决此问题，可以直接注释此行即可解决问题。但注意，因为 UptimeRobot API 存在请求速率限制，部署在无服务器云函数而没有缓存的情况下可能会导致间歇性请求超限（即UptimeRobot API 返回 419）。

可否具体解释为什么需要赋予core.php写入权限？

根据 UptimeRobot 文档的描述，API请求速率限制为：

FREE plan : 10 req/min
PRO plan : monitor limit * 2 req/min ( with maximum value 5000 req/min )

免费账户：10 次请求 / 分钟
Pro账户：（监控点数量上限*2）次请求 / 分钟（最高不超过 5000 次请求 / 分钟）

（更新于2021-09-16）

对于免费账户来说，如果状态页面略有请求量，API速率会很容易超限，故 v2.x 加入了缓存，缓存形式为简单的读写文件。
您可以在core.php中配置缓存时间和具体缓存目录或文件名：

StatusLive/public/core.php

Lines 7 to 11 in 8affbe2

	//json缓存目录，可自行配置
	$file_name = 'uptime.json';
	//缓存时间，单位为秒，为11秒是因为UptimeRobotAPI免费用户调用限制为6次/分钟
	$cache_time = 11;

请求core.php的过程中浏览器提示CORS错误，应该如何解决？

如果core.php没有和主页放在同一个域名下就会产生CORS也称跨域问题。根据服务器软件的不同有不同的解决方案，如Nginx：

    location ~ ^/.+\.php(/|$) {
        # ........
        if ($request_method = 'OPTIONS') {
          add_header 'Access-Control-Allow-Origin' '*';
          add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
          add_header 'Access-Control-Allow-Headers' 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range';
          return 204;
       }
       if ($request_method = 'POST') {
          add_header 'Access-Control-Allow-Origin' '*';
          add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
          add_header 'Access-Control-Allow-Headers' 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range';
          add_header 'Access-Control-Expose-Headers' 'Content-Length,Content-Range';
       }
       if ($request_method = 'GET') {
          add_header 'Access-Control-Allow-Origin' '*';
          add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
          add_header 'Access-Control-Allow-Headers' 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range';
          add_header 'Access-Control-Expose-Headers' 'Content-Length,Content-Range';
       }
    }

可根据具体服务器软件查找相关教程。

关于项目

未来是否计划提供类似于 v1.1 时的公用反代？

已经提供，请参考这篇说明使用：#15

发现了bug，如何处理？

可以在Issues下发布，也可以在Discussions下发布，也欢迎大家的PR~