用 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 怎么拿应用专用密码:
- 账号 → 安全性 → 打开"两步验证"(必须先开)
- 搜索"应用专用密码" → 生成 → 得到一个 16 位字符串
- 复制下来,页面关掉就看不到了
QQ 邮箱怎么拿授权码:
- 设置 → 账户 → 找到"POP3/IMAP/SMTP 服务"
- 开启 SMTP 服务(需要短信验证)
- 得到一串授权码
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)能做的事很多,只换中间那步:
- 加一句"今天要不要带伞":降水概率 > 50% 就在标题前加 ☔
- 多个城市:把坐标做成列表,循环发多封
- 推送到微信/Telegram:把
send()换成一个 webhook POST - 顺带播报日程:从 Notion/飞书 API 拉今天的待办塞进正文
- 代替天气 App:把
forecast_days改成 7,一周都不用开 App
九、出处与参考
- GitHub Actions 文档:https://docs.github.com/actions
- 定时触发(含"60 天无活动自动暂停"与延迟说明):https://docs.github.com/actions/using-workflows/events-that-trigger-workflows#schedule
- Secrets 使用:https://docs.github.com/actions/security-guides/using-secrets-in-github-actions
- Open-Meteo 免费天气 API(无需 key):https://open-meteo.com/en/docs
- WMO 天气代码对照:https://open-meteo.com/en/docs#weathervariables
- Gmail 应用专用密码:https://support.google.com/accounts/answer/185833
脚本在 Python 3.12 + GitHub Actions ubuntu-latest 上验证。Open-Meteo 是免费公共服务,请勿高频调用;个人每天一次完全在合理范围内。
默认评论
Halo系统提供的评论