> For AI agents: the complete documentation index is available at /zh/llms.txt, the full documentation bundle is available at /zh/llms-full.txt.

# server.port

- **类型：** `number`
- **默认值：** `3000`

设置 Rsbuild server 监听的端口号。

默认情况下，Rsbuild server 会监听 3000 端口，并在端口被占用时自动递增端口号。当你开启 [server.strictPort](/zh/config/server/strict-port.md) 配置时，如果端口被占用，Rsbuild server 会抛出异常，而不是递增端口号。

Rsbuild CLI 提供了 [--port](/zh/guide/basic/cli.md#rsbuild) 选项来设置端口号，`--port` 选项的优先级高于 `server.port` 配置。

```bash
npx rsbuild --port 8080
```

## 示例

将端口设置为 `8080`：

```ts title="rsbuild.config.ts"
export default {
  server: {
    port: 8080,
  },
};
```

为开发服务器和预览服务器设置不同的端口号：

```ts title="rsbuild.config.ts"
export default {
  server: {
    port: process.env.NODE_ENV === 'development' ? 3000 : 8080,
  },
};
```

## 动态端口

将 `server.port` 设置为 `0`，让操作系统自动分配一个可用端口：

```ts title="rsbuild.config.ts"
export default {
  server: {
    port: 0,
  },
};
```

这在测试场景中尤其有用，可以避免多个测试同时启动 Rsbuild server 时发生端口冲突。

## 版本历史

| 版本     | 变更内容               |
| ------ | ------------------ |
| v2.2.0 | 支持将值设为 `0` 来使用动态端口 |