---
sidebar_label: ssr
---

# server.ssr

- **类型：** `boolean` | `Object`
- **默认值：** `false`

SSR 开关以及相关设置。

### Boolean 类型

当值类型为 `boolean` 时，表示是否开启 SSR 部署模式，默认 `false` 不开启。

```ts title="modern.config.ts"
export default defineConfig({
  server: {
    ssr: true,
  },
});
```

### Object 类型

当值类型为 `Object` 时，可以配置如下属性：

- `mode`：`string = 'string'`，默认为使用 `renderToString` 渲染。配置为 'stream' 开启流式渲染。
- `forceCSR`：`boolean = false`，默认关闭强制 CSR 渲染。配置为 `true` 后，在页面访问时添加 `?csr=true` 即可强制 CSR。
- `inlineScript`：`boolean = true`，默认情况下，SSR 的数据会以内联脚本的方式注入到 HTML 中，并且直接赋值给全局变量。配置为 `false` 后，会下发 JSON，而不是赋值给全局变量。


```ts title="modern.config.ts"
export default defineConfig({
  server: {
    forceCSR: true,
    mode: 'stream',
    inlineScript: false,
  },
});
```
