Fleek Next.js适配器镜像文档

镜像概述

Fleek Next.js适配器是一个专为Next.js应用程序设计的部署工具，旨在实现服务器端渲染(SSR)的Next.js应用在Fleek平台上的无缝部署。它作为连接Next.js应用与Fleek基础设施的桥梁，确保应用的服务端功能在Fleek环境中稳定运行。

核心功能与特性

• 服务器端渲染支持：专为服务器端渲染(SSR)的Next.js应用优化，确保getServerSideProps等SSR特性正常工作
• Fleek平台集成：与Fleek的部署流程、边缘网络和托管服务深度集成，无需额外基础设施配置
• 简化部署流程：提供标准化部署路径，减少手动配置步骤，降低部署复杂度
• 兼容性保障：兼容主流Next.js版本，确保应用在迁移和升级过程中的稳定性

使用场景

• 开发者需要将采用服务器端渲染的Next.js应用部署至Fleek平台
• 需在Fleek环境中运行依赖服务端逻辑的Next.js项目（如动态内容生成、实时数据获取应用）
• 希望简化Next.js应用部署流程，实现"构建即部署"的开发团队
• 需要利用Fleek边缘网络提升全球用户访问速度的Next.js应用

使用方法与配置说明

前提条件

• 已安装Node.js（v14+）及npm/yarn包管理器
• 已创建Next.js应用（确认包含SSR功能实现）
• 已注册Fleek账户并完成平台身份验证
• 本地已安装Fleek CLI工具

基础使用流程

1. 安装适配器

在Next.js项目根目录执行以下命令安装适配器：

bash
npm install @fleekhq/nextjs-adapter --save-dev
# 或使用yarn
yarn add @fleekhq/nextjs-adapter --dev

2. 配置部署参数

在项目根目录创建或修改fleek.json配置文件：

json
{
  "build": {
    "command": "npm run build",
    "output": ".next",
    "environment": {
      "NODE_ENV": "production"
    }
  },
  "deploy": {
    "adapter": "@fleekhq/nextjs-adapter",
    "publicDir": "public"
  }
}

3. 执行部署命令

通过Fleek CLI启动部署流程：

bash
fleek deploy

Docker化部署示例

Dockerfile配置

dockerfile
FROM node:18-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm install @fleekhq/nextjs-adapter --save-dev
RUN npm run build

FROM node:18-alpine
WORKDIR /app
COPY --from=builder /app/package*.json ./
COPY --from=builder /app/node_modules ./node_modules
COPY --from=builder /app/.next ./.next
COPY --from=builder /app/public ./public
COPY --from=builder /app/fleek.json ./

CMD ["npx", "fleek", "deploy"]

构建并运行容器

bash
# 构建镜像
docker build -t fleek-nextjs-deployer .

# 执行部署
docker run --rm -e FLEEK_API_KEY=your_api_key fleek-nextjs-deployer

环境变量配置

部署过程中可通过环境变量调整适配器行为：

• FLEEK_API_KEY: Fleek平台API密钥（必需，用于身份验证）
• NEXT_PUBLIC_API_URL: 配置Next.js应用的公共API基础路径
• ADAPTER_LOG_LEVEL: 日志输出级别（可选，值为debug/info/warn/error，默认info）

注意事项

• 确保Next.js应用的next.config.js中未设置与Fleek部署冲突的输出配置
• 对于大型应用，建议在部署前本地验证npm run build命令可成功执行
• 如需自定义服务器配置，可在fleek.json中添加server字段定义端口、超时等参数