> [!NOTE] > 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。 > [English](./README.en.md) · [原始项目](https://github.com/InsForge/InsForge) · [上游 README](https://github.com/InsForge/InsForge/blob/HEAD/README.md) > 原作者、版权与许可证归属以原始项目及本仓库 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）、元数据（已部署函数、存储桶内容、认证配置）以及运行时日志，让智能体具备编写代码、验证构建成果以及在出问题时进行调试所需的信息。 - **配置基础能力**：直接部署边缘函数、运行数据库迁移、创建存储桶、设置认证提供方，并配置其他后端资源。 ```mermaid 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](https://insforge.dev)

### 自托管：Docker Compose 前置要求：[Docker](https://www.docker.com/) + [Node.js](https://nodejs.org/) #### 1. 安装配置你可以使用 Docker Compose 在本地运行 InsForge。这会在你的机器上启动一个本地 InsForge 实例。 [![Deploy on Docker][docker-btn]][docker-deploy] 或从源码运行： ```bash # 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](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 项目。 ```bash # 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 ``` 使用唯一名称启动每个项目： ```bash 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 ``` 每个项目都会获得各自独立的数据库、存储和配置。使用以下命令管理它们： ```bash 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 | | --- | --- | --- | | [![在 Railway 上部署](https://railway.com/button.svg)](https://railway.com/deploy/insforge) | [![在 Zeabur 上部署](https://zeabur.com/button.svg)](https://zeabur.com/templates/Q82M3Y) | [![在 Sealos 上部署](https://sealos.io/Deploy-on-Sealos.svg)](https://sealos.io/products/app-store/insforge) | ## 贡献 **贡献**：如有兴趣参与贡献，可参阅我们的指南 [CONTRIBUTING.md](CONTRIBUTING.md)。我们非常欢迎 Pull Request（PR），任何形式的帮助都令人感激！ **支持**：如需帮助或支持，欢迎在 [Discord 频道](https://discord.com/invite/MPxwj5xVvW), 与我们交流，也可发邮件至 [info@insforge.dev](mailto:info@insforge.dev)！ ## 文档与支持 ### 文档 - **[官方文档](https://docs.insforge.dev/introduction)** - 全面的指南与 API 参考 ### 社区 - **[Discord](https://discord.com/invite/MPxwj5xVvW)** - 加入我们的活跃社区 - **[Twitter](https://x.com/InsForge)** - 关注以获取更新与技巧 ### 联系方式 - **Email**：info@insforge.dev ## 许可证本项目采用 Apache License 2.0 许可证——详情请参阅 [LICENSE](LICENSE) 文件。 --- [![Star History Chart](https://api.star-history.com/svg?repos=InsForge/InsForge&type=Date)](https://www.star-history.com/#InsForge/InsForge&Date) ## 徽章展示你的项目基于 InsForge 构建。 ### Made with InsForge

**Markdown:** ```md [![Made with InsForge](https://insforge.dev/badge-made-with-insforge.svg)](https://insforge.dev) ``` **HTML:** ```html

``` ### Made with InsForge (dark)

**Markdown:** ```md [![Made with InsForge](https://insforge.dev/badge-made-with-insforge-dark.svg)](https://insforge.dev) ``` **HTML:** ```html

```

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

[docker-btn]: ./deploy/buttons/docker.png [docker-deploy]: ./deploy/docker-deploy.md