civitai

环境要求

• Node.js 24.19.0（由项目根目录 .nvmrc 指定，需配合 nvm 使用）
• 已安装 nvm，用于按 .nvmrc 切换 Node 版本
• 已启用 corepack 以使用 pnpm 包管理器
• 已安装 Docker 与 Docker Compose（用于启动 Postgres 等基础服务）
• Git，且需支持 submodule 拉取

安装与启动步骤

1. 1克隆仓库

   把 civitai 源码克隆到本地并进入项目根目录，后续所有命令都在该目录执行。

   git clone https://github.com/civitai/civitai.git
   cd civitai

   复制

2. 2切换 Node 版本

   nvm use 会读取项目里的 .nvmrc，自动切换到 README 指定的 Node 24.19.0，版本不符会导致安装失败。

   nvm use

   复制

3. 3启用 corepack

   corepack enable 让系统能够使用项目声明的包管理器（pnpm），否则后续 pnpm 命令不可用。

   corepack enable

   复制

4. 4拉取子模块

   项目依赖 event-engine-common 子模块，需显式初始化拉取，否则构建会缺文件。

   git submodule update --init event-engine-common

   复制

5. 5生成环境变量文件

   从仓库自带的 .env-example 复制出 .env.development，作为本地开发环境变量配置。

   cp .env-example .env.development

   复制

6. 6启动基础服务

   用 Docker Compose 拉起项目依赖的基础服务（如 Postgres 数据库），必须保持后台运行。

   docker compose -f docker-compose.base.yml up -d

   复制

7. 7安装依赖

   pnpm install 安装前后端全部 npm 依赖，首次执行耗时较长，需联网。

   pnpm install

   复制

8. 8启动开发服务

   pnpm dev 启动 Next.js 开发服务器，前后端一起跑；保持终端不关闭即可访问本地服务。

   pnpm dev

   复制

关键配置

如何确认成功

执行 pnpm dev 后终端不再报错、输出开发服务器编译/就绪日志，且 docker compose 拉起的容器处于运行状态，即表示本地环境启动成功。

常见问题

注意事项

• 命令顺序不能随意调整：先 nvm use 与 corepack enable，再安装依赖与启动服务。
• docker compose -f docker-compose.base.yml up -d 必须在 pnpm dev 之前执行，否则应用无法连接数据库。
• README 只提供 Standard setup 一种本地安装方式，未提供 Docker 一键部署镜像或云部署说明。
• README 未给出默认端口、访问地址及 .env 具体配置项，请勿照搬网上其他版本的参数。