@fluixi/server

中文文档
1.0.0-alpha.108发布于 2026/11/07MITTypeScriptESM + CJS零依赖近 30 天下载 6086

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

中文使用文档
文档目录7 节
  1. * 概览
  2. * 安装
  3. 使用量
  4. Async 数据( 暂停/ 资源)
  5. 流线
  6. 请求范围数据+编辑
  7. 许可证

Fluixi

@fluixi/服务器

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

License: MIT TypeScript npm SSR


* 概览

通用字符串渲染器位于 @fluixi/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) (中文(简体) ).

* 安装

pnpm add @fluixi/server

使用量

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__ 脚本 所以客户端种子资源 不牵引 :

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

流线

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 });

请求范围数据+编辑

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));

许可证

麻省理工学院 © 风花

版本与发布记录

@fluixi/server 共发布 56 个版本,首次发布于 2026/07/10;过去 12 个月发布了 56 个版本。

版本发布日期距今
1.0.0-alpha.108latest2026/11/078 天前
1.0.0-alpha.1072026/11/0511 天前
1.0.0-alpha.1062026/11/0213 天前
1.0.0-alpha.1052026/11/0115 天前
1.0.0-alpha.1042026/11/0115 天前
1.0.0-alpha.1032026/10/2620 天前

关于 @fluixi/server 的常见问题

@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 和提交记录判断。