---
sidebar_position: 5
title: 使用 BFF 代理
---
# 使用 BFF 代理

通过配置 BFF 代理，无需手动写码，即可对 API 请求进行转发。

:::caution
使用 BFF 代理需确保请求能进入 BFF handler。（例如请求路径必须包含 bff prefix）

:::

在 `modern.server-runtime.config.js` 文件中编写以下 BFF 代理配置，会将发送到 `http://localhost:8080/api/v1/topics` 的请求代理到 `https://cnodejs.org/api/v1/topics`。

```js title="modern.server-runtime.config.js"
import { defineConfig } from '@modern-js/app-tools/server';
export default defineConfig({
  bff: {
    proxy: {
      '/api/v1/topics': 'https://cnodejs.org',
    },
  },
};
```

:::note
详细 API 请查看 [BFF 代理](/configure/app/bff/proxy)。更多 Modern.js 代理的能力可查看[调试代理](/guides/basic-features/proxy)。

:::
