2
0
0

没有服务器也能跑定时脚本:一个 YAML 文件,让 GitHub 每天免费替你干活

文章摘要
|

一、想每天自动跑个脚本,为什么第一反应是买服务器?

「帮我每天早上抓一下这个网站的价格」「每天定时备份一下配置」「每晚十二点跑个签到」——这类需求每隔几天就会在各个群里出现一次。而下面的回复往往高度一致:买个最便宜的 VPS、装个 crontab、写个脚本。于是为了一个每天跑三十秒的脚本,你开始操心服务器续费、SSH 保活、系统更新和磁盘被打满。

其实只要你有一个 GitHub 账号,这件事可以完全免费:GitHub Actions 的 scheduled workflow,本质上就是 GitHub 白送你一台每天定时开机的虚拟机。跑到仓库里、日志自动留、失败能重跑、代码改了下次自动生效。顺便说一句,你现在看到的这篇文章,就是类似思路的定时任务在每天清晨自动发布的——一个没有自己 VPS 的写作者,也完全撑得起一个日更博客的自动化管线。

这个玩法最近在社区里热度不低:腾讯云开发者社区和 dev.to 上都有新的实战文在聊它,而 GitHub 官方今年还给 schedule 触发器加了一个盼了很多年的能力——直接写时区。本文从零跑一遍,并把这些新东西和官方盖章的坑一起讲清楚。

二、原理六十秒:把仓库当成免费定时器

GitHub Actions 本来是给 CI/CD 用的:代码一 push 就自动跑测试、打包。但它同时支持 schedule 触发器——按 cron 表达式定时启动。也就是说,你只要把脚本放进一个仓库,再放一个 YAML 文件告诉它"每天几点跑",剩下的一切 GitHub 包了。

费用方面,官方文档写得很直白:公开仓库(public repository)里标准 runner 的用量免费;私有仓库按账户计划送时长,Free 计划每月 2000 分钟(Linux 标准 runner)。每天跑一分钟的小任务,公开仓库随便跑,私有仓库一个月也就三十来分钟,零头都不到。

限制也摆在这:单个 job 最长 6 小时(定时任务几乎不可能碰到),最短调度间隔 5 分钟。个人自动化场景完全够用。

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

随便建一个仓库(建议先 public,白嫖额度最省心),在里面新建这个路径的文件:.github/workflows/hello.yml(注意 .github 是隐藏目录):

name: hello-schedule

on:
  schedule:
    - cron: "23 14 * * *"   # UTC 14:23 = 北京 22:23
  workflow_dispatch: {}      # 允许手动触发,调试用

jobs:
  hello:
    runs-on: ubuntu-latest
    steps:
      - run: echo "Hello from a scheduled workflow!"

提交到默认分支,然后到仓库的 Actions 标签页选中它,点 Run workflow——不用等定时,手动就能验证。看到绿勾,你的"免费服务器"就上线了。

cron 表达式是五段式:分、时、日、月、星期。语法就四个符号,官方文档的表格:

  • * 任意值:15 * * * * 每小时第 15 分钟跑一次;
  • , 值列表:2,10 4,5 * * * 每天 4 点和 5 点的第 2、10 分钟;
  • - 范围:30 4-6 * * * 4、5、6 点的 30 分;
  • / 步进:20/15 * * * * 从 20 分起每 15 分钟一次,即 20、35、50 分。

还有个很多人不知道的细节:同一个 workflow 可以挂多个 schedule,脚本里用 github.event.schedule 就能拿到"这次是哪条 cron 触发的",按需分支处理。

四、2026 年的新东西:cron 旁边直接写 Asia/Shanghai

过去最劝退的一步是换算时区:GitHub 的 cron 默认按 UTC 跑,"北京时间每天早上 7 点半"要脑内减八小时写成 30 23 * * *,夏令时地区更是一年错两次。今年官方补上了这块短板——schedule 触发器支持 IANA 时区字符串,官方文档原文的示例:

on:
  schedule:
    - cron: '30 5 * * 1-5'
      timezone: "America/New_York"

照抄格式,把时区换成我们的:

on:
  schedule:
    - cron: "17 0 * * *"
      timezone: "Asia/Shanghai"   # 北京时间每天 00:17

注意 timezone 写在 cron 条目里面(缩进与 cron 对齐)。带夏令时的时区还有个贴心规则:春令时跳过的那一小时,任务会顺延到下一个有效时刻——比如 2:30 的任务在"时钟拨快"那天会自动落到 3:00,官方文档原文明说。北京没有夏令时,安心用。

五、实战:给心仪的仓库记 star 增长日记

热身结束,来做个真有用的:每天自动记录几个 GitHub 仓库的 star 数,存成 JSON 提交回仓库。跑一个月你就有一份任意仓库的增长曲线原始数据——哪个项目在悄悄起飞,一眼可见。这个玩法来自 dev.to 上最近流行的一个 pattern:把仓库 commit 成数据集,再把 raw 地址当免费 API 读。

GitHub 新建仓库页面,填写仓库名称与描述

仓库结构很简单:

.
├── .github/workflows/stars.yml
├── daily_stars.py
├── requirements.txt      # 内容就一行:requests
└── data/                 # 数据目录,脚本自动创建

抓取脚本(Python 标准姿势,五十行以内):

"""每天给关注的仓库记一笔 star 快照。"""
import json
import os
from datetime import date, datetime, timezone

import requests

REPOS = ["anthropics/skills", "vercel/next.js"]   # 换成你想盯的仓库
HISTORY_FILE = "data/stars.json"

API = "https://api.github.com/repos/{}"
HEADERS = {"Accept": "application/vnd.github+json"}
TOKEN = os.environ.get("GITHUB_TOKEN")   # Actions 里自带;本地跑没有也能用
if TOKEN:
    HEADERS["Authorization"] = f"Bearer {TOKEN}"


def fetch_stars(repo: str) -> int:
    r = requests.get(API.format(repo), headers=HEADERS, timeout=15)
    r.raise_for_status()
    return r.json()["stargazers_count"]


def main() -> None:
    if os.path.exists(HISTORY_FILE):
        with open(HISTORY_FILE, encoding="utf-8") as f:
            history = json.load(f)
    else:
        history = {}

    today = date.today().isoformat()
    snap = {"date": today,
            "recorded_at": datetime.now(timezone.utc).isoformat(timespec="seconds")}

    for repo in REPOS:
        stars = fetch_stars(repo)
        # 同日重跑只覆盖当日记录,不会刷屏
        entries = [e for e in history.get(repo, []) if e["date"] != today]
        entries.append({"date": today, "stars": stars})
        history[repo] = entries
        snap[repo] = stars
        print(f"{repo}: {stars} stars")

    with open(HISTORY_FILE, "w", encoding="utf-8") as f:
        json.dump(history, f, ensure_ascii=False, indent=2)

    # 顺手存一份「当天快照」,raw 地址直接可读
    with open("data/latest.json", "w", encoding="utf-8") as f:
        json.dump(snap, f, ensure_ascii=False, indent=2)


if __name__ == "__main__":
    main()

几个设计点:GITHUB_TOKEN 是 Actions 运行时自动注入的环境变量,带上它 API 限额从匿名档提到账号档,盯的仓库一多这行就是保命的;本地调试时它不存在,脚本自动退回匿名请求,两边都能跑。latest.json 是"最后一次快照",比如 https://raw.githubusercontent.com/<用户名>/<仓库名>/main/data/latest.json——这个 URL 就是一个免注册、无限流、还能被任何程序直接消费的 JSON API。

编排它的 workflow(本文集大成版,时区、手动触发、依赖缓存、自动提交全都有):

name: star-diary

on:
  schedule:
    - cron: "17 0 * * *"
      timezone: "Asia/Shanghai"   # 北京时间每天 00:17
  workflow_dispatch: {}

permissions:
  contents: write        # 允许 GITHUB_TOKEN 推送提交

jobs:
  snapshot:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

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

      - run: pip install -r requirements.txt

      - run: python daily_stars.py

      - name: Commit snapshot
        run: |
          git config user.name "github-actions[bot]"
          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
          git add data/
          if ! git diff --cached --quiet; then
            git commit -m "chore: star snapshot $(date -u +%F)"
            git push
          else
            echo "No changes, skip commit."
          fi

提交这俩文件,当天就能手动 Run workflow 验证。此后每天 00:17,GitHub 的虚拟机自动开机、装依赖、跑脚本、提交数据、关机,全程几十秒,你连它在跑都不知道。一段小解释:permissions: contents: write 是显式给这次运行"推代码"的权限,默认的令牌偏只读;commit 那步先 git diff --cached --quiet 检查暂存区,没变化就跳过——免得哪天 API 抽风,仓库里多出一堆空提交污染历史。如果你的仓库里还有别的 push 触发的 workflow,给 commit message 加个 [skip ci] 可以避免连环触发。

六、六个官方盖章的坑,先知道再上车

  • 整点扎堆,能躲就躲:官方文档明说整点前后是调度高峰,"高负载时排队任务可能被直接丢弃",建议挑 17、23、41 这种没人抢的分钟。我的例子全用了奇数分钟,不是巧合。
  • schedule 只认默认分支:workflow 文件必须存在于默认分支,且定时任务永远在默认分支上跑。你在开发分支上改了 cron,一点用没有。
  • 公开仓库 60 天不活动会被休眠:官方规则,仓库 60 天没有任何活动,定时任务自动停用。数据仓库自己每天有 commit,反而是最不容易被休眠的;纯只读型任务记得偶尔手动触发一次或随便推个提交。
  • 延迟是常态,不是故障:高峰期晚个几分钟甚至十几分钟都正常,它不是你家的闹钟,是"大致这个点"。对时间精度有执念的任务(整点抢购之类)别指望它。
  • fork 默认不跑:fork 别人的仓库,Actions 默认禁用,记得去 Actions 页手动启用——这个"防呆"救过很多人的时间线。
  • YAML 的 on 是个布尔陷阱:YAML 1.1 规范里裸写的 on 会被解析成布尔值 true。GitHub 自己能正确处理,但你要是写脚本解析自己的 workflow(比如校验工具),Python 的 PyYAML 会把 on 键读成 True,查这个问题能查到怀疑人生。写成 "on": 加引号可以避坑。

七、还能再进一步

跑通之后,这个模式可以无限生长:把 daily_stars.py 换成任何脚本,就是你的下一个自动化项目——每天抓价格存进仓库、每周生成一份 RSS 汇总、定时备份你的 dotfiles、甚至给博客自动生成 sitemap。想要失败时收到通知,在 job 末尾加一步 if: failure() 的 curl,把消息打到飞书/企业微信/ntfy 的 webhook 就行(和之前 Beszel 那篇的通知思路一致,URL 格式可以互相参考)。数据攒多了,还可以开 GitHub Pages 用静态页面画趋势图——毕竟数据和页面住在同一个仓库里,这是任何服务器方案都没有的顺滑。

没有服务器,从来不是自动化的门槛——你缺的只是一个 YAML 文件。

八、总结

一个仓库、两个文件、零成本:GitHub Actions 的 scheduled workflow 给了个人开发者最轻松的定时任务方案——免费额度管够、日志自带、代码即配置,2026 年连时区都能直接写 Asia/Shanghai。记住那几条官方规则:错开整点、默认分支、60 天防休眠,剩下的就是把想自动化的东西一个一个搬进去。从今天起,「买服务器」应该排在「写好 YAML」之后才对。

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

支持与分享

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

没有服务器也能跑定时脚本:一个 YAML 文件,让 GitHub 每天免费替你干活
/archives/tech-blog-2026-11-11
作者
番茄酱唉
发布于
2026-11-11
许可协议
CC BY-NC-SA 4.0

评论

欢迎来到我的博客!