Site cover image

Daniel Cui's Blog

硬核AI与产品落地笔记

即刻粘贴版|小白一键部署 Talorys:Cloudflare 私人 AI 助手实测踩坑

Node 20 直接出局。远程机器别指望浏览器授权。我用 API Token,在 Cloudflare 免费账号上把 Talorys 一键装通了——28 秒上线,中文聊天、建提醒都实测过。

【这是什么】

Talorys 是开源(MIT)私人 AI 助手。整个应用落在你自己的 Cloudflare 账号里:网页走 Pages,后端是私有 Worker,数据在 Durable Object(SQLite),模型默认 Workers AI 的 glm-4.7-flash。不买服务器,不把聊天交给第三方。

能做的事:聊天里直接建任务、记笔记、设提醒;有记忆;额度用完,任务笔记提醒照样能用。限制也说清:界面目前基本是英文(npm 0.1.7 纯英文,主分支刚加韩语,还没中文);单用户,没有注册体系。聊天可以打中文。

【实测环境】

· create-talorys 0.1.7(2026-10-19)

· Node 22.23.4(系统默认常是 20,会挂)

· 内置 Wrangler 4.149.0

· 全自动:CLOUDFLARE_API_TOKEN + TALORYS_OWNER_PASSWORD + --yes

· 部署约 28 秒,健康检查第 1 次等待传播后通过

【先装 Node 22】

Node 20 实测报错:Node.js 22.0 or newer is required (found 20.19.2)。顺带 miniflare 等也会 EBADENGINE。

nvm 用户注意两处真坑:

· 若提示与 NPM_CONFIG_PREFIX 不兼容,先 unset NPM_CONFIG_PREFIX

· nvm use 22 只对当前终端有效;新开终端又变回 20。设 nvm alias default 22,每次用 node -v 确认

【登录:本机 OAuth,远程必须 Token】

本机跑安装器,可走浏览器授权。云服务器、SSH、容器不行。

原因:授权完成后要跳回 localhost:8976/oauth/callback,指的是“跑安装器的那台机器”。你在自己电脑浏览器点允许,跳不回远程。非交互、无 Token 时会直接:Not authenticated with Cloudflare。

Token 权限清单(Custom token,不要用 Global API Key):

· Account › Workers Scripts › Edit

· Account › Cloudflare Pages › Edit

· Account › Workers AI › Read

· Account › Account Settings › Read

· User › User Details › Read(可选)

Account Resources 选 Include 自己的账号。Token 只显示一次,别截图不打码、别进 Git。

【全自动命令骨架】

mkdir my-ai && cd my-ai

export CLOUDFLARE_API_TOKEN=你的Token

export TALORYS_OWNER_PASSWORD=你的主人密码

npx create-talorys@latest --yes --account-id 你的账号ID

主人密码至少 10 位并混大小写数字符号,或 16 位以上。明文不会上传,本机哈希后写入 Cloudflare secrets。装完关掉该终端,别把真实密码写进脚本。

【最大误导报错:权限不足其实是本地缓存】

Token 权限配齐后,第一次部署仍在 Reserving resource names 失败,提示 Listing Pages projects failed: lacks a required permission。Details 里才是真话:EACCES,写不了 /node_modules/.cache/wrangler。

Wrangler 会往最近的 node_modules/.cache 写;上层若有 root 拥有的 node_modules,就被误报成 Cloudflare 权限问题。

解决(实测成功):

export WRANGLER_CACHE_DIR=$PWD/.wrangler-cache

然后再跑安装。或换到上层没有 node_modules 的空目录。失败不会留半成品,同一目录重跑即可。经验:先看 Details 原文,别只信最后一句。

【装完验证了什么】

· /api/health:ok,v0.1.7,ai_binding true

· 未登录 401;错密码 Incorrect password.;对密码登录 200

· 中文聊天:首字约 0.7 秒,整段约 3.9 秒,分点清楚

· 英文聊天:约 0.44 秒 / 1.4 秒

· “明天早上9点提醒我给妈妈打电话”:create_reminder 成功,once 次日 09:00 Asia/Shanghai;回复措辞略别扭,提醒本身对

· Usage:4 次 AI 请求,约 1.62 万输入 / 269 输出 token,约 99 Neurons。单次系统提示+工具约 4k 输入 → 免费额度粗算约 300 轮短对话/天

【额度】

Workers AI 免费 10,000 Neurons/天,00:00 UTC(北京时间 8:00)重置。glm-4.7-flash:约 5,500 Neurons/百万输入、36,400/百万输出(CF 定价页 2026-10-20)。用完聊天停,任务笔记提醒不停。免费计划不会因超额扣钱;升到 Workers Paid 才会按量计费。Settings → AI 可设每日请求上限当刹车。

【时区】

默认取“跑安装器那台机器”的时区。东八区机器上装,Settings 会是 Asia/Shanghai。UTC 服务器上装,提醒会差几小时——登录后 Settings → General → Timezone 改掉,已有提醒会按新时区重排。

【本地先玩(不上云)】

git clone 官方仓库后 npm install / npm run dev。实测:install 约 8 秒,dev 约 30 秒起 5173/8788/8787;默认密码 talorys-dev-password;mock AI 只认几种英文指令。本地 API 要带头 x-talorys-request: 1,否则 403 Missing CSRF header。UI 语言同上,无中文界面。

【国内访问】

pages.dev 在大陆不稳定。建议绑自定义域名(Workers & Pages → 项目 → Custom domains)。先在 Pages 里加域,再配 CNAME;只配 CNAME 不在 Pages 加,容易 522。

【记住四条】

· Node 必须 22+

· 远程用 API Token,权限配齐

· 报错先看 Details,别被“权限不足”唬住

· 国内访问尽量绑自己的域名

数据在自己账号里。一条命令部署,零服务器租金。适合要私人助手、又不想养机的人。

【上传顺序与说明】

源文已有两张打码后的 Cloudflare Token 截图,可按此顺序上传;其余为建议补拍,勿当成已有成图。

· 图1:Custom Token 权限五行 + Account Resources 选中自己账号

· 图2:Continue to summary 摘要页,核对权限后点 Create Token

· 建议图3:安装完成终端打印 pages.dev 网址(打码资源 ID/邮箱)

· 建议图4:登录后中文聊天首答截图

· 建议图5:Automations 里“给妈妈打电话”提醒条目

· 建议图6:Pages Custom domains 设置页(若已绑域)

无更多现成配图时,亦可只发图1–2 + 纯文字。

【评论区】

完整踩坑教程(含命令与截图):见博客文末链接,勿在正文堆 URL。

源码与安装器:GitHub rociiu/talorys ;npm create-talorys。

博客:https://astro-notion-blog-7xw.pages.dev/posts/talorys-cloudflare-ai-assistant-guide/