# @fudrouter/fsrouter 中文文档

规范地址：https://npmcn.com/package/%40fudrouter/fsrouter/

版本：0\.6\.283
npm 元数据更新时间：2026-07-28T02:13:04.099Z
中文译文更新时间：2026-11-15T17:28:52.181Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40fudrouter/fsrouter
原文对照：https://npmcn.com/package/%40fudrouter/fsrouter/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：20.7 MB，1399 个文件
- TypeScript 类型：未声明
- 运行依赖：23 个
- 首次发布：2026-07-14T15:55:58.946Z
- 最新版本发布：2026-07-28T02:13:03.940Z
- 近 30 天下载量：2027（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：272（近 12 个月 272 个）

## 中文简介

9 Router v2 — Monorepo( 前端+后端)

## 安装

```sh
npm install @fudrouter/fsrouter
```

也可以使用：`pnpm add @fudrouter/fsrouter`、`yarn add @fudrouter/fsrouter`、`bun add @fudrouter/fsrouter`

## README

# FSRouter (英语)

> 自办AI网关——一端点,多提供商,自发回落.

FSRouter是9路特的解码重写器,一个专用的分离 **快递后端** (单位:千美元) **维特+ 反应前端**它暴露出一个与OpenAI兼容的 REST API ,该API 代表数十个自动负载平衡、倒置和密钥旋转的 AI 供应商提出请求.

* * *

## 截图

| 登录页面 | 配额跟踪器 |
| --- | --- |
| ![Login Page](https://npmcn.com/package/%40fudrouter/fsrouter/docs/screnshoot/login-page.png) | ![Quota Tracker](https://npmcn.com/package/%40fudrouter/fsrouter/docs/screnshoot/quota-tracker.png) |

* * *

## 特征

-   **OpenAI 兼容 API** - 与任何支持客户端合作 `/v1/chat/completions`, (中文(简体) ), `/v1/images/generations`, (中文(简体) ), `/v1/audio/speech`, (中文(简体) ), `/v1/embeddings`等 (中文(简体) ).
-   **多供应商路线** - Cloudflare工人AI、OpenAI、Anthropic、双子座、格罗克和许多其他
-   **Cloudflare工人 AI 自动化** ——通过 Playwright + 2 Captcha + FSMail 临时邮件自动实现账户注册和API 密钥提取
-   **Dashboard 用户界面** ——管理供应商,连接,代理集合,CLI工具,以及现代暗模式界面的自动化
-   **OIDC/ 密码认证** ——单一签注或当地证书
-   **代理技能** ——Claude,双子座,Codex等AI编码代理的即时使用SKILL.md文件
-   **SQLite 后端** 零依赖性当地数据库,不需要外部服务

* * *

## 建筑

```
FSRouter/
├── backend/          # Express server (port 3001)
│   └── src/
│       ├── routes/   # Auto-routed endpoints (/v1, /api, /auth, ...)
│       ├── db/       # SQLite via better-sqlite3
│       └── automation/ # Playwright automation scripts
├── frontend/         # Vite + React SPA (port 5177)
│   └── src/
│       ├── pages/    # Dashboard pages
│       └── shared/   # Components, hooks, constants
└── skills/           # Agent SKILL.md files
```

* * *

## 快速启动

### 所需资源

-   节点.js 20+
-   Python 3.10+(用于自动化特性)
-   铬 (用于 Playwright 自动化)

### 安装

```bash
git clone https://github.com/nexusrouters/fsrouter.git
cd FSRouter
npm install
```

### 发展

```bash
npm run dev          # Start both backend + frontend concurrently
npm run backend      # Backend only (port 3001)
npm run frontend     # Frontend only (port 5177)
```

### 环境变量

复制并配置后端环境 :

```bash
cp backend/.env.template backend/.env
```

关键变量 :

| 变量 | 说明 |
| --- | --- |
| `PORT` | 后端服务器端口( 默认 ): `3001`(中文(简体) ) |
| `REQUIRE_LOGIN` | 启用认证( E)`true`编号 :`false`(中文(简体) ) |
| `JWT_SECRET` | JWT 签名的秘密 |
| `ADMIN_PASSWORD` | 密码 |

* * *

## 生产部署

### 1\. 构建前端

```bash
cd frontend && npm run build
```

### 2\. 启动后端

```bash
cd backend && npm start
```

### 3\. Nginx 反向代理

使用包含 `nginx.conf` 到代理服务器 `/api` 财务报告和审定财务报表 `/v1` 到后端,同时静态为已建的前端服务。 见 `docs/deployment-linux.md` 一个完整的Linux部署指南.

* * *

## Cloudflare工人 AI 自动化

自动化模块自动登记 Cloudflare 工人AI账户:

1.  配置 **密克罗尼西亚联邦** dashboard 中的临时邮件证书 – 自动化 – 设置
2.  添加一个 **2 Captcha (英语)** Turnstile 解析的 API 密钥
3.  在自动化标签上添加电子邮件账户并单击 **运行**
4.  API 密钥被提取并自动添加到 FSRouter

* * *

## 代理技能

技能是用于AI编码代理的SKILL.md文件. 将输入技能 URL 粘贴到您的 AI 中 :

```
Read this skill and use it:
https://raw.githubusercontent.com/nexusrouters/fsrouter/refs/heads/main/skills/fsrouter/SKILL.md
```

浏览 Dashboard 中的所有技能 – 技能页或 [`skills/`](https://npmcn.com/package/%40fudrouter/fsrouter/skills/) 目录.

* * *

## API 参考

| 终点 | 说明 |
| --- | --- |
| `GET /api/health` | 健康检查 |
| `GET /v1/models` | 列出可用的聊天/ LLM 模型 |
| `POST /v1/chat/completions` | 聊天完成( 支持流化) |
| `POST /v1/images/generations` | 图像生成 |
| `POST /v1/audio/speech` | 文字对语音 |
| `POST /v1/audio/transcriptions` | 语音对文本 |
| `POST /v1/embeddings` | 文本嵌入 |
| `GET /v1/search` | 网络搜索 |

* * *

## 许可证

麻省理工学院——见 [自由主义](https://npmcn.com/package/%40fudrouter/fsrouter/LICENSE)

* * *

## 鸣谢

> 🙏 **感谢 [FSRouter (英语)](https://github.com/decolua/9router)** ——这个项目是原FSRouter单体的分叉和建筑重写. 核心的路由逻辑,提供商集成,以及许多地物被FSRouter项目的出色工作所启发并发扬光大.

## 常见问题

### @fudrouter/fsrouter 是什么？

9 Router v2 — Monorepo\( 前端\+后端\)

### 如何安装 @fudrouter/fsrouter？

在项目目录运行 npm install @fudrouter/fsrouter，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 amrouter、fsrouter，可以用 npx amrouter 直接运行。

### @fudrouter/fsrouter 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/fudrouter\_\_fsrouter 是否存在。

### @fudrouter/fsrouter 可以商用吗？

@fudrouter/fsrouter 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @fudrouter/fsrouter 的下载量有多少？

根据 npm 官方下载统计，@fudrouter/fsrouter 在 2026/10/16 – 2026/11/14 这 30 天内被下载 2,027 次，日均约 68 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @fudrouter/fsrouter 还在维护吗？

最新版本 0\.6\.283 发布于 2026/07/28（3 个月前）；至今共发布 272 个版本，其中过去 12 个月发布了 272 个；首次发布于 2026/07/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。