System Requirements

系统要求

服务器最低配置

规格	最低	推荐（生产）
CPU	2 核	4 核+
内存	2 GB	8 GB+
磁盘	20 GB SSD	100 GB+ SSD
网络	5 Mbps	100 Mbps+
操作系统	Ubuntu 22.04+ / Debian 12+ / CentOS Stream 9+	Ubuntu 24.04 LTS

以上为单节点参考值。并发用户超过 1000 时建议使用集群方案，见 Kubernetes 部署。

---

软件依赖

运行时（必须）

软件	最低版本	说明
Docker	20.10+	容器运行时
Docker Compose	v2.20+	服务编排

数据库

软件	版本	说明
PostgreSQL	18+	主数据库（含 pgcrypto、TimescaleDB、pg_jieba 扩展）

使用 Docker Compose 时数据库镜像已内置所有扩展，无需手动安装。

对象存储

选项	说明
Garage（推荐）	自托管 S3 兼容存储，Compose 已集成
AWS S3	商业云存储，生产可选
MinIO	其他 S3 兼容存储

---

网络端口

端口	协议	服务	说明
80	TCP	Caddy	HTTP（自动跳转 HTTPS）
443	TCP	Caddy	HTTPS + WebSocket
8080	TCP	imboy	后端内部端口（不对外暴露）
5432	TCP	PostgreSQL	数据库内部端口
3900	TCP	Garage	S3 API 内部端口
9090	TCP	Prometheus	指标（可选对外）
3000	TCP	Grafana	监控面板（可选对外）

防火墙仅需开放 80 和 443。其他端口通过 Docker 内网通信。

---

开发环境要求

工具	版本	用途
Erlang/OTP	28+	后端开发
rebar3	3.22+	Erlang 构建工具
Flutter	3.8+	移动端开发
Dart	3.x	Flutter 语言运行时
Node.js	20+	前端构建
Bun	1.x	管理后台包管理器
Git	2.40+	版本控制

---

客户端要求

移动端

平台	最低系统版本
iOS	iOS 15.0+
Android	Android 7.0（API 24）+

Web 管理后台

支持以下浏览器的最新两个大版本：

• Chrome / Edge（Chromium）
• Firefox
• Safari

---

域名 & SSL

• 必须有一个已解析到服务器的域名（E2EE 策略与 License 均绑定域名）
• Caddy 反向代理会自动申请并续期 Let's Encrypt 证书
• 如需自定义证书，请在 deploy/Caddyfile 中配置