diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..dfdb8b7 --- /dev/null +++ b/.gitattributes @@ -0,0 +1 @@ +*.sh text eol=lf diff --git a/README.md b/README.md index 90a3bbe..ea5b388 100644 --- a/README.md +++ b/README.md @@ -19,11 +19,21 @@ pnpm dev # http://localhost:4321 ## 部署 +### 小内存服务器(当前 ECS 方案) + +ECS 只有 1.6G 内存,Docker 多阶段构建会触发 `kcompactd` 长时间阻塞(load 飙到 40+)。因此改为「宿主构建 + 容器挂载」: + ```bash -docker compose up -d --build +bash scripts/deploy.sh ``` -只持久化 `./data`(`app.db` + `uploads/`),迁移时拷走这一个目录即可。 +脚本依次执行:拉代码 → `pnpm install` → `pnpm build` → `docker compose up -d --force-recreate`。容器用 `node:24-slim` 镜像,挂载 `dist` / `node_modules` / `data`,只有 `./data` 需要持久化。 + +前提:服务器 Node 装在 `/opt/node`(脚本会自动加进 PATH),且已存在 `.env`。 + +### 普通机器 / CI + +`docker compose build && docker compose up -d` 仍可用仓库里的 `Dockerfile` 构建单镜像,不需要挂载。 ## 运维 diff --git a/docker-compose.yml b/docker-compose.yml index f60b816..7560ad1 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -1,17 +1,25 @@ services: app: - build: . + # 不在服务器上构建镜像:先跑 scripts/deploy.sh 生成 dist 与 node_modules,再由容器挂载运行。 + # 原因:ECS 内存仅 1.6G,Docker 多阶段构建会触发 kcompactd 长时间阻塞。 + image: node:24-slim container_name: lfspecs restart: unless-stopped + working_dir: /app + command: ["node", "dist/server/entry.mjs"] ports: # 宿主 3010 -> 容器 3000(宿主 3000 已被 frps 占用) - "3010:3000" volumes: + - ./dist:/app/dist + - ./node_modules:/app/node_modules # 唯一需要持久化的目录:SQLite 与上传图片 - ./data:/app/data env_file: - .env environment: NODE_ENV: production + HOST: 0.0.0.0 + PORT: 3000 DB_PATH: /app/data/app.db UPLOADS_DIR: /app/data/uploads diff --git a/scripts/deploy.sh b/scripts/deploy.sh new file mode 100644 index 0000000..945c223 --- /dev/null +++ b/scripts/deploy.sh @@ -0,0 +1,30 @@ +#!/usr/bin/env bash +# ECS 部署脚本:拉代码 -> 宿主构建 -> 容器重启 +# 用法:在服务器上执行 bash scripts/deploy.sh +set -euo pipefail +cd "$(dirname "$0")/.." + +# 服务器上的 Node 装在 /opt/node(系统未自带 Node) +export PATH=/opt/node/bin:$PATH + +if [ ! -f .env ]; then + echo "缺少 .env,请先从 .env.example 复制并填写" >&2 + exit 1 +fi + +echo "==> 同步代码" +git fetch --depth 1 origin main +git reset --hard origin/main + +echo "==> 安装依赖" +pnpm install --frozen-lockfile + +echo "==> 构建" +NODE_OPTIONS=--max-old-space-size=768 pnpm build + +echo "==> 重启容器" +docker compose up -d --force-recreate + +echo "==> 健康检查" +sleep 3 +curl -fsS -o /dev/null -w 'http %{http_code}\n' http://127.0.0.1:3010/