---
title: 在您的基础设施中运行 Human Plugin
description: 运行 Human Plugin 需要什么：一个容器和您的 PostgreSQL 数据库，以及部署的顺序。
canonical: https://developer.unico.io/zh-CN/human-plugin/self-hosting/overview
locale: zh-CN
generated_by: markdown-export
---

# 在您的基础设施中运行 Human Plugin

在您的网络中部署一个容器和一个 PostgreSQL 数据库，即可连接到 Unico。

```mermaid
flowchart LR
  A[Your back-end] --> B[Human Plugin container]
  B --> C[(Your PostgreSQL, dedicated)]
```

## 要求

| 要求 | 详情 |
| --- | --- |
| 容器运行时 | Docker、Docker Compose 或 Kubernetes。镜像为 `linux/amd64` 和 `linux/arm64` 构建，并以非 root 用户运行 |
| PostgreSQL | 16 或更高版本。仅供 Human Plugin 使用的数据库，可通过用户名和密码访问。默认要求 SSL |
| 出站 HTTPS | 访问 Unico。参见[网络与安全](/zh-CN/human-plugin/self-hosting/networking-and-security) |
| 入站 | 端口 `8080`，纯 HTTP，仅来自您的后端 |
| 密钥 | 您的访问密钥和数据库密码 |

<a id="hardware-requirements"></a>

## 硬件要求

以下是运行 Human Plugin 的最低配置，支持最高 **每分钟 1,500 笔事务**，自拍照最大 800 KB。

### Human Plugin

| 资源 | 最低配置 |
| --- | --- |
| CPU | 每个副本 1 vCPU |
| 内存 | 每个副本 1 GB |

如需更高的处理量，每 1,500 笔事务/分钟增加一个副本。我们还建议运行多个副本，以便在其中一个重启时 Human Plugin 仍保持可用。

### PostgreSQL

| 资源 | 最低配置 |
| --- | --- |
| 版本 | 16 |
| CPU | 2 vCPU |
| 内存 | 4 GB |
| 磁盘 | SSD |

估算磁盘空间时，按每个流程约 1.7 KB × 每天的流程数 × 保留天数，再加 30%。

### 网络

出站 HTTPS（端口 443）访问 Unico。参见[网络与安全](/zh-CN/human-plugin/self-hosting/networking-and-security)。

## 镜像

Human Plugin 发布为 `pkg.unico.run/human-plugin-api:latest`。请始终运行 `latest` 标签，即当前版本。使用 Unico 提供的镜像仓库凭据（用户名和令牌）拉取。参见[前提条件与访问权限](/zh-CN/human-plugin/get-started/prerequisites)。

## 部署顺序

1. 创建专用数据库以及供 Human Plugin 使用的角色。
2. 设置[配置](/zh-CN/human-plugin/self-hosting/configuration)，密钥来自您的密钥存储。
3. 使用 [Docker Compose](/zh-CN/human-plugin/self-hosting/docker-compose) 或 [Kubernetes](/zh-CN/human-plugin/self-hosting/kubernetes) 启动容器，停止超时至少 60 秒。
4. 等待 `GET /health/ready` 返回 `200` 后再路由流量。参见[健康检查与监控](/zh-CN/human-plugin/self-hosting/health-and-monitoring)。
5. 将访问限制为仅您的后端可用。参见[网络与安全](/zh-CN/human-plugin/self-hosting/networking-and-security)。
6. 对其运行[快速入门](/zh-CN/human-plugin/get-started/quickstart#3-create-a-process)中的创建请求。

## 启动时会发生什么

Human Plugin 会下载[属性目录](/zh-CN/human-plugin/additional-resources/attribute-catalog)，连接到 PostgreSQL 并准备其表，然后打开端口。在以下情况下，它会在开始监听之前报错并停止：

- 缺少必需的设置，或设置无效；
- 无法下载属性目录；
- 无法连接到 PostgreSQL，或该角色无法创建表。

日志中会说明原因。参见[故障排查](/zh-CN/human-plugin/additional-resources/troubleshooting)。

## 多个实例

Human Plugin 不在内存中保存请求状态，因此多个容器可以共享同一个数据库。同时启动的容器会通过数据库进行协调，因此您可以一次性滚动发布多个副本。

## 上线生产

- 将停止超时保持在 60 秒或以上。
- 仅在 `/health/ready` 返回 `200` 后才向容器路由流量。
- 切勿将 Human Plugin 暴露在您的私有网络之外。
- 备份数据库：其中保存着您的 intelligence 数据。参见[运维](/zh-CN/human-plugin/self-hosting/operations)。