insforge--insforge/README.md

Note

本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。
English · 原始项目 · 上游 README
原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。

面向智能体编程（agentic coding）的一体化开源后端平台。

⭐ 帮助我们触达更多开发者并壮大 InsForge 社区。请为本仓库点亮 Star！

InsForge

面向智能体编程（agentic coding）的一体化开源后端平台。InsForge 为你的编码智能体提供数据库、认证（auth）、存储、计算、托管和 AI 网关，助你端到端交付全栈应用。

https://github.com/user-attachments/assets/345efbc6-ca63-4189-bde0-12ef3bda561b

工作原理

编码智能体可通过以下两种接口之一与 InsForge 交互：

• MCP Server（自托管与云端）：将 InsForge 的操作暴露为工具，任何兼容 MCP 的智能体均可调用。
• CLI + Skills（仅云端）：命令行界面，配合 Skills，供智能体在终端中直接调用。

两种接口都让编码智能体像后端工程师一样操作后端：

• 读取后端上下文与状态：拉取文档、模式（schema）、元数据（已部署函数、存储桶内容、认证配置）以及运行时日志，让智能体具备编写代码、验证构建成果以及在出问题时进行调试所需的信息。
• 配置基础能力：直接部署边缘函数、运行数据库迁移、创建存储桶、设置认证提供方，并配置其他后端资源。

graph TB

    subgraph TOP[" "]
        AG[AI Coding Agents]
    end

    subgraph MID[" "]
        SL[InsForge]
    end

    AG --> SL

    SL --> AUTH[Authentication]
    SL --> DB[Database]
    SL --> ST[Storage]
    SL --> EF[Edge Functions]
    SL --> MG[Model Gateway]
    SL --> CP[Compute]
    SL --> DEP[Deployment]

    classDef bar fill:#0b0f14,stroke:#30363d,stroke-width:1px,color:#ffffff
    classDef card fill:#161b22,stroke:#30363d,stroke-width:1px,color:#ffffff

    class AG,SL bar
    class AUTH,DB,ST,EF,MG,CP,DEP card

    style TOP fill:transparent,stroke:transparent
    style MID fill:transparent,stroke:transparent

    linkStyle default stroke:#30363d,stroke-width:1px

核心产品：

• Authentication：用户管理、认证与会话
• Database：Postgres 关系型数据库
• Storage：兼容 S3 的文件存储
• Model Gateway：跨多家 LLM 提供商的 OpenAI 兼容 API
• Edge Functions：在边缘运行的无服务器代码
• Compute（私有预览）：长期运行的容器服务
• Site Deployment：站点构建与部署

⭐️ 为仓库点亮 Star

如果你觉得 InsForge 有用或有趣，非常欢迎点亮 GitHub Star ⭐️。

快速开始

云端托管：insforge.dev

自托管：Docker Compose

前置要求：Docker + Node.js

1. 安装配置

你可以使用 Docker Compose 在本地运行 InsForge。这会在你的机器上启动一个本地 InsForge 实例。

或从源码运行：

# Run with Docker
git clone https://github.com/InsForge/InsForge.git
cd insforge
cp .env.example .env
docker compose -f docker-compose.prod.yml up

2. 连接 InsForge MCP

打开 http://localhost:7130

按照步骤连接 InsForge MCP Server

3. 验证安装

要验证连接，请向你的智能体发送以下提示：

I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool to learn about InsForge instructions.

4. 运行多个项目

你可以在同一主机上通过使用不同端口和项目名称来运行多个 InsForge 项目。

# Create a separate env file for each project
cp .env.example .env.project1
cp .env.example .env.project2

编辑 .env.project2，使用不同端口：

POSTGRES_PORT=5442
POSTGREST_PORT=5440
APP_PORT=7230
AUTH_PORT=7231
DENO_PORT=7233

使用唯一名称启动每个项目：

docker compose -f docker-compose.prod.yml --env-file .env.project1 -p project1 up -d
docker compose -f docker-compose.prod.yml --env-file .env.project2 -p project2 up -d

每个项目都会获得各自独立的数据库、存储和配置。使用以下命令管理它们：

docker compose -f docker-compose.prod.yml --env-file .env.project1 -p project1 ps      # status
docker compose -f docker-compose.prod.yml --env-file .env.project1 -p project1 logs -f  # logs
docker compose -f docker-compose.prod.yml --env-file .env.project1 -p project1 down     # stop

一键部署

除了在本地运行 InsForge，你还可以通过预配置方案启动 InsForge。这样无需在本地安装 Docker，即可快速上手 InsForge。

Railway	Zeabur	Sealos

贡献

贡献：如有兴趣参与贡献，可参阅我们的指南 CONTRIBUTING.md。我们非常欢迎 Pull Request（PR），任何形式的帮助都令人感激！

支持：如需帮助或支持，欢迎在 Discord 频道, 与我们交流，也可发邮件至 info@insforge.dev！

文档与支持

文档

• 官方文档 - 全面的指南与 API 参考

社区

• Discord - 加入我们的活跃社区
• Twitter - 关注以获取更新与技巧

联系方式

• Email：info@insforge.dev

许可证

本项目采用 Apache License 2.0 许可证——详情请参阅 LICENSE 文件。

---

徽章

展示你的项目基于 InsForge 构建。

Made with InsForge

Markdown:

[![Made with InsForge](https://insforge.dev/badge-made-with-insforge.svg)](https://insforge.dev)

HTML:

<a href="https://insforge.dev">
  <img
    width="168"
    height="30"
    src="https://insforge.dev/badge-made-with-insforge.svg"
    alt="Made with InsForge"
  />
</a>

Made with InsForge (dark)

Markdown:

[![Made with InsForge](https://insforge.dev/badge-made-with-insforge-dark.svg)](https://insforge.dev)

HTML:

<a href="https://insforge.dev">
  <img
    width="168"
    height="30"
    src="https://insforge.dev/badge-made-with-insforge-dark.svg"
    alt="Made with InsForge"
  />
</a>

⭐ 在 GitHub 上为我们 Star，以便及时获知新版本发布！