Skip to content

AI-native knowledge base & Evernote/Obsidian alternative with instant sync & native MCP. Free on Cloudflare or self-hosted via Docker.

feat: support multi-instance cloudflare deploys

tianmada8ac14ac37e
diff --git a/.env.local.example b/.env.local.example
index 012b0940..c13dbbe7 100644
--- a/.env.local.example
+++ b/.env.local.example
@@ -35,3 +35,24 @@ EDGE_EVER_R2_PREVIEW_BUCKET_NAME=edgeever-resources-preview
# 前端访问 API 的基础地址。
# 本地开发默认指向 Wrangler dev:`bun run dev:api`
VITE_API_BASE_URL=http://127.0.0.1:8787
+
+# 多实例部署模板。
+# 使用 `EDGE_EVER_INSTANCE=tianma bun run deploy` 或 `bun run deploy:tianma` 时,
+# 脚本会优先读取 `EDGE_EVER_TIANMA_*`,再回退到上面的通用 `EDGE_EVER_*`。
+# `demo` 实例同理。真实 D1 ID 只填到本地 `.env.local` 或 Cloudflare Build Variables。
+
+# 私人实例:tianma.edgeever.org
+EDGE_EVER_TIANMA_WORKER_NAME=edgeever-tianma
+EDGE_EVER_TIANMA_CUSTOM_DOMAIN=tianma.edgeever.org
+EDGE_EVER_TIANMA_D1_DATABASE_NAME=edgeever-tianma
+EDGE_EVER_TIANMA_D1_DATABASE_ID=00000000-0000-0000-0000-000000000000
+EDGE_EVER_TIANMA_R2_BUCKET_NAME=edgeever-tianma-resources
+EDGE_EVER_TIANMA_R2_PREVIEW_BUCKET_NAME=edgeever-tianma-resources-preview
+
+# 公开演示实例:demo.edgeever.org
+EDGE_EVER_DEMO_WORKER_NAME=edgeever-demo
+EDGE_EVER_DEMO_CUSTOM_DOMAIN=demo.edgeever.org
+EDGE_EVER_DEMO_D1_DATABASE_NAME=edgeever-demo
+EDGE_EVER_DEMO_D1_DATABASE_ID=00000000-0000-0000-0000-000000000000
+EDGE_EVER_DEMO_R2_BUCKET_NAME=edgeever-demo-resources
+EDGE_EVER_DEMO_R2_PREVIEW_BUCKET_NAME=edgeever-demo-resources-preview
diff --git a/.gitignore b/.gitignore
index 3e02f5c8..2368b712 100644
--- a/.gitignore
+++ b/.gitignore
@@ -10,7 +10,7 @@ build/
coverage/
.wrangler/
-.wrangler.generated.toml
+.wrangler.generated*.toml
.dev.vars
wrangler.local.toml
diff --git a/README.md b/README.md
index 20d5193b..a8a35095 100644
--- a/README.md
+++ b/README.md
@@ -154,6 +154,52 @@ bunx wrangler r2 bucket create edgeever-resources
EDGE_EVER_D1_DATABASE_ID=<你的 D1 database_id>
```
+## 多实例部署
+
+EdgeEver 推荐用多个 Worker + 多套 D1/R2 来做实例隔离。比如私人实例和公开演示实例:
+
+```text
+tianma.edgeever.org -> edgeever-tianma -> edgeever-tianma D1 + edgeever-tianma-resources R2
+demo.edgeever.org -> edgeever-demo -> edgeever-demo D1 + edgeever-demo-resources R2
+```
+
+本地 `.env.local` 可以按 `.env.local.example` 填入实例专属变量:
+
+```text
+EDGE_EVER_TIANMA_WORKER_NAME=edgeever-tianma
+EDGE_EVER_TIANMA_CUSTOM_DOMAIN=tianma.edgeever.org
+EDGE_EVER_TIANMA_D1_DATABASE_ID=<tianma D1 database_id>
+EDGE_EVER_TIANMA_R2_BUCKET_NAME=edgeever-tianma-resources
+
+EDGE_EVER_DEMO_WORKER_NAME=edgeever-demo
+EDGE_EVER_DEMO_CUSTOM_DOMAIN=demo.edgeever.org
+EDGE_EVER_DEMO_D1_DATABASE_ID=<demo D1 database_id>
+EDGE_EVER_DEMO_R2_BUCKET_NAME=edgeever-demo-resources
+```
+
+部署单个实例:
+
+```sh
+bun run deploy:tianma
+bun run deploy:demo
+```
+
+同时部署两个实例:
+
+```sh
+bun run deploy:all
+```
+
+如果用 Cloudflare Git 自动构建,每个 Worker 都可以连接同一个 GitHub 仓库,但需要分别配置自己的 Build Variables。至少要设置:
+
+```text
+EDGE_EVER_WORKER_NAME=<实例 Worker 名>
+EDGE_EVER_CUSTOM_DOMAIN=<实例域名>
+EDGE_EVER_D1_DATABASE_ID=<实例 D1 database_id>
+EDGE_EVER_R2_BUCKET_NAME=<实例 R2 bucket>
+EDGE_EVER_R2_PREVIEW_BUCKET_NAME=<实例 R2 preview bucket>
+```
+
应用本地迁移:
```sh
diff --git a/package.json b/package.json
index c4d8db9a..4eea4cac 100644
--- a/package.json
+++ b/package.json
@@ -17,7 +17,10 @@
"typecheck": "tsc -p tsconfig.json --noEmit",
"db:migrate:local": "bun scripts/run-wrangler.mjs d1 migrations apply DB --local",
"db:migrate:remote": "bun scripts/run-wrangler.mjs d1 migrations apply DB --remote",
- "deploy": "bun run build && bun run db:migrate:remote && bun scripts/run-wrangler.mjs deploy"
+ "deploy": "bun run build && bun run db:migrate:remote && bun scripts/run-wrangler.mjs deploy",
+ "deploy:tianma": "EDGE_EVER_INSTANCE=tianma bun run deploy",
+ "deploy:demo": "EDGE_EVER_INSTANCE=demo bun run deploy",
+ "deploy:all": "bun run deploy:tianma && bun run deploy:demo"
},
"cloudflare": {
"bindings": {
diff --git a/scripts/run-wrangler.mjs b/scripts/run-wrangler.mjs
index 7eebfb21..7068c429 100644
--- a/scripts/run-wrangler.mjs
+++ b/scripts/run-wrangler.mjs
@@ -1,5 +1,5 @@
import { spawnSync } from "node:child_process";
-import { readFileSync, writeFileSync } from "node:fs";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
import { resolve } from "node:path";
const PLACEHOLDER_D1_ID = "00000000-0000-0000-0000-000000000000";
@@ -12,8 +12,45 @@ if (wranglerArgs.length === 0) {
process.exit(1);
}
+const loadLocalEnv = () => {
+ const envPath = resolve(".env.local");
+ if (!existsSync(envPath)) {
+ return;
+ }
+
+ const lines = readFileSync(envPath, "utf8").split(/\r?\n/);
+ for (const line of lines) {
+ const trimmed = line.trim();
+ if (!trimmed || trimmed.startsWith("#") || !trimmed.includes("=")) {
+ continue;
+ }
+
+ const separatorIndex = trimmed.indexOf("=");
+ const key = trimmed.slice(0, separatorIndex).trim();
+ let value = trimmed.slice(separatorIndex + 1).trim();
+ if (
+ (value.startsWith('"') && value.endsWith('"')) ||
+ (value.startsWith("'") && value.endsWith("'"))
+ ) {
+ value = value.slice(1, -1);
+ }
+
+ if (key && process.env[key] === undefined) {
+ process.env[key] = value;
+ }
+ }
+};
+
+loadLocalEnv();
+
const baseConfigPath = resolve(process.env.WRANGLER_CONFIG ?? "wrangler.toml");
-const generatedConfigPath = resolve(".wrangler.generated.toml");
+const instance = process.env.EDGE_EVER_INSTANCE?.trim();
+const instanceKey = instance?.replace(/[^a-zA-Z0-9]/g, "_").toUpperCase();
+const generatedConfigPath = resolve(
+ instanceKey
+ ? `.wrangler.generated.${instanceKey.toLowerCase()}.toml`
+ : ".wrangler.generated.toml",
+);
let config = readFileSync(baseConfigPath, "utf8");
let changed = false;
@@ -31,7 +68,34 @@ const replaceTomlValue = (source, key, value) => {
return source.replace(pattern, `$1${value}$2`);
};
-const d1DatabaseId = process.env.EDGE_EVER_D1_DATABASE_ID?.trim();
+const envValue = (name) => {
+ const scopedName = instanceKey ? `EDGE_EVER_${instanceKey}_${name}` : undefined;
+ return (scopedName ? process.env[scopedName] : undefined)?.trim()
+ || process.env[`EDGE_EVER_${name}`]?.trim();
+};
+
+const workerName = envValue("WORKER_NAME");
+if (workerName) {
+ config = replaceTomlValue(config, "name", workerName);
+}
+
+const workersDev = envValue("WORKERS_DEV");
+if (workersDev) {
+ const normalized = workersDev.toLowerCase();
+ if (!["true", "false"].includes(normalized)) {
+ throw new Error("EDGE_EVER_WORKERS_DEV must be true or false.");
+ }
+
+ const pattern = /^workers_dev\s*=\s*(true|false)/m;
+ if (!pattern.test(config)) {
+ throw new Error(`Cannot find workers_dev in ${baseConfigPath}`);
+ }
+
+ changed = true;
+ config = config.replace(pattern, `workers_dev = ${normalized}`);
+}
+
+const d1DatabaseId = envValue("D1_DATABASE_ID");
if (d1DatabaseId) {
if (!UUID_PATTERN.test(d1DatabaseId)) {
throw new Error("EDGE_EVER_D1_DATABASE_ID must be a Cloudflare D1 UUID.");
@@ -40,29 +104,35 @@ if (d1DatabaseId) {
config = replaceTomlValue(config, "database_id", d1DatabaseId);
}
-config = replaceTomlValue(
- config,
- "database_name",
- process.env.EDGE_EVER_D1_DATABASE_NAME?.trim(),
-);
-config = replaceTomlValue(
- config,
- "bucket_name",
- process.env.EDGE_EVER_R2_BUCKET_NAME?.trim(),
-);
+config = replaceTomlValue(config, "database_name", envValue("D1_DATABASE_NAME"));
+config = replaceTomlValue(config, "bucket_name", envValue("R2_BUCKET_NAME"));
config = replaceTomlValue(
config,
"preview_bucket_name",
- process.env.EDGE_EVER_R2_PREVIEW_BUCKET_NAME?.trim(),
+ envValue("R2_PREVIEW_BUCKET_NAME"),
);
+const customDomain = envValue("CUSTOM_DOMAIN");
+const routePattern = envValue("ROUTE_PATTERN") || customDomain;
+if (routePattern) {
+ changed = true;
+ config = `${config.trimEnd()}
+
+[[routes]]
+pattern = "${routePattern}"
+custom_domain = ${customDomain ? "true" : "false"}
+`;
+}
+
const isRemoteCommand =
wranglerArgs.includes("deploy") || wranglerArgs.includes("--remote");
if (isRemoteCommand && config.includes(`database_id = "${PLACEHOLDER_D1_ID}"`)) {
console.error(
[
"Missing Cloudflare D1 database id.",
- "Set EDGE_EVER_D1_DATABASE_ID as a Cloudflare Build Variable,",
+ instanceKey
+ ? `Set EDGE_EVER_${instanceKey}_D1_DATABASE_ID or EDGE_EVER_D1_DATABASE_ID,`
+ : "Set EDGE_EVER_D1_DATABASE_ID,",
"or replace the database_id placeholder in wrangler.toml / WRANGLER_CONFIG.",
].join(" "),
);
@@ -74,7 +144,16 @@ if (changed) {
writeFileSync(generatedConfigPath, config);
}
-const executable = process.platform === "win32" ? "wrangler.cmd" : "wrangler";
+const localWrangler = resolve(
+ "node_modules",
+ ".bin",
+ process.platform === "win32" ? "wrangler.cmd" : "wrangler",
+);
+const executable = existsSync(localWrangler)
+ ? localWrangler
+ : process.platform === "win32"
+ ? "wrangler.cmd"
+ : "wrangler";
const result = spawnSync(executable, ["--config", configPath, ...wranglerArgs], {
stdio: "inherit",
shell: process.platform === "win32",