6
0
0

白嫖 GitHub 当定时任务服务器:一份 YAML,把脚本变成 7×24 免费服务

文章摘要
|

痛点:定时任务的门槛,其实卡在"机器"上

写过脚本的人,十个里有九个动过"让它每天定点自动跑"的念头:定时抓点数据存档、每天早上生成一份报告、定时检查某个服务是不是还活着。但念头一到落地就卡住——买台 VPS 要花钱还得养;家里电脑不能 24 小时开机;手机装个 Termius 也得祈祷它别被系统杀后台。

最近在 GitHub 圈子和 B站 科技区里,「用 GitHub Actions 白嫖定时任务」是开发者们乐此不疲的玩法:公开仓库(public repository)里标准 GitHub-hosted runner 的使用量完全免费,一份 YAML 文件扔进仓库,你的脚本就能在 GitHub 的服务器上定点开跑。这篇文章从零带你跑通一遍,再附赠三个官方文档里写得明明白白、但 90% 教程都懒得提的坑——毕竟坑不提前踩,半夜任务静默失败的时候你连日志都没处看。

三块显示器组成的编程工作区

五分钟跑通第一个定时任务

在任何仓库里建目录 .github/workflows/,丢一个 daily.yml 进去,提交到默认分支,完事。这份文件已经把我们后面要讲的三个坑都提前规避了:

name: Daily Task

on:
  schedule:
    - cron: "33 7 * * *"
      timezone: "Asia/Shanghai"
  workflow_dispatch: {}

jobs:
  run:
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-python@v5
        with:
          python-version: "3.12"

      - name: Run script
        run: python main.py

      - name: Commit result
        run: |
          git config user.name "github-actions[bot]"
          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
          git add .
          git commit -m "chore: update data $(date -u +'%Y-%m-%d %H:%M') UTC" || echo "nothing to commit"
          git push

几个关键字段快速过一遍:

  • on.schedule:定时触发器,用的是 POSIX cron 语法,五个字段依次是分钟、小时、日、月、星期,"33 7 * * *" 就是每天 7:33;
  • timezone: "Asia/Shanghai":时区声明,2026 年 3 月才上的新特性,下面细说;
  • workflow_dispatch: {}:允许你在 Actions 页面手动点一下就触发,调试和保命都靠它;
  • permissions: contents: write:给自动生成的 GITHUB_TOKEN 授予写仓库的权限,最后一节要把结果 commit 回来就得用它;
  • runs-on: ubuntu-latest:标准 Linux runner,公开仓库免费额度覆盖的就是这类。

坑一:cron 默认按 UTC 跑——但现在不用心算了

翻遍中文互联网上的 Actions 教程,讲到时区基本都是同一句:「cron 用的是 UTC 时间,北京时间要自己减 8 小时」。你想让任务每天早上 7:30 跑,就得在脑子里换算成前一天晚上的 23:30,写成 "30 23 * * *"——时区差、夏令时、跨日,每一层都是心算事故现场。

这个痛点官方其实已经解决了:2026 年 3 月 19 日,GitHub 官方博客的 Actions 更新里宣布 scheduled workflows 支持时区声明,现在可以直接在 cron 条目旁边写一个 timezone 字段,值是 IANA 时区名:

on:
  schedule:
    - cron: "30 7 * * *"
      timezone: "Asia/Shanghai"

注意两点:timezone 是 schedule 条目级的字段,和 cron 平级、写在同一条里,别写到顶层去;另外官方文档特别提醒,如果你选的时区有夏令时(比如 America/New_York),春季时钟前拨时被跳过的时刻会顺延到下一个有效时间——选 Asia/Shanghai 就没有这个烦恼,中国不搞夏令时。

旧教程让你背「北京时间 = UTC + 8」,2026 年的正确姿势是直接声明 timezone: "Asia/Shanghai",让 GitHub 替你算。

坑二:整点挤兑——任务可能被延迟,甚至被丢弃

这是官方文档里白纸黑字写着、但极少有教程转述的一条。GitHub Actions 的 schedule 触发在高负载时段会被延迟,而高负载时段有一个非常稳定的来源:每个整点的开头——因为无数人写 cron 时分钟位都填了 0。原文说得很直白:负载够高的时候,排队中的任务可能被直接丢弃(dropped),官方给的建议是"把任务安排到小时内别的时间"。

所以开头那份 YAML 里,定时写的是 "33 7 * * *" 而不是 "0 8 * * *"——7:33 这种"脏时间"反而更稳。顺带一条硬限制:定时任务的最短运行间隔是 5 分钟,想搞每分钟轮询的可以死心了。

把运行结果存回仓库

定时任务跑完,结果总得有地方放。最优雅的做法是直接 commit 回仓库:数据变更历史天然变成 git log,公开仓库还不占你本地一颗字节。上面 YAML 最后那段 Commit result 已经是完整可复制的写法,其中 41898282+github-actions[bot]@users.noreply.github.com 是 GitHub 官方机器人的 noreply 邮箱,这样提交记录会显示成标准的机器人身份。

配合一个带重试逻辑的 Python 脚本,就是一个生产可用的定时抓取任务。main.py 示例(依赖只有 requests,YAML 里可加一步 pip install requests 或提交 requirements.txt):

import json
import time
from datetime import datetime, timezone
from pathlib import Path

import requests


def fetch_with_retry(url: str, retries: int = 3, backoff: float = 2.0) -> dict:
    """带指数退避的 GET 请求,失败自动重试。"""
    for attempt in range(1, retries + 1):
        try:
            resp = requests.get(url, timeout=15)
            resp.raise_for_status()
            return resp.json()
        except requests.RequestException as exc:
            print(f"[{attempt}/{retries}] 请求失败: {exc}")
            if attempt == retries:
                raise
            time.sleep(backoff ** attempt)


def main() -> None:
    data = fetch_with_retry("https://httpbin.org/json")
    out = Path("data/latest.json")
    out.parent.mkdir(parents=True, exist_ok=True)
    payload = {
        "fetched_at": datetime.now(timezone.utc).isoformat(),
        "data": data,
    }
    out.write_text(json.dumps(payload, ensure_ascii=False, indent=2), encoding="utf-8")
    print(f"saved -> {out}")


if __name__ == "__main__":
    main()

把 https://httpbin.org/json 换成你真正想抓的公开 API,把解析逻辑写进 main(),这个骨架就能直接上岗。重试加指数退避不是可选项——定时任务跑在凌晨,网络抖一下就把当天数据丢了,才是最气人的失败方式。

坑三:60 天不动仓库,GitHub 会把你的定时任务关掉

最后这个坑最隐蔽:官方规则是,公开仓库如果连续 60 天没有任何仓库活动,scheduled workflow 会被自动禁用。你信心满满部署完,头两个月天天看日志,第三个月忙别的去了,某天突然发现任务早就停了——而且它不会通知你。

两个对策:

  • 让任务自己保活:把结果 commit 回仓库这个动作本身就构成仓库活动,正好和上一节形成闭环,一石二鸟;
  • 发现被禁用了也别慌,去仓库的 Actions 标签页,被禁用的 workflow 旁边有 Enable 按钮一键复活;平时留着 workflow_dispatch,任何时候都能手动补跑一次。

顺带一个容易懵住的相关规则:schedule 触发只认默认分支。你在 dev 分支上把 cron 改得飞起,默认分支上的那份 YAML 不动,定时任务就纹丝不动。改了触发时间不生效,第一时间检查自己是不是在非默认分支上改的。

进阶小抄:三个值得加上的配置

1. 并发去重。 任务偶尔跑得慢,上一轮还没结束下一轮又启动,两份任务同时写同一个文件就是数据事故。在 workflow 顶层加上:

concurrency:
  group: daily-task
  cancel-in-progress: false

同一个 group 里的任务会排队执行,cancel-in-progress: false 表示不掐掉正在跑的那一轮,新任务乖乖等它跑完。

2. 密钥走 Secrets。 API key 永远不要硬编码进 YAML 或脚本——公开仓库等于把钥匙插在门上。仓库 Settings → Secrets and variables → Actions 里添加,脚本里用 os.environ["MY_TOKEN"] 读取,Actions 会自动注入环境变量。

3. 心里有额度账。 公开仓库标准 runner 免费;私有仓库消耗每月赠送额度,个人 Free 账户是每月 2000 分钟。一个每天跑 2 分钟的小脚本一个月才 60 分钟,完全不用担心;但如果你打算跑每小时一次、每次 10 分钟的重活,一个月 7200 分钟就爆了——这种还是老老实实上服务器。另外任务失败时 GitHub 默认会给仓库所有者发邮件通知,不用额外配置。

写在最后

回头看,整套方案的成本是:一个 GitHub 账号、一份不到 30 行的 YAML、一个 Python 脚本。换来的是 7×24 小时定点执行、免费的运行环境、git 原生的数据存档,以及 Actions 页面里每次运行的完整日志。三个坑记住就够:时区用 timezone 字段声明、cron 分钟位错开整点、60 天仓库活动保活。

它不适合替代正经的服务器——长任务、大内存、有状态的服务都不行。但「每天帮我抓个数据、生成份报告、检查个服务」这类轻量任务,这就是目前性价比最高的答案,没有之一。

以上内容为 GLM 5.3 Agent 整合定时发布。

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或者给予支持!

白嫖 GitHub 当定时任务服务器:一份 YAML,把脚本变成 7×24 免费服务
/archives/tech-blog-2026-10-31
作者
番茄酱唉
发布于
2026-10-31
许可协议
CC BY-NC-SA 4.0

评论

欢迎来到我的博客!