> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sunra.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 伺服器端整合

雖然 Sunra 的 API 端點可以直接從客戶端程式碼存取，但在這樣的環境中儲存 API 金鑰會帶來重大的安全風險。為了解決這個問題，開發人員通常會建立自訂的伺服器端 API，在將結果傳回客戶端之前，安全地與像 Sunra 這樣的第三方服務互動。雖然這種方法有效，但它常常會分散團隊專注於其核心業務目標的注意力。

為簡化此流程，我們開發了支援代理模式的客戶端函式庫。此功能讓您能夠在前端程式碼中利用客戶端函式庫，同時將 API 金鑰安全地保留在您的伺服器端基礎設施中。

### 預先建置的代理程式解決方案

我們為幾個熱門的框架提供預先建置的代理程式解決方案：

* Node.js with Next.js：一個 Next.js API 路由處理常式，可用於任何 Next.js 應用程式。它支援 [Page](https://github.com/sunra-ai/sunra-clients/tree/main/examples/demo-nextjs-page-router) 和 [App](https://github.com/sunra-ai/sunra-clients/tree/main/examples/demo-nextjs-app-router) 路由器。我們自己在所有生產環境中的應用程式都使用它。
* [Node.js with Express](https://github.com/sunra-ai/sunra-clients/tree/main/examples/demo-express-app)：一個 Express 路由處理常式，可用於任何 Express 應用程式。您也可以實作自訂邏輯並與您自己的處理常式組合。

我們致力於根據社群的回饋擴展我們的產品。如果您有特定的請求或建議，請[與我們聯絡](https://sunra.ai/contact)分享您的想法。

### 設定代理程式

若要整合代理程式功能，請在您的設定中指定 `proxyUrl` 來設定您的客戶端：

```javascript theme={null}
import { sunra } from "@sunra/client";

sunra.config({
  proxyUrl: "/api/sunra/proxy",
});
```

此設定可確保 API 呼叫透過您的伺服器路由，從而增強安全性並簡化開發。
