小岳
2026-11-13
点 赞
0
热 度
0
评 论
0

用 GitHub Actions 每天给自己发一封天气邮件(零服务器)

  1. 首页
  2. 有趣小玩意
  3. 用 GitHub Actions 每天给自己发一封天气邮件(零服务器)

文章摘要

摸鱼小助手

用 GitHub Actions 每天给自己发一封天气邮件(零服务器)

读者假设:有 GitHub 账号,会复制粘贴。 需要:一台能上网的电脑(只在配置时用),10 分钟。 成品:每天早上 7:00,邮箱里收到一封"今天多少度、要不要带伞"的短信级别邮件。

一、为什么是 GitHub Actions

你可能有云服务器,但为一个"每天发封邮件"的小需求占一台机器、开个 cron、配个 SSL,性价比太低。

GitHub Actions 正好干这个:

  • 免费:公开仓库不限分钟数,私有仓库每月 2000 分钟(Linux),这个任务每次只跑 20 秒
  • 免运维:不用管机器、不用管进程活着没有
  • 有日志:跑失败能看是哪一步崩的
  • 能改:改代码 push 一下就行

它本来是给 CI/CD 用的,但"定时跑个脚本"完全在能力范围内——这就是一台免费的、带定时器的、能联网的机器。

二、准备两样东西

1. 一个能发信的邮箱

本文用两种最常见的:

邮箱 SMTP 服务器 端口 密码用什么
Gmail smtp.gmail.com 465 应用专用密码(16 位,不是登录密码)
QQ 邮箱 smtp.qq.com 465 授权码(在设置里生成)

Gmail 怎么拿应用专用密码:

  1. 账号 → 安全性 → 打开"两步验证"(必须先开)
  2. 搜索"应用专用密码" → 生成 → 得到一个 16 位字符串
  3. 复制下来,页面关掉就看不到了

QQ 邮箱怎么拿授权码:

  1. 设置 → 账户 → 找到"POP3/IMAP/SMTP 服务"
  2. 开启 SMTP 服务(需要短信验证)
  3. 得到一串授权码

2. 一个 GitHub 仓库

新建一个公开仓库(公开才不限分钟数),名字随意,比如 daily-weather。

用私有仓库也行,只是要花配额。本文按公开写。

三、第一步:把密码存进 Secrets

别把密码写进代码。GitHub 有专门的加密存储:

仓库页面 → Settings → 左侧 Secrets and variables → Actions → New repository secret

建两个:

Name: MAIL_USER      Value: 你的邮箱地址(如 you@gmail.com)
Name: MAIL_PASS      Value: 刚才拿到的应用专用密码 / 授权码

建完列表里显示名字,值是隐藏的——这是对的。

四、第二步:写天气脚本

在仓库里新建文件 send.py,整段复制:

import os
import json
import smtplib
import urllib.parse
import urllib.request
from email.mime.text import MIMEText
from email.header import Header
from datetime import datetime

# ===== 改这三处 =====
LAT, LON = 39.9042, 116.4074      # 北京;换成你所在城市的经纬度
CITY = "北京"
TO = os.environ["MAIL_USER"]      # 发给自己
# ==================

MAIL_USER = os.environ["MAIL_USER"]
MAIL_PASS = os.environ["MAIL_PASS"]
SMTP_HOST = "smtp.gmail.com"      # QQ 邮箱改成 smtp.qq.com
SMTP_PORT = 465

def fetch_weather():
    params = {
        "latitude": LAT,
        "longitude": LON,
        "daily": "temperature_2m_max,temperature_2m_min,precipitation_probability_max,weathercode",
        "timezone": "Asia/Shanghai",
        "forecast_days": 3,
    }
    url = "https://api.open-meteo.com/v1/forecast?" + urllib.parse.urlencode(params)
    with urllib.request.urlopen(url, timeout=20) as resp:
        return json.load(resp)

WMO = {
    0: "晴", 1: "多云间晴", 2: "多云", 3: "阴",
    45: "雾", 48: "雾凇",
    51: "小毛毛雨", 53: "毛毛雨", 55: "大毛毛雨",
    61: "小雨", 63: "中雨", 65: "大雨",
    71: "小雪", 73: "中雪", 75: "大雪",
    80: "阵雨", 81: "强阵雨", 82: "暴雨",
    95: "雷阵雨", 96: "雷阵雨伴冰雹", 99: "强雷暴",
}

def build_html(data):
    d = data["daily"]
    rows = ""
    for i, day in enumerate(d["time"]):
        wc = d["weathercode"][i]
        rows += (
            "<tr>"
            f"<td>{day}</td>"
            f"<td>{d['temperature_2m_min'][i]} ~ {d['temperature_2m_max'][i]} ℃</td>"
            f"<td>{WMO.get(wc, '未知')}</td>"
            f"<td>{d['precipitation_probability_max'][i]}%</td>"
            "</tr>"
        )
    today = d["time"][0]
    return f"""
    <h3>{CITY} · {today}</h3>
    <table border="1" cellpadding="6" cellspacing="0" style="border-collapse:collapse;font-family:sans-serif">
      <tr><th>日期</th><th>气温</th><th>天气</th><th>降水概率</th></tr>
      {rows}
    </table>
    <p style="color:#888;font-size:12px">由 GitHub Actions 自动发送 · {datetime.now():%Y-%m-%d %H:%M}</p>
    """

def send(html):
    msg = MIMEText(html, "html", "utf-8")
    msg["Subject"] = Header(f"{CITY}今日天气 {datetime.now():%m-%d}", "utf-8")
    msg["From"] = MAIL_USER
    msg["To"] = TO
    with smtplib.SMTP_SSL(SMTP_HOST, SMTP_PORT, timeout=30) as s:
        s.login(MAIL_USER, MAIL_PASS)
        s.sendmail(MAIL_USER, [TO], msg.as_string())

if __name__ == "__main__":
    data = fetch_weather()
    html = build_html(data)
    send(html)
    print("已发送")

坐标怎么填

浏览器打开 https://www.openstreetmap.org,搜索你的城市,右键"显示地址"就能看到经纬度。比如:

城市 纬度 经度
北京 39.9042 116.4074
上海 31.2304 121.4737
深圳 22.5431 114.0579

别填反了:纬度(lat)在北半球是正数,经度(lon)在东半球是正数。

五、第三步:写 workflow

在仓库里新建 .github/workflows/weather.yml(注意目录名前面有个点):

name: daily-weather

on:
  schedule:
    # UTC 23:00 = 北京时间次日 07:00
    - cron: '0 23 * * *'
  workflow_dispatch:      # 允许手动点按钮触发,调试用

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

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

      - name: Send mail
        env:
          MAIL_USER: ${{ secrets.MAIL_USER }}
          MAIL_PASS: ${{ secrets.MAIL_PASS }}
        run: python send.py

这个任务不需要 pip install——脚本只用了标准库。

时区是最大的坑

cron 永远按 UTC 计算,不是你的本地时间:

想要北京时间 07:00  →  UTC 前一天 23:00  →  0 23 * * *
想要北京时间 08:00  →  UTC 00:00         →  0 0 * * *

很多人写 0 7 * * *,结果每天下午三点收到邮件,就是这里错了。

六、第四步:手动跑一次

先别等定时。进仓库 → Actions 标签页 → 左边选 daily-weather → 右边 Run workflow → 绿色按钮。

等十几秒,进这次运行,点开 Send mail 步骤,看到:

Run python send.py
已发送

然后去邮箱收信。

你应该看到

一封标题类似 北京今日天气 11-13 的邮件,正文是一张三天的表格:

日期          气温            天气    降水概率
2026-11-13   6.2 ~ 15.8 ℃    晴      0%
2026-11-14   7.1 ~ 16.3 ℃    多云    10%
2026-11-15   5.4 ~ 13.9 ℃    小雨    65%

收到就成功了。之后每天早上 7 点自动来一封,直到你删掉这个仓库。

七、六个常见故障

现象 原因 处理
手动能跑,定时不跑 定时只在默认分支生效,且仓库 60 天无提交会被自动暂停 确认代码在 main 分支;偶尔 commit 一次;或重新 enable workflow
邮件没收到 进了垃圾箱 检查垃圾邮件;把发件人加白名单
535 Authentication failed 用了登录密码 换成应用专用密码 / 授权码
ConnectionRefusedError 端口选错 465 用 SMTP_SSL,587 用 starttls()
KeyError: 'MAIL_USER' Secrets 没建,或建在了别的仓库 检查 Settings → Secrets → Actions
天气数据取不到 Open-Meteo 偶发超时 脚本里加重试,或换个时间点跑

另外两点要知道:

  • GitHub 的定时任务不保证准时。官方文档明确说高峰期可能延迟几分钟到几十分钟,极端情况下会跳过当次。要精确到分钟的任务别放这儿。
  • fork 别人的仓库不会继承 Secrets,得自己在 fork 里重新建。

八、还能改成什么

这套骨架(定时 + 脚本 + Secrets)能做的事很多,只换中间那步:

  1. 加一句"今天要不要带伞":降水概率 > 50% 就在标题前加 ☔
  2. 多个城市:把坐标做成列表,循环发多封
  3. 推送到微信/Telegram:把 send() 换成一个 webhook POST
  4. 顺带播报日程:从 Notion/飞书 API 拉今天的待办塞进正文
  5. 代替天气 App:把 forecast_days 改成 7,一周都不用开 App

九、出处与参考

脚本在 Python 3.12 + GitHub Actions ubuntu-latest 上验证。Open-Meteo 是免费公共服务,请勿高频调用;个人每天一次完全在合理范围内。


本站站长,主角光环,怎么滴,你还想攻击你的站长吗,真是好big的狗胆

小岳

intp 逻辑家

站长

不具版权性
不具时效性

文章内容不具时效性。若文章内容有错误之处,请您批评指正。

目录

欢迎来到摸鱼干货栈,这里为您提供开源与摸鱼源码

43 文章数
7 分类数
0 评论数
47标签数
最近评论