教程前置#

Cloudflare 账号
Github 账号
lyc8503/UptimeFlare仓库（先别急着Fork）

✔ Cloudflare Workers 上的免费无服务器正常运行时间监控/状态页面，具有特定于地理位置的检查

提醒 color:cyan

由于使用了 Workers 来提供运行检查，所以请求数将会有较大的增加。

Demo: https://uptimeflare.pages.dev/

开始#

1.申请 `用于编辑Workers` 的Key#

如果先前有创建，可以使用。

在此处申请用于构建的api令牌

接着下一步，会显示出创建出的api，复制保存。

2.使用该仓库模板#

需要设置为私有，防止api泄露

新建好仓库后，在Settings - Secrets and variables - Actions处新建一个密钥，名字为CLOUDFLARE_API_TOKEN，将刚才保存的api放进去即可。

配置#

打开文件uptime.config.ts

页面配置#

1
const pageConfig = {
2
  title: "lyc8503's Status Page",
3
  links: [
4
    { link: 'https://github.com/lyc8503', label: 'GitHub' },
5
    { link: 'https://blog.lyc8503.site/', label: 'Blog' },
6
    { link: 'mailto:me@lyc8503.site', label: 'Email Me', highlight: true },
7
  ],
8
}

项目	说明
`title`	网站标题
`links`	顶部外部链接

根据 json 严格的语法规则，应该要严格地按照上方格式来填写。

补充 color:cyan

对于 json 排版可以有两种：

1
{ link: '...', label: '...'},
2
{ link: '...', label: '...'}

亦或者是

1
{
2
link: '...',
3
label: '...'
4
},
5
{
6
link: '...',
7
label: '...'
8
}

并且单引号和双引号都可以被识别

监控配置#

1
const workerConfig = {
2
  kvWriteCooldownMinutes: 3,
3
  passwordProtection: 'username:password',
4
  monitors: [
5
    {
6
      id: 'foo_monitor',
7
      name: 'My API Monitor',
8
      method: 'GET',
9
      target: 'https://www.google.com'
10
    },
11
    {
12
      id: 'test_tcp_monitor',
13
      name: 'Example TCP Monitor',
14
      method: 'TCP_PING',
15
      target: '1.2.3.4:22'
16
    },
17
    // You can continue to define more monitors here...
18
  ],
19
  notification: {
20
    //...
21
  },
22
  callbacks: {
23
    //...
24
  },
25
}

监控配置（monitors）#

监控的配置在 monitors 中配置，如上文，按照 json 语法进行编写。

单个监控的完整配置如下文

1
{
2
  id: 'foo_monitor',
3
  // `name` is used at status page and callback message
4
  name: 'My API Monitor',
5
  // `method` should be a valid HTTP Method or "TCP_PING" for TCP port monitor
6
  method: 'POST',
7
  // `target` is a valid URL for HTTP or hostname:port for TCP
8
  target: 'https://example.com',
9
  // [OPTIONAL] `tooltip` is ONLY used at status page to show a tooltip
10
  tooltip: 'This is a tooltip for this monitor',
11
  // [OPTIONAL] `statusPageLink` is ONLY used for clickable link at status page
12
  statusPageLink: 'https://example.com',
13
  // [OPTIONAL] `expectedCodes` is an array of acceptable HTTP response codes, if not specified, default to 2xx
14
  expectedCodes: [200],
15
  // [OPTIONAL] `timeout` in millisecond, if not specified, default to 10000
16
  timeout: 10000,
17
  // [OPTIONAL] headers to be sent with HTTP monitor
18
  headers: {
19
    'User-Agent': 'Uptimeflare',
20
    Authorization: 'Bearer YOUR_TOKEN_HERE',
21
  },
22
  // [OPTIONAL] body to be sent with HTTP monitor
23
  body: 'Hello, world!',
24
  // [OPTIONAL] if specified, the HTTP response must contains the keyword to be considered as operational.
25
  responseKeyword: 'success',
26
  // [OPTIONAL] if specified, the check will run in your specified region,
27
  // refer to docs https://github.com/lyc8503/UptimeFlare/wiki/Geo-specific-checks-setup before setting this value
28
  checkLocationWorkerRoute: 'https://xxx.example.com',
29
},

项目（带`*`为必选）	说明
*`id`	id应该是唯一的，如果id保持不变，历史记录将被保留（有大用！）
*`name`	`name`用于状态页面和回调消息
*`method`	`method`应该是TCP端口监视器的有效HTTP方法（例如`GET`）或`TCP_PING`。
*`target`	HTTP的有效URL或TCP的hostname
`tooltip`	用于状态页面显示工具提示
`statusPageLink`	用于状态页面上的可点击链接
`expectedCodes`	一个可接受的HTTP响应代码数组，如果未指定，默认为2xx
`timeout`	超时时间
`headers`	与HTTP监视器一起发送的标头
`body`	将与HTTP监视器一起发送
`responseKeyword`	如果指定，HTTP响应必须包含被视为可操作的关键字
`checkLocationWorkerRoute`	如果指定，检查将在您指定的区域运行

当然，这边建议只需要写必选即可，其他不写。

通知配置（notification）#

这个要用到Tg，因此我就不写了，具体看文档。

Setup notification · lyc8503/UptimeFlare Wiki

Callbacks#

默认即可，无需理会

部署#

等待Github Action自动部署即可，建议绑定一个自己的域名

拓展#

嵌入为 iframe#

在部署页面后，链接末尾加#id即可

效果：

JSON格式数据#

链接后加/api/data即可

1
{
2
  "up": 6,    // There're currently 6 up monitors...
3
  "down": 1,  // ...and 1 down monitors
4
  "updatedAt": 1719764731, // Last updated timestamp
5
  "monitors": {
6
    "www": {               // Key is `id` in config
7
      "up": true,          // Current status (boolean)
8
      "latency": 65,       // Latency at last monitor
9
      "location": "SIN",   // Datacenter used at last monitor
10
      "message": "OK"      // Description of current status (Error message in case of DOWN)
11
    },
12
    "homelab": {
13
      "up": false,
14
      "latency": 1896,
15
      "location": "SJC",
16
      "message": "HTTP response doesn't contain the configured keyword"
17
    },
18
    //......
19
  }
20
}