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

# 如何迁移到Gatekeeper

> 逐步指导将您的应用程序迁移到Gatekeeper

迁移到Gatekeeper**不到5分钟**即可完成。这只是一个简单的URL更改——您的API密钥无需任何修改即可使用。

## 快速迁移

只需替换现有的端点：

<CodeGroup>
  ```javascript Before theme={"system"}
  const url = "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY";
  ```

  ```javascript After theme={"system"}
  const url = "https://beta.helius-rpc.com/?api-key=YOUR_API_KEY";
  ```
</CodeGroup>

**就是这样！**

测试您的应用程序，监控性能，并在准备好时进行部署。

## 特定框架示例

<Tabs>
  <Tab title="Solana Web3.js">
    ```javascript theme={"system"}
    import { Connection } from '@solana/web3.js';

    const connection = new Connection(
      `https://beta.helius-rpc.com/?api-key=${YOUR_API_KEY}`,
      'confirmed'
    );
    ```
  </Tab>

  <Tab title="Anchor">
    ```javascript theme={"system"}
    import { AnchorProvider } from '@coral-xyz/anchor';
    import { Connection } from '@solana/web3.js';

    const connection = new Connection(
      `https://beta.helius-rpc.com/?api-key=${YOUR_API_KEY}`,
      'confirmed'
    );

    const provider = new AnchorProvider(connection, wallet, {
      commitment: 'confirmed'
    });
    ```
  </Tab>

  <Tab title="Solana-py">
    ```python theme={"system"}
    from solana.rpc.api import Client

    rpc_url = f"https://beta.helius-rpc.com/?api-key={YOUR_API_KEY}"
    client = Client(rpc_url)
    ```
  </Tab>

  <Tab title="Rust">
    ```rust theme={"system"}
    use solana_client::rpc_client::RpcClient;

    let rpc_url = format!("https://beta.helius-rpc.com/?api-key={}", YOUR_API_KEY);
    let client = RpcClient::new(rpc_url);
    ```
  </Tab>

  <Tab title="环境变量">
    ```bash theme={"system"}
    # .env file
    HELIUS_RPC_URL=https://beta.helius-rpc.com/?api-key=YOUR_API_KEY
    ```
  </Tab>
</Tabs>

## WebSocket 端点

如果您使用 WebSockets，也要更新这些端点：

```javascript theme={"system"}
// Before
const ws = new WebSocket("wss://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY");

// After
const ws = new WebSocket("wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY");
```

## 迁移清单

<Steps>
  <Step title="更新端点 URL">
    将 `mainnet.helius-rpc.com` 更改为 `beta.helius-rpc.com`
  </Step>

  <Step title="在开发中测试">
    验证所有 RPC 调用工作正常并且身份验证成功
  </Step>

  <Step title="监控性能">
    检查您的指标以提高延迟和响应时间
  </Step>

  <Step title="部署到生产环境">
    使用标准部署流程进行更改
  </Step>
</Steps>

## 渐进式推出（可选）

为实现更安全的迁移，您可以使用环境变量或功能标志：

```javascript theme={"system"}
// Environment-based
const endpoint = process.env.USE_GATEKEEPER
  ? "https://beta.helius-rpc.com"
  : "https://mainnet.helius-rpc.com";

const connection = new Connection(
  `${endpoint}?api-key=${YOUR_API_KEY}`,
  'confirmed'
);
```

```javascript theme={"system"}
// Percentage rollout (10% of traffic)
const useGatekeeper = Math.random() < 0.1;
const endpoint = useGatekeeper
  ? "https://beta.helius-rpc.com"
  : "https://mainnet.helius-rpc.com";
```

## 回滚

如有需要，只需切换回标准端点：

```javascript theme={"system"}
const url = "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY";
```

## 故障排除

<AccordionGroup>
  <Accordion title="获取 401 未经授权的错误">
    确保您的 API 密钥已包含：`?api-key=YOUR_API_KEY`
  </Accordion>

  <Accordion title="未见性能提升">
    * 从生产环境（而非本地开发）进行测试
    * 确认您没有触及速率限制（检查 429 错误）
    * 如果问题仍然存在，请联系支持
  </Accordion>

  <Accordion title="WebSocket 连接失败">
    * 使用 `wss://`（而不是 `ws://`）
    * 确保您的 API 密钥在 URL 中
    * 检查防火墙设置
  </Accordion>

  <Accordion title="响应格式看起来不同">
    Gatekeeper 返回相同的响应。如果您发现差异，请立即联系支持。
  </Accordion>
</AccordionGroup>

## 需要帮助？

* **电子邮件**: [support@helius.dev](mailto:support@helius.dev)
* **Discord**: [https://discord.com/invite/6GXdee3gBj](https://discord.com/invite/6GXdee3gBj)
* **文档**: [Gatekeeper 概述](/zh/gatekeeper/overview)

<Card title="有关迁移的问题？" icon="comments" href="https://discord.com/invite/6GXdee3gBj">
  加入我们的 Discord，与团队和其他开发者交流
</Card>