Skip to content

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

fix: harden Docker startup on legacy kernels

tianma-ifa16de56268db
diff --git a/Dockerfile b/Dockerfile
index 71c4700b..7ecf5992 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -24,7 +24,7 @@ RUN bun install --frozen-lockfile \
--filter @edgeever/web
FROM manifests AS production-dependencies
-RUN bun install --frozen-lockfile --production \
+RUN bun install --frozen-lockfile --production --linker hoisted \
--filter edgeever \
--filter @edgeever/public-network
diff --git a/apps/site/public/install.sh b/apps/site/public/install.sh
index 807dd63b..454a15d4 100755
--- a/apps/site/public/install.sh
+++ b/apps/site/public/install.sh
@@ -241,6 +241,7 @@ if [[ -r /etc/os-release ]]; then
done < /etc/os-release
fi
host_os="${host_os:-$(uname -s)}"
+host_kernel_name="$(uname -s)"
kernel_version="$(uname -sr)"
host_architecture="$(uname -m)"
docker_engine_version="$(docker version --format '{{.Server.Version}}' 2>/dev/null || true)"
@@ -253,6 +254,18 @@ log INFO "Architecture: $host_architecture"
log INFO "Docker Engine: $docker_engine_version"
log INFO "Docker Compose: $docker_compose_version"
+if [[ "$host_kernel_name" == "Linux" ]]; then
+ kernel_release="$(uname -r)"
+ kernel_major="${kernel_release%%.*}"
+ kernel_remainder="${kernel_release#*.}"
+ kernel_minor="${kernel_remainder%%.*}"
+ if [[ "$kernel_major" =~ ^[0-9]+$ && "$kernel_minor" =~ ^[0-9]+$ ]] \
+ && ((kernel_major < 5 || (kernel_major == 5 && kernel_minor < 6))); then
+ log WARN "Linux kernel $kernel_release does not meet EdgeEver's minimum 5.6 requirement"
+ log WARN "This host is outside the supported Docker environment and may fail while resolving container dependencies; upgrade the host OS/kernel if startup reports EISDIR"
+ fi
+fi
+
mkdir -p "$install_dir"
env_file="$install_dir/.env"
compose_file="$install_dir/compose.yaml"
diff --git a/docs/deploy-docker.md b/docs/deploy-docker.md
index 0cdbe8c2..3c5e04f2 100644
--- a/docs/deploy-docker.md
+++ b/docs/deploy-docker.md
@@ -10,6 +10,11 @@ Cloudflare uses Workers with D1 and R2.
- Docker Engine 24 or later with Docker Compose v2.
- An `amd64` or `arm64` Linux host.
+- Linux kernel 5.6 or later. Older kernels are outside the formally supported
+ Docker environment because Bun may fail to resolve container dependencies
+ there. The installer warns without blocking installation; if startup reports
+ `EISDIR reading .../node_modules/...`, upgrade the host OS or kernel before
+ changing `/data` permissions or replacing application data.
- A reverse proxy with HTTPS when the instance is reachable outside a trusted
local network.
diff --git a/docs/deploy-docker.zh-CN.md b/docs/deploy-docker.zh-CN.md
index 12e86495..45876b1a 100644
--- a/docs/deploy-docker.zh-CN.md
+++ b/docs/deploy-docker.zh-CN.md
@@ -9,6 +9,10 @@ Cloudflare 使用 Workers + D1 + R2。
- Docker Engine 24 或更高版本,包含 Docker Compose v2。
- `amd64` 或 `arm64` Linux 主机。
+- Linux 5.6 或更高版本内核。更旧的内核不属于正式支持的 Docker 环境,因为 Bun
+ 在这些环境中可能无法解析容器依赖。安装器会发出警告但不会阻止安装;如果启动
+ 日志出现 `EISDIR reading .../node_modules/...`,应先升级宿主机系统或内核,
+ 不要先修改 `/data` 权限或替换应用数据。
- 实例离开可信局域网时,必须使用带 HTTPS 的反向代理。
## 一键安装
diff --git a/scripts/docker-installer.test.mjs b/scripts/docker-installer.test.mjs
index 487d5fbc..6432b61b 100644
--- a/scripts/docker-installer.test.mjs
+++ b/scripts/docker-installer.test.mjs
@@ -71,6 +71,7 @@ describe("Docker installer", () => {
const curlLog = resolve(fixture, "curl.log");
const fakeDocker = resolve(fakeBin, "docker");
const fakeCurl = resolve(fakeBin, "curl");
+ const fakeUname = resolve(fakeBin, "uname");
const fakeCrontab = resolve(fakeBin, "crontab");
const crontabStore = resolve(fixture, "crontab");
@@ -124,10 +125,24 @@ if [[ "\${1:-}" == "-l" ]]; then
else
cp "$1" "$EDGE_EVER_TEST_CRONTAB"
fi
+`,
+ );
+ await writeFile(
+ fakeUname,
+ `#!/usr/bin/env bash
+set -eu
+case "\${1:-}" in
+ -s) printf 'Linux\\n' ;;
+ -r) printf '3.10.0-1160.119.1.el7.x86_64\\n' ;;
+ -sr) printf 'Linux 3.10.0-1160.119.1.el7.x86_64\\n' ;;
+ -m) printf 'x86_64\\n' ;;
+ *) printf 'Linux\\n' ;;
+esac
`,
);
await chmod(fakeDocker, 0o755);
await chmod(fakeCurl, 0o755);
+ await chmod(fakeUname, 0o755);
await chmod(fakeCrontab, 0o755);
const environment = {
@@ -169,6 +184,15 @@ fi
expect(first.stderr).toContain("Architecture:");
expect(first.stderr).toContain("Docker Engine: 27.5.1");
expect(first.stderr).toContain("Docker Compose: 2.32.4");
+ expect(first.stderr).toContain(
+ "Linux kernel 3.10.0-1160.119.1.el7.x86_64 does not meet EdgeEver's minimum 5.6 requirement",
+ );
+ expect(first.stderr).toContain(
+ "This host is outside the supported Docker environment",
+ );
+ expect(first.stderr).toContain(
+ "upgrade the host OS/kernel if startup reports EISDIR",
+ );
expect(first.stderr).toContain(
"EdgeEver target: ccr.ccs.tencentyun.com/edgeever/edgeever:latest",
);
diff --git a/scripts/docker-release.test.mjs b/scripts/docker-release.test.mjs
index 0b098f6d..6d6dd4e0 100644
--- a/scripts/docker-release.test.mjs
+++ b/scripts/docker-release.test.mjs
@@ -72,7 +72,7 @@ describe("Docker release contract", () => {
expect(dockerfile).toContain("--filter @edgeever/web");
expect(dockerfile).toContain("--filter @edgeever/public-network");
expect(dockerfile).toContain(
- "--production \\\n --filter edgeever \\\n --filter @edgeever/public-network",
+ "--production --linker hoisted \\\n --filter edgeever \\\n --filter @edgeever/public-network",
);
expect(dockerfile).toContain("USER bun");
expect(dockerfile).toContain('VOLUME ["/data"]');
@@ -103,6 +103,12 @@ describe("Docker release contract", () => {
expect(selfHosted).toContain(
"fetchEdgeEverApp(request, env, executionContext)",
);
+ expect(selfHosted).toContain(
+ 'await import("../apps/api/src/s3-compatible-storage-adapter.ts")',
+ );
+ expect(selfHosted).not.toContain(
+ 'import { createS3CompatibleStorageAdapter } from',
+ );
expect(selfHosted).not.toContain("worker.fetch(");
});
diff --git a/scripts/self-hosted-server.mjs b/scripts/self-hosted-server.mjs
index 09b26fe9..31409143 100644
--- a/scripts/self-hosted-server.mjs
+++ b/scripts/self-hosted-server.mjs
@@ -7,7 +7,6 @@ import { isUnauthenticatedAccessEnabled } from "../apps/api/src/auth-state.ts";
import { fetchEdgeEverApp } from "../apps/api/src/index.ts";
import { nodePublicFetch } from "../apps/api/src/node-public-network.ts";
import { createSelfHostedStorageAdapter } from "../apps/api/src/self-hosted-storage-adapter.ts";
-import { createS3CompatibleStorageAdapter } from "../apps/api/src/s3-compatible-storage-adapter.ts";
import { resolveSelfHostedConfig } from "./self-hosted-config.mjs";
import { loadSelfHostedEnvironment } from "./self-hosted-secrets.mjs";
@@ -63,16 +62,18 @@ if (
}
const storage = config.storageBackend === "s3"
- ? createS3CompatibleStorageAdapter(sqlite, {
- bucket: runtimeEnvironment.EDGE_EVER_S3_BUCKET ?? "",
- region: runtimeEnvironment.EDGE_EVER_S3_REGION,
- endpoint: runtimeEnvironment.EDGE_EVER_S3_ENDPOINT,
- accessKeyId: runtimeEnvironment.EDGE_EVER_S3_ACCESS_KEY_ID,
- secretAccessKey: runtimeEnvironment.EDGE_EVER_S3_SECRET_ACCESS_KEY,
- forcePathStyle: runtimeEnvironment.EDGE_EVER_S3_FORCE_PATH_STYLE
- ? runtimeEnvironment.EDGE_EVER_S3_FORCE_PATH_STYLE === "true"
- : undefined,
- })
+ ? (
+ await import("../apps/api/src/s3-compatible-storage-adapter.ts")
+ ).createS3CompatibleStorageAdapter(sqlite, {
+ bucket: runtimeEnvironment.EDGE_EVER_S3_BUCKET ?? "",
+ region: runtimeEnvironment.EDGE_EVER_S3_REGION,
+ endpoint: runtimeEnvironment.EDGE_EVER_S3_ENDPOINT,
+ accessKeyId: runtimeEnvironment.EDGE_EVER_S3_ACCESS_KEY_ID,
+ secretAccessKey: runtimeEnvironment.EDGE_EVER_S3_SECRET_ACCESS_KEY,
+ forcePathStyle: runtimeEnvironment.EDGE_EVER_S3_FORCE_PATH_STYLE
+ ? runtimeEnvironment.EDGE_EVER_S3_FORCE_PATH_STYLE === "true"
+ : undefined,
+ })
: createSelfHostedStorageAdapter(sqlite, resourcesDirectory);
const env = {
storage,