# @fluixi/server 中文文档

规范地址：https://npmcn.com/package/%40fluixi/server/

版本：1\.0\.0-alpha\.108
npm 元数据更新时间：2026-11-07T01:10:55.838Z
中文译文更新时间：2026-11-15T02:16:11.341Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40fluixi/server
原文对照：https://npmcn.com/package/%40fluixi/server/?lang=original
项目主页：https://github.com/fluixi/core#readme
源码仓库：https://github.com/fluixi/core

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：84.7 kB，9 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@fluixi/dom ^1\.0\.0-alpha\.108，@fluixi/head ^1\.0\.0-alpha\.108，@fluixi/reactive ^1\.0\.0-alpha\.108
- 首次发布：2026-07-10T03:17:08.934Z
- 最新版本发布：2026-11-07T01:09:00.373Z
- 近 30 天下载量：6086（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：56（近 12 个月 56 个）

## 中文简介

Fluixi的服务器侧渲染——请求范围,流线,框架不可知.

## 安装

```sh
npm install @fluixi/server
```

也可以使用：`pnpm add @fluixi/server`、`yarn add @fluixi/server`、`bun add @fluixi/server`

## README

![Fluixi](https://raw.githubusercontent.com/fluixi/assets/main/logos/128x128.png)

# @fluixi/服务器

**Fluixi的服务器侧渲染:请求扫描,流线,框架-不可知.**

[![License: MIT](https://img.shields.io/badge/License-MIT-22c55e.svg)](https://npmcn.com/package/%40fluixi/server/LICENSE) ![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6?logo=typescript&logoColor=white) [![npm](https://img.shields.io/npm/v/@fluixi/server?logo=npm)](https://www.npmjs.com/package/@fluixi/server) ![SSR](https://img.shields.io/badge/SSR-streaming%20%2B%20hydration-2c4f7c)

* * *

## \* 概览

通用字符串渲染器位于 [`@fluixi/dom`](https://npmcn.com/package/%40fluixi/dom) (单位:千美元)`renderToString` + 键 请求范围; `@fluixi/server` 这是 **节点家庭** 就是这样 货币安全和人类学:

-   注入一个 `AsyncLocalStorage` 输入 `@fluixi/dom`'请求存储器如此并行 SSR 请求是孤立的(`@fluixi/dom` 永远不导入以保持浏览器安全 `node:async_hooks` (b) 与《公约》有关的其他事项;
-   重新出口安全部门改革表面(`renderToString`, (中文(简体) ), `renderToStringAsync`, (中文(简体) ), `getRequestEvent`, (中文(简体) ), 请求文本原始;
-   添加请求助手( e)`renderRequest`, (中文(简体) ), `renderRequestAsync`, (中文(简体) ), `renderRequestToPage`, (中文(简体) ), `renderToBodyStream`, (中文(简体) ), `startServer`, (中文(简体) ), `createHtmlDocument`) (中文(简体) ).

没有元框架组合 : SSR 是您从任何服务器调用的纯函数( Express, 霍诺,一个工人,或者 [`@fluixi/start`](https://npmcn.com/package/%40fluixi/start)) (中文(简体) ).

## \* 安装

```sh
pnpm add @fluixi/server
```

## 使用量

```ts
import { startServer } from '@fluixi/server';
import App from './app';

const { render, page, renderAsync, stream } = startServer(App);
// express: res.send(page(req.url))
```

### Async 数据( 暂停/ 资源)

`renderRequestAsync` (和 `startServer().renderAsync`等待数据加载器 序列化,然后发出一个 `window.__FX_DATA__` 脚本 所以客户端种子资源 不牵引 :

```ts
import { renderRequestAsync } from '@fluixi/server';
const html = await renderRequestAsync(App, { url });
```

### 流线

```ts
import { renderToBodyStream } from '@fluixi/server';
// a web ReadableStream of the app body — the host owns the surrounding document
export const renderStream = (url) => renderToBodyStream(App, { url });
```

### 请求范围数据+编辑

```ts
import { getRequestEvent, setDataRedactor } from '@fluixi/server';

// inside a component / loader:
getRequestEvent()?.request; // the web Request (headers, cookies, …)

// strip server-only fields from __FX_DATA__ before they reach the page:
setDataRedactor((v) => (v?.passwordHash ? { ...v, passwordHash: undefined } : v));
```

## 许可证

[麻省理工学院](https://npmcn.com/package/%40fluixi/server/LICENSE) © [风花](https://fluixi.dev/)

## 常见问题

### @fluixi/server 是什么？

Fluixi的服务器侧渲染——请求范围,流线,框架不可知\.

### 如何安装 @fluixi/server？

在项目目录运行 npm install @fluixi/server，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@fluixi/dom（^1\.0\.0-alpha\.108）、@fluixi/head（^1\.0\.0-alpha\.108）、@fluixi/reactive（^1\.0\.0-alpha\.108）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @fluixi/server 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @fluixi/server 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @fluixi/server 可以商用吗？

@fluixi/server 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @fluixi/server 的下载量有多少？

根据 npm 官方下载统计，@fluixi/server 在 2026/10/15 – 2026/11/13 这 30 天内被下载 6,086 次，日均约 203 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @fluixi/server 还在维护吗？

最新版本 1\.0\.0-alpha\.108 发布于 2026/11/07（8 天前）；至今共发布 56 个版本，其中过去 12 个月发布了 56 个；首次发布于 2026/07/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。