LegspCpd Blog

在 Termux 上配置 Cloudflare Wrangler，并上传已有 Worker 与 D1 数据库

LegspCpd — Fri, 02 Oct 2026 00:00:00 GMT

在 Termux 上配置 Cloudflare Wrangler，并上传已有 Worker 与 D1 数据库#

本教程按“完全不会 Wrangler 的新手”来写。
目标是让你最终可以只使用 Android 手机上的 Termux，完成：

安装 Wrangler

登录 Cloudflare

查看已经创建好的 Worker

查看已经创建好的 D1

上传 .sql 数据库

将 .db / .sqlite 数据库转换为 SQL 后导入

部署 Worker

检查 D1 是否导入成功

本教程使用 Termux → Ubuntu 24.04 → Node.js 24 → Wrangler 这条路线。这样可以绕开原生 Android/Termux 环境下 Wrangler 原生依赖可能带来的兼容性问题。

目录#

一、先理解整个流程
二、第一步：更新 Termux
三、第二步：安装 Ubuntu 2404
四、第三步：进入 Ubuntu
五、第四步：给 Termux 访问手机存储的权限
六、第五步：更新 Ubuntu 并安装基础工具
七、第六步：安装 NVM
八、第七步：安装 Node.js 24
九、第八步：安装 Wrangler
十、第九步：登录 Cloudflare
十一、第十步：检查登录状态
十二、第十一步：查看已有 D1
十三、第十二步：查看 D1 详细信息
十四、第十三步：获取已经创建好的 Worker
十五、第十四步：进入 Worker 项目
十六、第十五步：检查 Wrangler 配置
十七、第十六步：理解 D1 Binding
十八、第十七步：备份现有 D1
十九、第十八步：上传 SQL 数据库
二十、第十九步：如果手里的是 db/sqlite 文件
二十一、第二十步：检查 D1 数据
二十二、第二十一步：部署 Worker 前先测试
二十三、第二十二步：正式部署 Worker
二十四、第二十三步：以后怎么更新 Worker
二十五、常见问题
二十六、完整命令速查
二十七、参考资料

一、先理解整个流程#

我们最终的环境大概是：

1
Android 手机
2
└── Termux
3
    └── Ubuntu 24.04
4
        ├── Node.js 24
5
        ├── npm
6
        └── Wrangler
7
            ├── Cloudflare Worker
8
            └── Cloudflare D1

以后你更新 Worker 时，基本只需要：

Terminal window

1
npx wrangler deploy --keep-vars

如果要把 SQL 导入 D1：

Terminal window

1
npx wrangler d1 execute 你的D1名称 --remote --file=./database.sql --yes

二、第一步：更新 Termux#

打开 Termux，执行：

Terminal window

1
pkg update

然后：

Terminal window

1
pkg upgrade -y

再安装 PRoot-Distro：

Terminal window

1
pkg install proot-distro -y

为什么要安装 PRoot-Distro？#

我们不直接把 Wrangler 装进 Android 的 Termux 环境，而是在 Termux 里面运行一个 Ubuntu 24.04 环境，再在 Ubuntu 里安装 Node.js 和 Wrangler。

这条路线更适合新手，也更容易处理 Wrangler 的 Linux/Node 原生依赖。

三、第二步：安装 Ubuntu 24.04#

执行：

Terminal window

1
proot-distro install ubuntu:24.04

等待安装完成。

如果看到类似：

1
[*] Installing Ubuntu (24.04)...

就耐心等它结束。

安装结束后，输入：

Terminal window

1
proot-distro list

你应该能看到已经安装好的 Ubuntu。

四、第三步：进入 Ubuntu#

执行：

Terminal window

1
proot-distro login ubuntu --shared-home

成功进入后，命令行通常会变成类似：

1
root@localhost:~#

这就说明：

你已经不是在 Android 的原生 Termux Shell 里，而是在 Termux 里的 Ubuntu 环境中了。

为什么使用 `--shared-home`？#

因为这样 Termux 和 Ubuntu 可以更方便地共享 Home 目录。

以后你在 Termux 的：

1
~/storage/downloads

里放 Worker 文件、数据库文件，进入 Ubuntu 后也能更方便地访问。

五、第四步：给 Termux 访问手机存储的权限#

如果你还没有执行过：

Terminal window

1
termux-setup-storage

建议现在退出 Ubuntu，回到原生 Termux：

Terminal window

1
exit

然后：

Terminal window

1
termux-setup-storage

Android 会弹出权限请求。

点击：

允许

之后手机的“下载”目录一般可以通过：

1
~/storage/downloads

访问。

例如：

1
手机：
2
Download/database.db

对应：

1
~/storage/downloads/database.db

再次进入 Ubuntu#

Terminal window

1
proot-distro login ubuntu --shared-home

六、第五步：更新 Ubuntu 并安装基础工具#

进入 Ubuntu 后执行：

Terminal window

1
apt update

然后：

Terminal window

1
apt upgrade -y

安装我们后面需要的工具：

Terminal window

1
apt install -y curl ca-certificates git sqlite3 unzip nano

这些工具分别用于：

工具	用途
`curl`	下载脚本、访问网络
`ca-certificates`	HTTPS 证书
`git`	获取项目代码
`sqlite3`	转换 SQLite 数据库
`unzip`	解压 ZIP
`nano`	编辑配置文件

七、第六步：安装 NVM#

先安装 NVM：

Terminal window

1
curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

安装结束后：

Terminal window

1
source ~/.bashrc

检查：

Terminal window

1
nvm --version

如果出现类似：

1
0.40.3

就说明 NVM 已经安装成功。

如果版本号稍有不同，不需要和示例完全一致。

八、第七步：安装 Node.js 24#

安装 Node.js 24：

Terminal window

1
nvm install 24

启用：

Terminal window

1
nvm use 24

设为默认版本：

Terminal window

1
nvm alias default 24

检查 Node：

Terminal window

1
node -v

应该看到类似：

1
v24.x.x

再检查 npm：

Terminal window

1
npm -v

正常出现版本号即可。

九、第八步：安装 Wrangler#

建议不要把 Wrangler 随便全局安装，而是在一个专门的 Cloudflare 工作目录里面作为项目依赖使用。

创建目录：

Terminal window

1
mkdir -p ~/cloudflare

进入：

Terminal window

1
cd ~/cloudflare

初始化 npm 项目：

Terminal window

1
npm init -y

安装 Wrangler：

Terminal window

1
npm install --save-dev wrangler@latest

安装完成后检查：

Terminal window

1
npx wrangler --version

如果看到类似：

1
⛅ wrangler 4.x.x

就成功了。

Wrangler 版本会持续更新，所以版本号不一定和教程中的示例完全相同。

十、第九步：登录 Cloudflare#

执行：

Terminal window

1
npx wrangler login --device

Cloudflare 会给你一个网址和验证码。

一般会看到类似：

1
To authorize Wrangler, please visit:
2

3
https://dash.cloudflare.com/oauth2/device
4

5
and enter the code:
6

7
XXXXXXXX

接下来做什么？#

复制网址。
在手机浏览器打开。
登录你的 Cloudflare 账号。
输入 Termux 显示的验证码。
授权 Wrangler。
回到 Termux。

如果成功，会看到类似：

1
Successfully logged in.

十一、第十步：检查登录状态#

执行：

Terminal window

1
npx wrangler whoami

如果能正常显示 Cloudflare 账号信息，说明登录成功。

如果这里失败#

先不要继续操作。

常见原因包括：

没有完成浏览器授权
登录到了错误的 Cloudflare 账号
网络连接失败
Wrangler 没有正常安装

十二、第十一步：查看已有 D1#

因为你说 D1 已经创建过了，所以我们不要重新创建。

执行：

Terminal window

1
npx wrangler d1 list

你应该可以看到类似：

1
Name          UUID
2
my-database   xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

记下：

1
D1 名称
2
D1 ID

例如：

1
D1 名称：
2
my-database
3

4
D1 ID：
5
12345678-1234-1234-1234-123456789abc

不要自己编数据库 ID，以 npx wrangler d1 list 显示的为准。

十三、第十二步：查看 D1 详细信息#

执行：

Terminal window

1
npx wrangler d1 info 你的D1名称

例如：

Terminal window

1
npx wrangler d1 info my-database

这一步可以帮助你确认数据库确实存在，以及 Wrangler 已经能够正常访问它。

十四、第十三步：获取已经创建好的 Worker#

你有两种情况。

情况 A：Worker 已经在 Cloudflare Dashboard 创建#

这是最方便的。

进入：

Terminal window

1
cd ~/cloudflare

然后执行：

Terminal window

1
npx wrangler init my-worker --from-dash 你的Worker名称

例如：

Terminal window

1
npx wrangler init my-worker --from-dash my-worker

Wrangler 会尝试把 Dashboard 里已经存在的 Worker 初始化到本地项目。

my-worker 是你本地项目目录的名字。
你的Worker名称 是 Cloudflare Dashboard 里面实际存在的 Worker 名字。

情况 B：你手里已经有 Worker 源代码#

例如你手里有：

1
my-worker/
2
├── package.json
3
├── wrangler.jsonc
4
├── src/
5
└── ...

那么不需要从 Dashboard 拉取，直接把整个项目放到：

1
~/cloudflare/

即可。

十五、第十四步：进入 Worker 项目#

假设本地项目叫：

1
my-worker

执行：

Terminal window

1
cd ~/cloudflare/my-worker

然后：

Terminal window

1
ls -la

正常情况下可能看到：

1
package.json
2
wrangler.jsonc
3
src

或者：

1
package.json
2
wrangler.toml
3
worker.js

不同项目结构可能不同。

十六、第十五步：检查 Wrangler 配置#

优先检查：

Terminal window

1
cat wrangler.jsonc

如果没有：

Terminal window

1
cat wrangler.toml

一个典型的 `wrangler.jsonc`#

例如：

1
{
2
  "$schema": "./node_modules/wrangler/config-schema.json",
3

4
  "name": "my-worker",
5

6
  "main": "src/index.js",
7

8
  "compatibility_date": "2026-10-02",
9

10
  "d1_databases": [
11
    {
12
      "binding": "DB",
13
      "database_name": "my-database",
14
      "database_id": "12345678-1234-1234-1234-123456789abc"
15
    }
16
  ]
17
}

展开收起

这里最重要的是：

1
name
2
main
3
d1_databases

以及 D1 下面的：

1
binding
2
database_name
3
database_id

十七、第十六步：理解 D1 Binding#

这个概念非常重要。

例如 Wrangler 配置：

1
"d1_databases": [
2
  {
3
    "binding": "DB",
4
    "database_name": "my-database",
5
    "database_id": "12345678-1234-1234-1234-123456789abc"
6
  }
7
]

那么 Worker 代码里面通常会通过：

1
env.DB

访问这个 D1。

例如：

1
export default {
2
  async fetch(request, env) {
3
    const result = await env.DB
4
      .prepare("SELECT * FROM users")
5
      .all();
6

7
    return Response.json(result);
8
  }
9
};

这里：

1
DB

必须和配置里的：

1
"binding": "DB"

一致。

一个常见错误#

配置写：

1
"binding": "DB"

代码却写：

1
env.DATABASE

这样 Worker 就找不到对应的 D1 绑定。

所以：

先看原来的 Worker 代码，再决定 binding 叫什么。不要随便改。

十八、第十七步：备份现有 D1#

因为你的 D1 已经创建过了，所以在导入新的数据库之前，建议先备份。

例如：

Terminal window

1
npx wrangler d1 export my-database --remote --output=./d1-backup.sql

成功以后，你的项目目录里会多出：

1
d1-backup.sql

为什么要备份？#

假设你的 D1 原来已经存在：

1
users
2
settings
3
messages

而你的新 SQL 里又执行：

1
CREATE TABLE users ...

就有可能发生表已经存在、重复插入等问题。

先备份，至少还有恢复依据。

十九、第十八步：上传 SQL 数据库#

如果你的数据库文件已经是：

1
database.sql

把它放到 Worker 项目目录，例如：

1
~/cloudflare/my-worker/database.sql

然后：

Terminal window

1
cd ~/cloudflare/my-worker

执行：

Terminal window

1
npx wrangler d1 execute 你的D1名称 --remote --file=./database.sql --yes

例如：

Terminal window

1
npx wrangler d1 execute my-database --remote --file=./database.sql --yes

这条命令的意思：

1
操作 D1
2
↓
3
指定数据库
4
↓
5
操作远程 Cloudflare D1
6
↓
7
读取 database.sql
8
↓
9
执行里面的 SQL

二十、第十九步：如果手里的是 `.db` / `.sqlite` 文件#

这一步非常重要。

假设你拿到的是：

1
database.db

或者：

1
database.sqlite

不要直接把它作为 --file 上传。

因为 .db 是 SQLite 数据库文件本身，而 wrangler d1 execute --file 使用的是 SQL 文本。

第 1 步：进入数据库文件所在目录#

例如：

Terminal window

1
cd ~/cloudflare/my-worker

第 2 步：把 SQLite 导出成 SQL#

如果文件叫：

1
database.db

执行：

Terminal window

1
sqlite3 database.db ".dump" > database.sql

完成后检查：

Terminal window

1
ls -lh

应该能看到：

1
database.db
2
database.sql

第 3 步：检查 SQL 有没有正常生成#

执行：

Terminal window

1
head -n 30 database.sql

正常情况下可能看到：

1
PRAGMA foreign_keys=OFF;
2
BEGIN TRANSACTION;
3
CREATE TABLE ...
4
INSERT INTO ...

如果能看到这些 SQL 内容，就说明转换成功。

第 4 步：导入 D1#

Terminal window

1
npx wrangler d1 execute 你的D1名称 --remote --file=./database.sql --yes

例如：

Terminal window

1
npx wrangler d1 execute my-database --remote --file=./database.sql --yes

二十一、第二十步：检查 D1 数据#

数据库导入之后，建议马上检查表。

执行：

Terminal window

1
npx wrangler d1 execute 你的D1名称 --remote --command="SELECT name FROM sqlite_schema WHERE type='table' ORDER BY name;"

例如：

Terminal window

1
npx wrangler d1 execute my-database --remote --command="SELECT name FROM sqlite_schema WHERE type='table' ORDER BY name;"

如果导入成功，可能看到：

1
users
2
settings
3
messages

这样就说明：

D1 不只是“创建成功”，而是已经真正拥有数据库表。

再进一步查询某个表#

例如有：

1
users

可以：

Terminal window

1
npx wrangler d1 execute my-database --remote --command="SELECT * FROM users LIMIT 10;"

二十二、第二十一步：部署 Worker 前先测试#

进入 Worker 目录：

Terminal window

1
cd ~/cloudflare/my-worker

先运行：

Terminal window

1
npx wrangler deploy --dry-run

这个命令主要用于检查部署过程，而不会直接把 Worker 正式部署上线。

如果这里报错：

不要急着正式部署。

先把错误解决。

二十三、第二十二步：正式部署 Worker#

确认 --dry-run 没问题后：

Terminal window

1
npx wrangler deploy --keep-vars

推荐使用：

1
--keep-vars

因为你的 Worker 如果之前在 Cloudflare Dashboard 中设置过普通环境变量，部署时最好注意不要意外覆盖原来的变量。

部署成功以后，一般会看到 Worker 的 URL，例如：

1
https://my-worker.example.workers.dev

这就表示：

Worker 已经重新部署。

二十四、第二十三步：以后怎么更新 Worker#

以后就简单很多。

每次打开 Termux：

Terminal window

1
proot-distro login ubuntu --shared-home

进入项目：

Terminal window

1
cd ~/cloudflare/my-worker

然后先测试：

Terminal window

1
npx wrangler deploy --dry-run

确认无误后：

Terminal window

1
npx wrangler deploy --keep-vars

更新 D1 数据时#

如果新的数据已经是 SQL：

Terminal window

1
npx wrangler d1 execute 你的D1名称 --remote --file=./database.sql --yes

如果还是 SQLite：

Terminal window

1
sqlite3 database.db ".dump" > database.sql

然后：

Terminal window

1
npx wrangler d1 execute 你的D1名称 --remote --file=./database.sql --yes

二十五、常见问题#

1. `node: command not found`#

检查：

Terminal window

1
source ~/.bashrc

然后：

Terminal window

1
nvm use 24

再：

Terminal window

1
node -v

2. `nvm: command not found`#

执行：

Terminal window

1
source ~/.bashrc

然后检查：

Terminal window

1
nvm --version

如果还是不行，可以重新进入 Ubuntu：

Terminal window

1
exit

再：

Terminal window

1
proot-distro login ubuntu --shared-home

3. `wrangler: command not found`#

如果你是通过：

Terminal window

1
npm install --save-dev wrangler@latest

安装的，不要直接输入：

Terminal window

1
wrangler

而应该：

Terminal window

1
npx wrangler

例如：

Terminal window

1
npx wrangler --version

4. `npx wrangler login` 登录失败#

手机环境推荐：

Terminal window

1
npx wrangler login --device

不要优先折腾本地回调地址。

5. `d1 list` 看不到我的 D1#

先检查：

Terminal window

1
npx wrangler whoami

确认登录的是正确的 Cloudflare 账号。

然后：

Terminal window

1
npx wrangler d1 list

如果你的 D1 属于其他 Cloudflare 账号/账户，登录身份不对时自然看不到。

6. `table already exists`#

说明你的 D1 里已经存在这个表。

先备份：

Terminal window

1
npx wrangler d1 export 你的D1名称 --remote --output=./d1-backup.sql

不要直接乱删表。

如果你不清楚 SQL 文件到底会做什么，可以先打开：

Terminal window

1
nano database.sql

检查里面的：

1
CREATE TABLE
2
DROP TABLE
3
INSERT INTO

等语句。

7. `.db` 文件直接导入失败#

不要：

Terminal window

1
npx wrangler d1 execute xxx --remote --file=database.db

正确方法：

Terminal window

1
sqlite3 database.db ".dump" > database.sql

然后：

Terminal window

1
npx wrangler d1 execute xxx --remote --file=database.sql --yes

8. Worker 部署成功，但是网站还是不能用#

重点检查：

D1 binding#

配置：

1
"binding": "DB"

代码：

1
env.DB

两者是否一致。

数据库 ID#

检查：

1
database_id

是不是你真正的 D1 ID。

数据库名字#

检查：

1
database_name

是不是已经存在的 D1。

环境变量#

如果 Worker 原来在 Dashboard 配置了变量，部署时可以使用：

Terminal window

1
npx wrangler deploy --keep-vars

二十六、完整命令速查#

第一次安装#

Termux#

Terminal window

1
pkg update
2
pkg upgrade -y
3
pkg install proot-distro -y
4
termux-setup-storage
5
proot-distro install ubuntu:24.04
6
proot-distro login ubuntu --shared-home

Ubuntu#

Terminal window

1
apt update
2
apt upgrade -y
3
apt install -y curl ca-certificates git sqlite3 unzip nano

NVM#

Terminal window

1
curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
2
source ~/.bashrc
3
nvm install 24
4
nvm use 24
5
nvm alias default 24

Wrangler#

Terminal window

1
mkdir -p ~/cloudflare
2
cd ~/cloudflare
3
npm init -y
4
npm install --save-dev wrangler@latest
5
npx wrangler --version

登录 Cloudflare#

Terminal window

1
npx wrangler login --device

检查账号#

Terminal window

1
npx wrangler whoami

查看 D1#

Terminal window

1
npx wrangler d1 list

查看 D1 信息#

Terminal window

1
npx wrangler d1 info 你的D1名称

获取已有 Worker#

Terminal window

1
cd ~/cloudflare
2
npx wrangler init my-worker --from-dash 你的Worker名称

备份 D1#

Terminal window

1
cd ~/cloudflare/my-worker
2
npx wrangler d1 export 你的D1名称 --remote --output=./d1-backup.sql

SQLite 转 SQL#

Terminal window

1
sqlite3 database.db ".dump" > database.sql

上传 SQL 到 D1#

Terminal window

1
npx wrangler d1 execute 你的D1名称 --remote --file=./database.sql --yes

检查表#

Terminal window

1
npx wrangler d1 execute 你的D1名称 --remote --command="SELECT name FROM sqlite_schema WHERE type='table' ORDER BY name;"

查询数据#

Terminal window

1
npx wrangler d1 execute 你的D1名称 --remote --command="SELECT * FROM users LIMIT 10;"

部署前检查#

Terminal window

1
npx wrangler deploy --dry-run

正式部署#

Terminal window

1
npx wrangler deploy --keep-vars

二十七、参考资料#

最后记住 4 条命令#

以后最常用的其实就这几个：

进入 Ubuntu#

Terminal window

1
proot-distro login ubuntu --shared-home

查看 Cloudflare 登录状态#

Terminal window

1
npx wrangler whoami

上传 D1 SQL#

Terminal window

1
npx wrangler d1 execute 你的D1名称 --remote --file=./database.sql --yes

部署 Worker#

Terminal window

1
npx wrangler deploy --keep-vars

建议第一次操作时严格按照本文顺序执行，不要跳步骤。
尤其是 D1：先确认数据库 → 再备份 → 再导入 → 再检查表 → 最后部署 Worker。

Cloudreve也能部署到Cloudflare Worker上面了？！

LegspCpd — Mon, 21 Sep 2026 00:00:00 GMT

把 Cloudreve v4 的后端重写为可直接跑在 Cloudflare Workers 上的 TypeScript 实现（不是编译、不是移植）。

本项目强制依赖 Cloudflare R2 作为默认存储。R2 目前开通需要绑定银行卡（或信用卡），请提前准备好。免费额度有 10GB 存储 + 每月 100 万次 A 类操作，个人使用基本够用。

数据库推荐使用 Neon（免费档即可），支持主库 + 最多 4 个备库的全量同步容灾。

一键部署#

先去 neon.tech 注册并新建项目，复制首页的 Connection string（postgresql://... 那串）。

然后点击下方按钮：

Deploy to Cloudflare

部署页把 DATABASE_URL 填成上面的连接串，其余默认，点 Deploy。KV 和 R2 会自动创建，建表和初始化在首次打开站点时自动完成。

打开 Worker 地址后注册第一个账号 —— 第一个注册的用户自动成为管理员。

手动部署（推荐大多数人使用）#

大多数用户都是先 Fork 仓库，再到 Cloudflare 面板里接上，而不是点一键按钮。流程很简单，全程浏览器操作，不需要克隆到本地。

1. Fork 仓库#

打开 https://github.com/LegspCpd/Cloudreve-Worker，点击右上角 Fork，把仓库 fork 到自己的账号下。

2. 准备 Neon 数据库#

打开 neon.tech，用 GitHub 登录，新建一个项目。
进入项目后复制 Connection string（postgresql://... 开头的那串，带 sslmode=require）。

3. 在 Cloudflare 接上仓库#

打开 Cloudflare 面板 → Workers & Pages → Create。
选择你刚 fork 的仓库。
只需要填两格：

框	填什么
构建命令（Build command）	`npm install`
部署命令（Deploy command）	`npm run deploy`

输出目录留空。

npm run deploy 会自动处理 KV 和 R2：账号里已有同名资源就直接复用，没有才新建，并把真实 ID 回填，不需要你改 wrangler.toml。

4. 配置环境变量#

在项目 设置 → 环境变量（或 Workers Builds 的构建环境变量）里添加以下变量，保存后重新部署一次。

部署脚本会把它们自动写入 Worker 的运行时 Secret。

变量	必填	说明
`DATABASE_URL`	✅	Neon 主库连接串
`SITE_URL`	建议	站点对外地址（部署后填你的域名或 Worker 地址），分享短链 / 下载直链会用到
`JWT_SECRET`	可选	令牌签名密钥（32 位以上随机串）。不设会自动生成并入库
`FRONTEND_URL`	可选	官方前端默认已随 Worker 一起发布。只有把前端单独部署到别处时才填
`ADMIN_EMAIL` + `ADMIN_PASSWORD`	可选	兜底管理员。两者都配后，Worker 会保证该邮箱存在、密码一致、属于管理员组。用于找回管理员权限，建议存成 Secret
`DATABASE_URL_2` … `DATABASE_URL_5`	可选	备库连接串（另外新建的 Neon 项目）。配了之后每次构建会自动把主库整库全量同步过去，最多 4 个备库
`KV_COUNT`	可选	建几个 KV namespace，取值 1–5，默认 1。必须放在构建能读到的地方（仓库根目录的 `KV_COUNT` 文件，或 Workers Builds 的构建环境变量），不要填在「变量和机密」里
`DB_FAILOVER`	可选	填 `1` 打开主库故障切换：主库连不上时自动降级到第一个备库。切换期间写到备库的数据会在下次全量同步时被覆盖，仅作临时应急

邮件、全文检索、存储策略等全部在管理后台配置，不占环境变量。

5. 首次访问 & 管理员#

部署完成后打开 Worker 地址，注册第一个账号。第一个注册的用户会自动成为管理员。

如果之后管理员密码丢了，可以在 Worker 设置 → 变量和机密里临时加上 ADMIN_EMAIL + ADMIN_PASSWORD，下一个冷启动会自动恢复，用完记得删掉。

部署后请绑定自定义域名#

Cloudflare 自带的 *.workers.dev 域名在国内几乎打不开，挂梯子也经常直接 1101 错误。

强烈建议绑定自己的域名：

Cloudflare 面板 → 你的 Worker → 设置 → 触发器 / 自定义域。
添加你的域名（域名最好也托管在 Cloudflare）。
绑定完成后，把环境变量 SITE_URL 改成你的域名地址，再重新部署一次。

绑定域名后访问会稳定很多。

仓库地址：https://github.com/LegspCpd/Cloudreve-Worker

更详细的 CLI 本地部署、多 KV 角色分工、备库同步机制等，见仓库内的 DEPLOY.md 和 README.md。

仅需10分钟即可制作出一个Cloudflare的优选域名

LegspCpd — Fri, 21 Aug 2026 00:00:00 GMT

制作自己的优选域名并不复杂，只需几个简单步骤即可完成。

准备工作#

在开始之前，你需要准备好以下项：

一个 DNSPod（或腾讯云 ESA）账号
一个自己拥有的已解析域名

(本教程以 DNSPod 为例进行演示)

操作步骤#

1. 域名接入#

首先打开 DNSPod控制台。如果你尚未在平台中添加域名，请先将域名添加进控制台并完成 DNS 修改；已添加域名的直接进入下一步。

三网优化版#

你可以寻找针对特定运营商的优化域名（如 Cloudflare 优选），或者使用自己测速筛选出的优选域名/IP。

步骤一：添加解析记录#

在域名解析页面点击“添加记录”。

添加记录

步骤二：配置 CNAME 与线路分流#

将 记录类型 修改为 CNAME（若使用优选 IP，则记录类型选择 A）。
填写你需要的主机记录（例如 cf 或 @）。
选择对应的 线路类型（如：电信、联通、移动等）。

配置线路类型

步骤三：填写优选域名并保存#

在 记录值 处填写获取到的优选域名（或优选 IP）。

填写优选域名

点击“确认”完成保存。

⚠️ 注意事项：

如需为其他运营商做单独优化，重复上述步骤并将线路改为对应运营商即可。

必须保留一条“默认”线路，否则海外或未识别线路的用户将无法正常解析访问。

2. 连通性与延迟测试#

配置完成后，推荐使用 ITDOG 等网络测试工具，输入配置好的域名，测试三网下的解析节点与延迟表现。

ITDOG测试效果

现成方案（开箱即用）#

如果你不想自行寻找或制作优选域名，可以直接 CNAME 链接至作者提供的优选域名：

1
cf.choling.cyou

直接使用该域名作为 CNAME 记录值即可享受优化线路。

有限生命里的无限当下

LegspCpd — Wed, 06 May 2026 00:00:00 GMT

直到多年以后你才恍然大悟，原来那是最后一次，那天午后，你像往常一样退出了游戏界面，那天傍晚你习惯性的和朋友道了，别，那天深夜妈妈轻轻抱了你一下，遗憾的是没人提醒你，也没有任何征兆，最后一次总是悄然而至，不会张扬，没有预兆，当你再回头已是物是人非，我们总以为时间充以为来日方长，以至于我们常常忽略当下，海德格尔认为人类最大的不同就是我们清楚自己终将死亡，这意味着我们每一次呼吸，每一次相遇都有可能是绝对意义上的最后一次，所以有人把每一次都当做最后一次去珍惜，也有人整日忧心，总在害怕最后一次的到来，但无论是景物还是担忧生活都不会因此停下也许。所谓最后一次在大多数时候并不是故事的终点，而是生命中温柔的提醒，别再沉溺过去的美好，也别把未来想的太远，此刻正在发生的才是我们唯一能抓住的真实朋友，过去的最后一次，你沉入时光，而未来仍有无数的第一次在等待着你，所以请试着放慢脚步，环顾四周，更深的去感受当下的人和事，因为没有人知道这是不是最后一次

EdgeOne优选教程，让EdgeOne在国内更快更稳

LegspCpd — Mon, 04 May 2026 00:00:00 GMT

作者的优选域名#

EdgeOne: https://eo.legspcpd.furry.bz/

EdgeOne优选域名测速对比

多IP: https://e.legspcpd.furry.bz/

EdgeOne多IP优选域名测速对比

什么是优选？#

腾讯云 EdgeOne 是腾讯推出的全球边缘加速平台，覆盖国内三大运营商以及海外众多节点。虽然 EdgeOne 官方分配的节点质量已经不错，但在部分地区、部分运营商网络下，默认分配的边缘节点访问速度仍然可能不尽如人意，甚至出现跨网绕路的情况。

优选，就是通过手动调整 DNS 解析和路由规则，让你的域名解析到国内访问速度更快的 EdgeOne 边缘节点（Anycast IP），从而进一步降低延迟、提升可用性。

从上面的对比图可以看到，优选过的网站响应速度有明显提升，出口 IP 也变多了。这能让你的网站可用性大大提高，并且加载速度显著变快。

要实现优选，我们需要做到两点：自己控制路由规则 和 自己控制 DNS 解析。通过 EdgeOne 的边缘函数（Edge Functions）或自定义路由，我们可以同时实现这两点，下面会详细说明。

优选原理#

首先我们要知道 CDN 是如何通过不同域名给不同内容服务的。

我们可以将其抽象为 2 层：规则层和解析层。当我们在 EdgeOne 上正常添加一条开启了加速的解析时，EdgeOne 会为我们做两件事：

帮我们写一条 DNS 解析，指向 EdgeOne 的 Anycast 节点
在 EdgeOne 创建一条路由规则，将该域名流量接入边缘网络

如果你想要优选，实际上你是要手动更改这个 DNS 解析，使其指向一个更快的 EdgeOne 节点。

但是，一旦你将加速关掉（去掉 CNAME/解析），路由规则也可能跟着失效，再访问就会显示 DNS 直接指向源站 IP——这就没法用了。

而 边缘函数（Edge Functions） 和 自定义路由 的出现改变了这一切：

你可以自己写一条边缘函数路由规则（规则层）
你可以自己写一条 CNAME 解析到优选节点（解析层）

这就是为什么经由边缘函数或自定义路由的流量可以做优选的原因。

选择优选域名#

优选的核心就是选择一个国内访问速度更快的 EdgeOne 节点 IP 或域名。

传统优选域名#

常用的社区优选域名可以参考：

https://eo.legspcpd.furry.bz/（作者维护）
https://e.legspcpd.furry.bz/（多IP版）

这些优选域名通常是通过扫描 EdgeOne 官方 IP 段，找出国内各运营商延迟最低的 IP 整理而成。

提示：如果你有多个不同运营商的线路需求，多 IP 优选域名通常能提供更好的兼容性，因为不同运营商访问同一 Anycast IP 时可能命中不同的节点。

各类优选方案#

使用 A/AAAA 记录指向指定 IP#

打开你的 DNS 服务商（腾讯云 DNSPod、阿里云、Cloudflare 等），为你的域名新建一条 A 记录（或 AAAA 记录）。

找一个 EdgeOne 优选 IP（可以参考社区测速结果，或者自己用 ITDOG 测速）
新建 A 记录，记录值 填优选 IP
关闭 DNS 服务商自带的 CDN/代理（因为是直接解析到优选 IP）

然后我们打开 ITDOG 进行测速，验证解析是否生效、速度是否理想。

已经解析完毕，可以使用。

使用边缘函数路由（Edge Functions）#

如果你有多个域名、多个源站需要同时优选，使用边缘函数会更灵活。

EdgeOne 的边缘函数与 Cloudflare Workers 类似，你可以编写一个简单的反代函数，根据请求的 Host 头将流量转发到对应的源站，同时让域名解析指向优选节点。

核心思路：

在 EdgeOne 控制台创建一个边缘函数，根据 Host 头映射目标源站
为你的域名创建一条边缘函数路由
将域名的 DNS 解析指向优选域名（CNAME 到优选节点）

这样规则层（边缘函数）和解析层（DNS）就完全由你自己控制了。

注意：边缘函数方案请务必测试好回源逻辑，确保源站响应正常后再切换正式流量。

多 IP 优选方案#

单 IP 优选在某个运营商线路异常时可能影响访问。多 IP 方案通过在不同运营商线路、不同节点上做解析分流，提升整体可用性：

使用支持线路解析的 DNS 服务商（如 DNSPod），针对电信、联通、移动分别解析到不同的优选 IP
或者使用作者提供的多 IP 优选域名（e.legspcpd.furry.bz），由服务端自动做多节点负载

这种方式在运营商网络波动时依然能保持较好的访问体验。

配合 EdgeOne Pages / 静态托管#

如果你使用的是 EdgeOne Pages 托管静态站点：

可以直接将绑定到 Pages 的子域名更改为线路分流解析
也可以将站点迁移到边缘函数方案，配合优选节点使用，效果更灵活

常见问题#

Q：优选后我的源站会不会暴露？ A：不会。优选只是让边缘节点更快地接入，回源请求仍然由边缘节点发起，源站 IP 并不会直接暴露给访客。

Q：优选 IP 失效了怎么办？ A：建议定期使用 ITDOG 等工具测速，如果发现某条线路明显变慢，及时更换解析到的优选 IP。多 IP 方案能有效降低单点失效的影响。

Q：和 Cloudflare 优选有什么区别？ A：思路完全一致，只是平台不同。EdgeOne 在国内的节点覆盖和接入质量本身就不错，优选能进一步挖掘潜力，尤其适合对延迟敏感的用户。

Q：可以同时用多个优选方案吗？ A：可以。比如主域名用边缘函数方案，备用域名用 A 记录方案，相互冗余，可用性更高。

总结#

EdgeOne 优选的核心就是自己控制 DNS 解析 + 自己控制路由规则：

先选择一个国内访问快的优选节点
通过 A/AAAA 记录、边缘函数或线路解析，将域名解析到优选节点
定期测速、维护，保证长期稳定

希望这篇教程能帮到你的网站加速。如果你有更好的 EdgeOne 优选思路，欢迎在评论区交流。

Cloudflare优选教程，让Cloudflare在国内不再是减速器

LegspCpd — Sun, 19 Apr 2026 00:00:00 GMT

作者的优选域名#

CF: https://cf.legspcpd.furry.bz/ 真移动优化: https://cmcc.legspcpd.furry.bz/

什么是优选？#

简单来说，优选就是选择一个国内访问速度更快的Cloudflare节点。

Cloudflare官方分配给我们的IP，在国内访问时延迟往往较高，甚至可能出现无法访问的情况。而通过优选，我们可以手动将域名解析到那些国内访问更快的Cloudflare IP，从而显著提升网站的访问速度和可用性。

从上面的对比图可以看到，优选过的网站响应速度有很大提升，出口IP也变多了。这能让你的网站可用性大大提高，并且加载速度显著变快。

要实现优选，我们需要做到两点：自己控制路由规则和自己控制DNS解析。通过Cloudflare SaaS或Worker路由，我们可以同时实现这两点，下面会详细说明

优选原理#

首先我们要知道CDN是如何通过不同域名给不同内容的。

我们可以将其抽象为2层：规则层和解析层。当我们普通的在Cloudflare添加一条开启了小黄云的解析，Cloudflare会为我们做两件事：

帮我们写一条DNS解析指向Cloudflare 在Cloudflare创建一条路由规则如果你想要优选，实际上你是要手动更改这个DNS解析，使其指向一个更快的Cloudflare节点。

但是，一旦你将小黄云关闭，路由规则也会被删除，再访问就会显示DNS直接指向IP——这就没法用了。

而SaaS和Worker路由的出现改变了这一切。

使用SaaS后，Cloudflare不再帮你做这两件事了，这两件事你都可以自己做了：

1.你可以自己写一条SaaS规则（规则层） 2.你可以自己写一条CNAME解析到优选节点（解析层）

使用Worker路由同理，你创建Worker路由规则后，DNS解析就可以随便指向任何优选节点了。

这就是为什么经由SaaS或Worker路由的流量可以做优选的原因。

选择优选域名#

优选的核心就是选择一个国内访问速度更快的Cloudflare节点IP或域名。

传统优选域名#

常用的社区优选域名：https://cf.090227.xyz

这些优选域名通常是通过扫描Cloudflare官方IP段，找出国内延迟最低的IP整理而成。

各类优选方案#

更简单的优选方法#

使用A/AAAA指向指定IPV4/V6#

打开Cloudflare或者其他云平台新建一个A记录

cf-jl.png

找一个CF优选IP，我这里拿104.20.28.171这个IP做例子

ip.png

按照这样填写

我们打开ITDOG进行测速

itdog-test-ip.png

已经解析完毕，可以使用

Worker项目优选（最简单）#

接下来编写Worker路由

1
// 域名前缀映射配置
2
const domain_mappings = {
3
  '源站.com': '最终访问头.',
4
//例如：
5
//'gitea.072103.xyz': 'gitea.',
6
//则你设置Worker路由为gitea.*都将会反代到gitea.072103.xyz
7
};
8

9
addEventListener('fetch', event => {
10
  event.respondWith(handleRequest(event.request));
11
});
12

13
async function handleRequest(request) {
14
  const url = new URL(request.url);
15
  const current_host = url.host;
16

17
  // 强制使用 HTTPS
18
  if (url.protocol === 'http:') {
19
    url.protocol = 'https:';
20
    return Response.redirect(url.href, 301);
21
  }
22

23
  const host_prefix = getProxyPrefix(current_host);
24
  if (!host_prefix) {
25
    return new Response('Proxy prefix not matched', { status: 404 });
26
  }
27

28
  // 查找对应目标域名
29
  let target_host = null;
30
  for (const [origin_domain, prefix] of Object.entries(domain_mappings)) {
31
    if (host_prefix === prefix) {
32
      target_host = origin_domain;
33
      break;
34
    }
35
  }
36

37
  if (!target_host) {
38
    return new Response('No matching target host for prefix', { status: 404 });
39
  }
40

41
  // 构造目标 URL
42
  const new_url = new URL(request.url);
43
  new_url.protocol = 'https:';
44
  new_url.host = target_host;
45

46
  // 创建新请求
47
  const new_headers = new Headers(request.headers);
48
  new_headers.set('Host', target_host);
49
  new_headers.set('Referer', new_url.href);
50

51
  try {
52
    const response = await fetch(new_url.href, {
53
      method: request.method,
54
      headers: new_headers,
55
      body: request.method !== 'GET' && request.method !== 'HEAD' ? request.body : undefined,
56
      redirect: 'manual'
57
    });
58

59
    // 复制响应头并添加CORS
60
    const response_headers = new Headers(response.headers);
61
    response_headers.set('access-control-allow-origin', '*');
62
    response_headers.set('access-control-allow-credentials', 'true');
63
    response_headers.set('cache-control', 'public, max-age=600');
64
    response_headers.delete('content-security-policy');
65
    response_headers.delete('content-security-policy-report-only');
66

67
    return new Response(response.body, {
68
      status: response.status,
69
      statusText: response.statusText,
70
      headers: response_headers
71
    });
72
  } catch (err) {
73
    return new Response(`Proxy Error: ${err.message}`, { status: 502 });
74
  }
75
}
76

77
function getProxyPrefix(hostname) {
78
  for (const prefix of Object.values(domain_mappings)) {
79
    if (hostname.startsWith(prefix)) {
80
      return prefix;
81
    }
82
  }
83
  return null;
84
}

展开收起

创建路由: 像这样

(SaaS将会引用二叉树树的教程)

传统SaaS优选#

SaaS做了什么？#

Cloudflare SaaS是一个不需要你改变一个域名的NS服务器，就可以让其受益于Cloudflare网络的功能。

当一个域名被SaaS到一个已经在Cloudflare的域名后，它就完整受益所有Cloudflare服务。如我将 umami.acofork.com SaaS 到 2x.nz，我就可以在 2x.nz 里为 umami.acofork.com 写规则了：

cf-saas-1.webp

cf-saas-2.webp

cf-saas-3.webp

Worker中的路由规则也适用：

cf-saas-4.webp

SaaS优选步骤简单易懂（pro.yourdomain.com 是最终访问域名）： CF SaaS DNS origin.yourdomain.com -> 源站开小黄云 cdn.yourdomain.com -> cf优选域名 pro.yourdomain.com -> cdn.yourdomain.com

CF SaaS 添加自定义主机名pro.yourdomain.com 源站为origin.yourdomain.com

警告 Cloudflare最近将新接入的域名SSL默认设为了完全，记得将 SSL 改为灵活。

准备工作#

我们需要一个域名或两个域名（单域名直接用子域名即可。双域名比如：onani.cn和acofork.cn）。

如果在同一CF账号下不可用，请尝试将俩域名放置在不同账号

这里我们让onani.cn成为主力域名，让acofork.cn成为辅助域名。

单域名效果：

cf-fastip-1.webp

具体步骤首先新建一个DNS解析，指向你的源站，开启cf代理

c94c34ee262fb51fb5697226ae0df2d804bf76fe.webp

前往辅助域名的 SSL/TLS -> 自定义主机名。设置回退源为你刚才的DNS解析的域名：xlog.acofork.cn（推荐 HTTP 验证）

点击添加自定义主机名。设置一个自定义主机名，比如 onani.cn，然后选择自定义源服务器，填写第一步的域名，即 xlog.acofork.cn。

如果你想要创建多个优选也就这样添加，一个自定义主机名对应一个自定义源服务器。如果你将源服务器设为默认，则源服务器是回退源指定的服务器，即 xlog.acofork.cn

f6170f009c43f7c6bee4c2d29e2db7498fa1d0dc.webp

继续在你的辅助域名添加一条解析。CNAME到优选节点：如cloudflare.182682.xyz，不开启cf代理

4f9f727b0490e0b33d360a2363c1026003060b29.webp

最后在你的主力域名添加解析。域名为之前在辅助域名的自定义主机名（onani.cn），目标为刚才的cdn.acofork.cn，不开启cf代理

6f51cb2a42140a9bf364f88a5715291be616a254.webp

优选完毕，确保优选有效后尝试访问

cf-fastip-10.webp

（可选）你也可以将cdn子域的NS服务器更改为阿里云\华为云\腾讯云云解析做线路分流解析

优选工作流：用户访问 -> 由于最终访问的域名设置了CNAME解析，所以实际上访问了cdn.acofork.cn，并且携带源主机名：onani.cn -> 到达优选域名进行优选 -> 优选结束，cf边缘节点识别到了携带的源主机名：onani.cn 查询发现了回退源 -> 回退到回退源内容（xlog.acofork.cn） -> 访问成功

针对于Cloudflare Page#

你可以直接将你绑定到Page的子域名直接更改NS服务器到阿里云\华为云\腾讯云云解析做线路分流解析
将您的Page项目升级为Worker项目，使用Worker优选方案（更简单）。详细方法见：【CF Page一键迁移到Worker？好处都有啥？-哔哩哔哩】 https://www.bilibili.com/video/BV1wBTEzREcb

针对于Cloudflare Workers#

在Workers中添加路由，然后直接将你的路由域名从指向xxx.worker.dev改为优选域名即可
如果是外域，SaaS后再添加路由即可，就像：
cf-fastip-12.webp

cf-fastip-13.webp

针对于使用了各种CF规则的网站#

你只需要让规则针对于你的 最终访问域名 ，因为CF的规则是看主机名的，而不是看是由谁提供的。

针对于虚拟主机#

保险起见，建议将源站和优选域名同时绑定到你的虚拟主机，保证能通再一个个删。

日记

LegspCpd — Tue, 06 May 1997 00:00:00 GMT

感觉有点累啊…

推荐歌曲:

Zeraphym - Lifeline 这首歌对我心灵造成的震撼，使我无法用语言来描述，因为我不觉得世界上有哪个词能形容这首歌的完美！！！

Firefly Wiki Link 内部链接示例

LegspCpd — Sat, 03 Jan 1970 00:00:00 GMT

Firefly 支持在 Markdown、MDX 文章中使用 Obsidian 风格的 Wiki Link 内部链接。链接目标填写文章的 slug 或文件路径，都不需要包含扩展名，具体匹配规则见下文「链接目标的三种写法」。

文章链接卡片#

[[slug]] 单独成段时，会自动读取目标文章的标题、描述、发布时间、分类、标签和封面，渲染为链接卡片：

1
[[firefly]]
2

3
[[guide/index]]
4

5
[[markdown-extended]]

firefly

guide/index

markdown-extended

行内链接#

[[slug]] 出现在正文中间时，渲染为普通链接，链接文字自动使用目标文章的标题

1
请参阅 [[firefly]] 了解主题特性。

请参阅 firefly 了解主题特性。

自定义显示标题#

在 | 后填写链接的显示文字。行内链接会用它替换文章标题；单独成段时依然渲染为卡片，卡片标题使用自定义文字，描述、时间、分类、标签和封面仍然读取目标文章：

1
请参阅 [[firefly|主题介绍]] 了解主题特性。
2

3
[[firefly|Firefly 主题介绍]]

请参阅主题介绍了解主题特性。

Firefly 主题介绍

一个例外：如果 | 后的文字只是把链接目标又抄了一遍（[[guide/index|index]]），会被当作无效别名忽略，仍然显示文章标题。Obsidian 在插入的链接时会自动补上这样的别名，避免笔记里显示一长串路径，这个例外就是为它准备的。

链接目标的三种写法#

用 Obsidian 管理文章时，把 src/content/posts 目录本身作为 Obsidian 仓库（vault）打开。下文提到的「仓库根目录」都指这个目录，它正好也是 Firefly 解析链接路径的起点。

链接目标按以下顺序匹配：

写法	示例	在 Obsidian 中
frontmatter 的 `slug`	`[[firefly-wiki-link]]`	✗ 不支持
文件路径（相对仓库根目录）	`[[guide/firefly-layout-system]]`	✓ 需改设置（推荐）
裸文件名（仓库内唯一时）	`[[firefly-layout-system]]`	✓ 默认即是

第一种：slug#

slug 写法在 Obsidian 中不支持，slug 是 Firefly 自己的概念，Obsidian 不读取 frontmatter 里的 slug，所以按 slug 写的链接在 Obsidian 里既不会自动补全，也点不动，只有构建出的站点上能正常跳转。如果你主要在 Obsidian 里写作，用下面两种写法。

第二种：文件路径（推荐）#

文件路径写法需要改 Obsidian 设置，在 设置 → 文件与链接 → 链接 → 内部链接类型 中选择基于仓库根目录的绝对路径，Obsidian 插入的链接才会带上目录：

1
[[guide/firefly-layout-system|firefly-layout-system]]

guide/firefly-layout-system

因为仓库根目录就是 src/content/posts，Obsidian 写出的这个路径和 Firefly 需要的路径完全一致，不需要任何额外转换。

上面这行末尾的 |firefly-layout-system 是 Obsidian 自动补的别名，Firefly 会忽略它，卡片标题仍然取文章的 title，除非你把它修改和文件名不一致，才会变成你修改后的别名。

内部链接类型下拉框里的基于当前笔记的相对路径只在同目录内可用：它给同目录文章生成的是裸文件名，能正常匹配；但跨目录时会生成 ../ 前缀，Firefly 无法解析，链接会按原文显示。

第三种：裸文件名#

「内部链接类型」的默认值就是尽可能简短的形式：只要文件名在整个仓库里唯一，Obsidian 插入的链接就只有文件名，不带目录。这种写法不需要改任何设置，效果和写完整路径完全一致：

1
[[firefly-layout-system]]

firefly-layout-system

文件名重名时这种写法会失效，构建日志里会给出提示，改用完整文件路径即可，所以推荐直接修改 Obsidian 内部链接类型设置为基于仓库根目录的绝对路径，使用第二种文件路径写法，一劳永逸

链接到其他文章的标题#

在文章 slug 后添加 #标题。带标题锚点的链接始终渲染为普通链接：

查看代码块语法高亮

guide/firefly-layout-system#相关链接#相关链接

1
[[code-examples#语法高亮|查看代码块语法高亮]]
2

3
[[guide/firefly-layout-system#相关链接|firefly-layout-system]]

标题锚点使用与页面标题相同的 slug 规则，因此中文、空格和大小写都会按页面实际生成的 ID 处理。

链接到本页标题#

省略文章 slug，只填写标题即可链接到当前文章：

跳转到本页目标

1
[[#本页目标|跳转到本页目标]]

本页目标#

这是本页 Wiki Link 指向的标题。

不支持附件嵌入#

附件嵌入语法目前不会被转换，会按原文显示：

![[image.png]]

行内代码和代码块中的 [[firefly]] 也不会被转换。

Markdown PlantUML 图表

LegspCpd — Thu, 01 Jan 1970 00:00:00 GMT

Markdown 中 PlantUML 图表指南#

PlantUML 是一种使用纯文本描述图表的工具。你只需要写一段结构化语法，就可以生成时序图、类图、用例图、活动图等常见工程图。

它特别适合写在技术博客和项目文档里：

图表和正文一起版本管理，便于协作与审阅
修改图只需要改文本，适合频繁迭代
能和 Markdown 无缝结合，保持文档统一

在 Firefly 中，plantuml 代码块会在构建阶段编码并生成服务器 SVG 地址，页面端再根据亮暗主题自动切换图源，并支持缩放、拖拽和全屏交互。

LegspCpd Blog

在 Termux 上配置 Cloudflare Wrangler，并上传已有 Worker 与 D1 数据库

在 Termux 上配置 Cloudflare Wrangler，并上传已有 Worker 与 D1 数据库#

目录#

一、先理解整个流程#

二、第一步：更新 Termux#

为什么要安装 PRoot-Distro？#

三、第二步：安装 Ubuntu 24.04#

四、第三步：进入 Ubuntu#

为什么使用 --shared-home？#

五、第四步：给 Termux 访问手机存储的权限#

再次进入 Ubuntu#

六、第五步：更新 Ubuntu 并安装基础工具#

七、第六步：安装 NVM#

八、第七步：安装 Node.js 24#

九、第八步：安装 Wrangler#

十、 第九步：登录 Cloudflare#

接下来做什么？#

十一、第十步：检查登录状态#

如果这里失败#

十二、第十一步：查看已有 D1#

十三、第十二步：查看 D1 详细信息#

十四、第十三步：获取已经创建好的 Worker#

情况 A：Worker 已经在 Cloudflare Dashboard 创建#

情况 B：你手里已经有 Worker 源代码#

十五、第十四步：进入 Worker 项目#

十六、第十五步：检查 Wrangler 配置#

一个典型的 wrangler.jsonc#

十七、第十六步：理解 D1 Binding#

一个常见错误#

十八、第十七步：备份现有 D1#

为什么要备份？#

十九、第十八步：上传 SQL 数据库#

二十、 第十九步：如果手里的是 .db / .sqlite 文件#

第 1 步：进入数据库文件所在目录#

第 2 步：把 SQLite 导出成 SQL#

第 3 步：检查 SQL 有没有正常生成#

第 4 步：导入 D1#

二十一、第二十步：检查 D1 数据#

再进一步查询某个表#

二十二、第二十一步：部署 Worker 前先测试#

二十三、第二十二步：正式部署 Worker#

二十四、第二十三步：以后怎么更新 Worker#

更新 D1 数据时#

二十五、常见问题#

1. node: command not found#

2. nvm: command not found#

3. wrangler: command not found#

4. npx wrangler login 登录失败#

5. d1 list 看不到我的 D1#

6. table already exists#

7. .db 文件直接导入失败#

8. Worker 部署成功，但是网站还是不能用#

D1 binding#

数据库 ID#

数据库名字#

环境变量#

二十六、完整命令速查#

第一次安装#

Termux#

Ubuntu#

NVM#

Wrangler#

登录 Cloudflare#

检查账号#

查看 D1#

查看 D1 信息#

获取已有 Worker#

备份 D1#

SQLite 转 SQL#

上传 SQL 到 D1#

检查表#

查询数据#

部署前检查#

正式部署#

二十七、参考资料#

最后记住 4 条命令#

进入 Ubuntu#

查看 Cloudflare 登录状态#

上传 D1 SQL#

为什么使用 `--shared-home`？#

十、第九步：登录 Cloudflare#

一个典型的 `wrangler.jsonc`#

二十、第十九步：如果手里的是 `.db` / `.sqlite` 文件#

1. `node: command not found`#

2. `nvm: command not found`#

3. `wrangler: command not found`#

4. `npx wrangler login` 登录失败#

5. `d1 list` 看不到我的 D1#

6. `table already exists`#

7. `.db` 文件直接导入失败#