# @formio/appserver 中文文档

规范地址：https://npmcn.com/package/%40formio/appserver/

版本：2\.26\.4
npm 元数据更新时间：2026-11-07T03:57:10.630Z
中文译文更新时间：2026-11-15T09:12:04.668Z
软件包许可：OSL-3\.0

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

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

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

- 包体积（解压后）：98.2 kB，17 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.0\.0
- 运行依赖：10 个
- 首次发布：2023-04-26T18:34:27.213Z
- 最新版本发布：2026-11-07T03:57:10.441Z
- 近 30 天下载量：4338（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：126（近 12 个月 47 个）

## 中文简介

高性能和可扩展的Form.io多用途部署应用程序服务器.

## 安装

```sh
npm install @formio/appserver
```

也可以使用：`pnpm add @formio/appserver`、`yarn add @formio/appserver`、`bun add @formio/appserver`

## README

## Form.io App 服务器

Form.io App Server是一个表演者运行时应用程序服务器,用于在一个部署的单一端点服务单个项目模板(包括表格,资源,角色等).

其目标如下:

-   提供单个项目运行时服务器, 其中不提交资源被缓存到内存中 .
-   启用多租户/多数据库部署.
-   提供可扩展的服务器侧功能, 如自定义动作 .
-   除蒙戈DB兼容数据库外,还支持其他数据库提交数据.

### 安装

要使用此库, 您必须在 Express. 举例来说,您可以先创建一个新的 Express.js 程序 [Express.js 应用程序](https://expressjs.com/en/starter/installing.html) 然后按以下方式安装和使用服务器.

```
npm install --save @formio/appserver
```

然后在您的 server.js 文件中,您会添加以下内容 .

```js
const express = require('express');
const app = express();
const { Server } = require('@formio/appserver');
(async function bootup() {
    // Create the server.
    const server = new Server();

    // Add the server router.
    app.use(await server.router());

    // Start server.
    app.listen(process.env.PORT, () => {
        console.log(`Server running on port ${process.env.PORT}`);
    });
})();
```

### 许可证

Form.io App Server确实需要许可证才能运行. 如果你想尝试这项技术,请联系我们@ [https://form.io/ contact-us (中文(简体) )](https://form.io/contact-us)

### 本地运行

要在本地运行此库, 您可以克隆仓库, 然后安装 npm .

```
yarn install
```

然后做以下诸事.

```
cp .env.example .env
```

现在,在 `.env` 文件,修改所有环境变量,成为正确的值。 接下来,您可以使用以下方式运行服务器 .

```
node index
```

### 环境变量

此库使用环境变量来配置运行服务器所需的配置. 具体情况如下.

| 变量名称 | 需求 | 说明 | 示例 |
| --- | --- | --- | --- |
| 蒙古 | 对 | 您的蒙戈DB 使用默认 DB 的连接字符串 . | mongodb://localhost:27017/ 申请服务员 |
| 项目 | 对 | 您部署的Form.io企业项目的终点. | [https://mycomposition.com/我的项目](https://mydeployment.com/myproject) |
| 项目 KEY | 对 | 您部署的 Form.io 企业项目 的 API 密钥 . | abc123 (中文(简体) ) |
| 申请者( L) | 对 | 您的 App 服务器部署许可证密钥 . |  |
| 港口 | 没有 | 您的服务器将运行的端口 。 默认 3005 | 3005号 |
| 意 题 | 对 | 用于保护您的 JWT 认证符的密钥 . | 你的小宝贝 |
| JWT EXPIE TIME (英语) | 没有 | 服务器自身标志的分数为最后. | 页:1 |
| 葡萄牙语NAME | 没有 | 提供通过开发者门户网站中的远程环境连接连接 App 服务器的能力. | 你的小宝贝 |
| 计划( C) | 没有 | 禁用项目资源的缓存(例如项目模板、项目设置和访问设置)。 默认"真" | 真实 |
| 项目 TTL | 没有 | 多少次,在秒内,项目的形式,资源和动作再次被加载,这就是门户中或部署到项目上的更改如何到达App Server. `0` 禁用刷新 。 默认 900 | 900个 |
| 温度 SYNC | 没有 | 模块中的形式、资源和行动 `template` 缺少的工程安装在其中: `boot` 一旦启动, `refresh` 以及每个 `PROJECT_TTL` 刷新,或 `off` 从来没有。 这个项目已经没有改变。 这个项目仍然是真相的来源,所以使用 `off` 通过阶段部署管理表格。 默认"启动" | 启动 |
| 蒙古国 | 没有 | 添加到 DB 连接字符串的其他配置 | {} |

慢慢来

-   表格.io团队

## 常见问题

### @formio/appserver 是什么？

高性能和可扩展的Form\.io多用途部署应用程序服务器\.

### 如何安装 @formio/appserver？

在项目目录运行 npm install @formio/appserver，或使用 pnpm add / yarn add / bun add。

### @formio/appserver 支持 TypeScript 吗？

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

### @formio/appserver 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @formio/appserver 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @formio/appserver 可以商用吗？

@formio/appserver 使用 OSL-3\.0 许可。声明的许可为 OSL-3\.0，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @formio/appserver 的下载量有多少？

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

### @formio/appserver 还在维护吗？

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