凭证别写进配置文件:分发脚本最容易忽视的一条红线
凭证别写进配置文件:分发脚本最容易忽视的一条红线
多平台分发工具天然站在凭证聚集的地方:它要在同一台机器上同时"是"B站、抖音、小红书、视频号的登录用户,还要往外推飞书卡片、拉站点后台数据、暴露一个能在手机上看的大屏。任何一个环节的凭证落错了地方,代价不是"配置错了",而是账号、群机器人、后台数据一起交出去。
这篇文章不谈空泛的安全原则,只顺着一个真实的开源分发工作台(本仓库 mdldm-maitian)的源码,把"凭证到底存在哪、.gitignore 挡不挡得住、哪些设计值得抄、复刻时该查什么"逐条走一遍。里面有一处非常具体的漏洞:配置文件被忽略了,它的备份没有被忽略。
分发工具为什么比普通脚本更容易踩线
先看它的攻击面构成。一个分发中控至少需要三种凭证:平台登录态、通知通道(群机器人 Webhook)、自有后台的读权限。三者失效模式完全不同——登录态会过期,Webhook 一旦泄露任何人都能往你的群里发消息,后台 token 泄露等于把收入数据交出去。
市面上常见的做法是"把 cookie 存成文件,上传时再读回来"。社区里被反复转发的自动化上传教程就是这个模式:先用 get_douyin_cookie.py 扫码拿到登录信息落盘,再由 upload_video_to_douyin.py 读取该文件去请求。这种写法本身没错,但它把凭证变成了一个普通的、可被复制、可被提交的项目文件,风险从"浏览器帮你管"转移到了"你自己管"。
麦田选了另一条路,README 里写得很直接:
跑在一台常开的 Mac 上,用你自己登录好的浏览器操作各平台,不存任何平台密码。
这不是宣传语,而是能追到代码的结构性选择。src/chrome-shim.mjs 启动专用 Chrome 时用的是独立 profile 目录:
const PROFILE = (config.chromeProfile || '~/publish-hub/chrome-profile').replace(/^~/, os.homedir());
const args = [`--user-data-dir=${PROFILE}`, `--remote-debugging-port=${PORT}`, ...];
spawn(BIN, args, { detached: true, stdio: 'ignore' }).unref();
平台登录态落在 chrome-profile/ 里,由 Chrome 自己加密保管;中控进程只通过 CDP(Target.attachToTarget + Runtime.evaluate)驱动页面,代码路径里根本没有"读取密码"这一步。相应地,.gitignore 第 4 行把 chrome-profile/ 整目录排除。
这张流程图里三块的边界,其实就是凭证边界:发布 skill 只产出文案和 publish.json(不含任何登录信息),插件负责在浏览器里填表,麦田负责调度和入库。凭证只在浏览器这一层存在,前后两端都碰不到它。
四类凭证在仓库里的真实落点
把 config.example.json 和实际写盘逻辑对照着看,能列出一张准确的清单:
| 凭证 | 存放位置 | 内容 | 是否入库 |
|---|---|---|---|
| 飞书群机器人 Webhook | config.json 的 feishuWebhook |
拿到即可向群内推任意卡片 | 否(被 .gitignore 挡) |
| 网页访问口令 | config.json 的 web.key |
所有页面和接口的准入凭证 | 否 |
| 小组件只读口令 | config.json 的 web.widgetToken |
仅能读汇总数字 | 否 |
| 多维表格 Base Token | config.json 的 board.baseToken |
读写看板数据 | 否 |
| 登录会话 | data/sessions.json |
只存 token 的 sha256 | 否 |
| 公网地址 | data/tunnel.json |
可能带 ?key= |
否 |
| 各平台登录态 | chrome-profile/ |
浏览器 cookie | 否 |
| 示例占位 | config.example.json |
全是"换成一串随机字符" | 是(故意入库) |
config.example.json 里所有敏感字段都是显式占位符,比如 "key": "换成一串随机字符,网页访问口令"、"feishuWebhook": ".../hook/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"。把示例文件入库、把真实文件排除,这是最基础也最容易被跳过的一步。
值得单独说的是 data/sessions.json。src/login.mjs 在落盘时做了两件事:只存会话 token 的哈希,且文件权限收紧到 0600:
const sha = s => crypto.createHash('sha256').update(s).digest('hex');
const save = () => { ...; fs.writeFileSync(FILE, JSON.stringify(sessions), { mode: 0o600 }); };
对比一下 src/init.mjs 生成配置的那行:
fs.writeFileSync(CFG, JSON.stringify(cfg, null, 2) + '\n');
没有 mode 参数,默认就是 0664 或 0644——同目录下 data/sessions.json 是 0600,装着 Webhook 和网页口令的 config.json 反而是任何本机用户可读。同一个仓库里两套标准,通常不是疏忽,而是"先跑起来再说"留下的痕迹。修法很小:{ mode: 0o600 } 加一个参数即可。
真正的红线:config.json 被忽略了,config.json.bak 没有
这是本文要说清的那一条。仓库的 .gitignore 只写了:
config.json
data/
node_modules/
chrome-profile/
logs/
scratch/
state/
scripts-*.sh
MAINTENANCE.md
demo/
而安装向导 src/init.mjs 在重新生成配置时,会先做一次备份:
if (fs.existsSync(CFG)) fs.copyFileSync(CFG, CFG + '.bak');
fs.writeFileSync(CFG, JSON.stringify(cfg, null, 2) + '\n');
于是磁盘上多了一个 config.json.bak,它包含上一版配置的全部原文——Webhook、web.key、widgetToken、board.baseToken,一字不少。而 .gitignore 的模式是 config.json,精确匹配这个文件名,不含 .bak 后缀。实测确认:
| 路径 | 是否被忽略 |
|---|---|
config.json |
忽略 |
config.json.bak |
未忽略 |
data/sessions.json |
忽略 |
data/tunnel.json |
忽略 |
demo/config.json |
忽略(无斜杠模式匹配任意层级) |
这意味着一个非常日常的操作序列就能把凭证送进历史:
- 用向导生成
config.json,填了飞书 Webhook 和网页口令; - 后来改了 NAS 路径或站点地址,重跑
node src/init.mjs; - 向导提示"已经有 config.json,要重新生成吗",回车确认;
- 生成
config.json.bak,里面有旧的口令和 Webhook; git add -A && git commit,或者提交一个 PR。
第 5 步几乎必然会踩中,因为开发者对 git add -A 的心理模型是"我的敏感文件已经被 ignore 了"。README 的"数据和隐私"一节也是这么承诺的:
config.json、data/(数据库、日志)、chrome-profile/(各平台登录态)都不进 git。
文档说的是对的,代码也基本做到了,只差了一个后缀。偏偏那个后缀是向导自动创建的,用户并没有主动新增一个文件——这类漏洞最难靠自觉发现,因为用户根本没做错什么。
顺带一提,config.local.json、config.prod.json、编辑器临时备份 config.json~、config.json.swp 同样都不在规则内。手写 .gitignore 时用精确文件名,几乎总会在某个备份后缀上漏一次。
修复建议是把规则从"精确文件"改成"按前缀排除 + 显式放行示例":
# 配置文件:只放行示例
config*.json
!config.example.json
*.bak
*.orig
改完后必须验一遍,而不是凭感觉:
git check-ignore -v config.json config.json.bak config.local.json config.example.json
期望结果是前三个各输出一条命中 .gitignore 的记录,config.example.json 无输出(因为被 ! 反选回来)。这一步值得写进贡献指南,因为它的成本是 3 秒,收益是永久。
如果凭证已经进过历史,仅靠删文件是不够的——git rm --cached 之后历史里仍然完整保留。要么用 git filter-repo 重写,要么按下面的顺序轮换:飞书群机器人重建(旧 Webhook 作废)、重跑 init.mjs 换 web.key、改 web.widgetToken、重建多维表格应用拿新 baseToken。轮换永远比重写历史更便宜,尤其是在仓库已被 fork 之后。
最小权限:这个仓库里几个值得抄的细节
撇开那处 .bak,麦田在权限分层上做了不少克制而准确的设计,值得直接借鉴。
口令按用途拆分,而不是一个万能 key。 手机小组件需要一个长期有效的凭证放在 Scriptable 脚本里,这个脚本用户可能会截图、转发。于是 config.web 里单独给了一个 widgetToken,服务端只在三个路径上放行它:
if (u.pathname === '/api/widget') return W.widgetToken && tokenEq(u.searchParams.get('t') || req.headers['x-widget-token'], W.widgetToken) ? send(res, 200, widgetData()) : send(res, 401, { error: '小组件口令不对' });
/api/widget(汇总数字)、/api/widget/code(脚本代码)、/api/widget/img(头像和封面缩略图)——全部是只读的聚合数据,拿不到任何一期明细、日志或写操作接口。/widget 安装页里也把这个边界直接写给用户看:"脚本里带着小组件口令,只能读汇总数字,打不开麦田别的页面。别发给别人;泄露了在 config.json 换一个 widgetToken 即可。"
口令比较用的是定长常量时间比较,避免按字节比较带来的时序侧信道:
const tokenEq = (a, b) => typeof a === 'string' && typeof b === 'string' && a.length === b.length && crypto.timingSafeEqual(Buffer.from(a), Buffer.from(b));
外网入口交给身份提供商,不自己造轮子。 src/access.mjs 处理 Cloudflare Access 签发的 JWT,做的是完整校验而不是"看到请求头就放行"——RS256 算法白名单、按 kid 取公钥验签、校验 aud 与 iss、检查过期、可选邮箱白名单:
if (head.alg !== 'RS256') return null;
if (!crypto.verify('RSA-SHA256', Buffer.from(`${h}.${p}`), k, b64(s))) return null;
const aud = [].concat(body.aud || []);
if (!aud.includes(A.aud) || body.iss !== `https://${A.team}` || !(body.exp * 1000 > Date.now())) return null;
if (A.emails?.length && !A.emails.map(e => e.toLowerCase()).includes(String(body.email || '').toLowerCase())) return null;
注释里那句"所以局域网里伪造请求头进不来"是有代码支撑的:没有验签,cf-access-jwt-assertion 就是一个用户可随手伪造的字符串。
自建验证码登录把可爆破面压到很小。 src/login.mjs 的常量定义几乎就是一份限流说明书:验证码 5 分钟有效、只能使用一次、错 5 次作废、60 秒内只能发一次、每小时最多 10 次;会话 token 是 32 字节随机数,库里只存 sha256;Cookie 带 HttpOnly、SameSite=Lax,且在 HTTPS 下才追加 Secure:
const CODE_TTL = 5 * 60e3, SESSION_DAYS = 30, MAX_TRIES = 5, RESEND_MS = 60e3, MAX_PER_HOUR = 10;
send(res, 200, { ok: true }, 'application/json; charset=utf-8', { 'set-cookie': `mt_sess=${t}; Path=/; Max-Age=${SESSION_DAYS * 86400}; HttpOnly; SameSite=Lax${isHttps(req) ? '; Secure' : ''}` });
还有一个非常容易忽略的细节:验证码推送走飞书的 quiet 模式。src/feishu.mjs 里 notify 默认会把文本打到控制台和日志,而 quiet: true 时跳过——验证码因此不会出现在 data/daemon.log 里:
export async function notify(text, { quiet = false } = {}) {
if (!quiet) console.log(`[飞书] ${text.replace(/\n/g, ' | ')}`); // quiet:验证码之类的不写日志
平台侧的权限同样收敛。 skills/maitian-publish/SKILL.md 的"安全红线"写着"只操作你自己的账号;不做评论、点赞、私信、关注这类互动自动化",README 的隐私段落也重复了一遍。国内四家平台的最终发布动作永远留给人点,这不是技术限制,而是刻意把"能自动化"和"该自动化"分开。
两处仍然值得收紧的地方,一并记在这:
config.json写入补mode: 0o600,与data/sessions.json对齐;src/tunnel.mjs在没有配置身份验证时,会把?key=直接拼进公网地址再推到飞书群:
const url = named && (config.web?.access || config.web?.login === 'feishu') ? base : `${base}/?key=${key}`;
那个群消息、以及 data/tunnel.json,就成了访问口令的副本。代码在"配了 Access 或飞书登录页"时已经正确地不带 key 了,所以正确的用法是:要么开登录,要么接受口令在群聊里留痕。另外 src/web.mjs 里写 mt_key 的 Cookie 只加了 HttpOnly 和 SameSite=Lax,没有 Secure,与 mt_sess 的处理不一致;考虑到它承载的是长达一年的准入凭证,这行值得补上 Secure(在反向代理后面可以按 x-forwarded-proto 判断后再加,和 login.mjs 的做法统一)。
环境隔离:让"演示"和"真实"不共享任何凭证
很多脚本出事不是因为泄露,而是因为调试时误连了生产。麦田的做法是在最底层给配置和数据库都留了环境变量出口:
// src/feishu.mjs
const CFG = process.env.MAITIAN_CONFIG || path.join(ROOT, 'config.json');
// src/db.mjs
const DB_PATH = process.env.MAITIAN_DB || path.join(ROOT, 'data', 'hub.db');
演示模式 src/demo.mjs 因此可以在不碰你任何真实数据的前提下把大屏跑起来——它先写一份假配置,再把两个环境变量指过去:
process.env.MAITIAN_CONFIG = path.join(D, 'config.json');
process.env.MAITIAN_DB = path.join(D, 'hub.db');
假配置里只有 web: { port: 8788, key: 'demo' } 和一个假站点地址,没有任何真实 token。对应地,.gitignore 把 demo/ 整个排除。这个模式的价值不只是"能看效果",而是它证明了凭证边界是可测试的:如果哪天 demo 跑起来需要真实 Webhook,那说明某处把配置读取硬编码进了不该读的模块。
隔离还体现在运行层:hub.mjs daemon 起网页时会先看 HUB_NO_WEB,避免子进程再起一个监听;driver.mjs 用 HUB_DRIVER 在"直连专用 Chrome"和"经插件开发桥"之间切换。这些开关让同一份代码能在不同信任级别的环境里跑,而不需要改配置文件——改配置才是最容易把生产凭证带进测试环境的那一步。
看板同步这块也值得一提。src/board.mjs 需要把数据交给 lark-cli,做法是把请求体写到 data/board-<pid>.json,调用完立刻删除:
const f = path.join(ROOT, 'data', `board-${process.pid}.json`);
fs.writeFileSync(f, JSON.stringify(body));
return new Promise((res, rej) => execFile('lark-cli', [...args, '--json', `@./data/${path.basename(f)}`, '--as', 'user'], ...));
data/ 已被忽略,临时文件用完即删,凭证和业务数据都不经过命令行参数——命令行参数会出现在 ps 输出里,这个选择是对的。
复刻、分叉、二次开发时的检查清单
最后落到可执行的部分。拿到一个分发类仓库(或者把自己改过的版本推上去)之前,按顺序跑这几条,基本能覆盖绝大多数低级泄露。
第一步,看当前索引里有什么。
git ls-files | grep -Ei 'config|secret|token|cookie|credential|\.env|\.pem|\.key'
期望只看到 config.example.json 这类示例文件。看到任何带真实域名的 config.json,先停下。
第二步,看历史里有没有过。
git log --all --oneline -- 'config*' '*.env' 'data/*'
git grep -n 'open-apis/bot/v2/hook' $(git rev-list --all) -- 2>/dev/null | head
第二条命令会扫遍所有提交找飞书机器人 Webhook 的特征串。同类特征还有 cloudflareaccess.com 的团队名、baseToken 的 bascn 前缀。扫到了就按前面说的轮换凭证,别指望"删掉那个 commit"能解决。
第三步,验 .gitignore 的边界,而不是读它。
git check-ignore -v config.json config.json.bak config.local.json demo/config.json data/hub.db chrome-profile/Default
这一条能直接暴露"文档说忽略了、实际没忽略"的差距,本文的核心漏洞就是这么找出来的。建议把它写进 pre-commit 钩子或 CI 的一步,成本极低。
第四步,确认向导生成的东西都被覆盖。 逐个核对 src/init.mjs 会写出的路径:config.json、config.json.bak、data/(hub.db、sessions.json、tunnel.json、daemon.log、thumbs/)、chrome-profile/、x-article-<id>.log 与对应的 .txt(startArticleJob 会把 X 长文正文写进 data/)。只要它们全部落在被忽略的目录或后缀里,日常操作就不会制造意外文件。
第五步,第一次运行自己生成凭证。 别复用别人 fork 里的 web.key、widgetToken。向导本身已经用 crypto.randomBytes(12).toString('base64url') 生成了随机的网页口令,你要做的是不要把它改成 123456,也不要为了"方便分享给同事"而把带 ?key= 的地址贴到群里——配合前文的隧道逻辑,那等于公开入口。
第六步,把"该由人点"的地方守住。 复刻时很容易为了"全自动"把国内四家的最终提交也自动化掉。hub.mjs 里 hub submit 明确只支持 X / YouTube / Instagram,遇到其他平台直接拒绝:
if (!SUBMIT_PAGES[id]) throw refuse(`hub submit 只支持 ${Object.keys(SUBMIT_PAGES).join(' / ')};国内平台由你自己点发布`);
这条限制不是能力不足,而是把账号风险留在人的判断里。复刻时删掉它,省下的是几十秒,赔上的是账号。
一条红线,两个动作
把上面所有内容压成一句:凭证不该进入代码仓库的任何一条历史;凡是会生成"副本"的地方(备份、临时文件、日志、URL、群消息),都要被同一条规则覆盖。
麦田已经做到了大部分——专用浏览器持有登录态、data/ 与 chrome-profile/ 整体排除、口令按用途拆分、外网入口交给 Cloudflare Access、验证码不进日志。它漏掉的那一处极其典型:config.json.bak 由向导自动生成,却不在 .gitignore 的精确匹配范围内,而 README 又明确承诺"都不进 git"。文档与现实之间,只差一个后缀。
需要做的动作只有两个。把忽略规则从文件名改成前缀加白名单,并用 git check-ignore 验证边界;然后,对任何已经进过历史的凭证,轮换而不是删除。前者三分钟,后者半小时,加起来比一次事故便宜太多。
