# 应用

> 基于 Pigsty 的应用模板与数据应用说明：使用 Docker Compose 拉起无状态应用，并将状态托管到外部 PostgreSQL / S3 兼容存储。

---

LLMS 索引： [llms.txt](/llms.txt)

---

Pigsty 的“应用”分为两类：

- **软件模板（Software Templates）**：`~/pigsty/app/<name>` 下的 Docker Compose 模板，用于拉起无状态业务组件。
- **数据应用（Applets）**：基于 PostgreSQL + Grafana 的分析样例，偏教学/演示属性。

## 应用模型

推荐使用以下流程部署应用：

```bash
curl -fsSL https://repo.pigsty.cc/get | bash; cd ~/pigsty
./bootstrap
./configure -c <template>     # 例如 app/dify、app/immich、app/jumpserver、app/maybe、supabase
vi pigsty.yml                 # 修改密码、域名、IP、密钥
./deploy.yml                  # 部署基础设施与数据库
./docker.yml                  # 安装 Docker
./app.yml                     # 拉起应用
```

`app.yml` 会将 `app/<name>` 模板复制到 `/opt/<name>`，并按 `apps.<name>.conf` 覆盖 `.env`，最后执行 `docker compose up -d`。

## 维护中的配置模板

当前源码中提供了以下应用配置模板（`conf/app/*.yml`、`conf/supabase.yml` 与 `conf/app/supa.yml` 软链接）：

- `app/dify`
- `app/odoo`
- `app/teable`
- `app/mattermost`
- `app/electric`
- `app/maybe`
- `app/immich`
- `app/jumpserver`
- `app/registry`
- `app/insforge`
- `app/hindsight`
- `supabase`

这些模板开箱即用，且与 `./configure -c ...`、`./app.yml` 工作流保持一致。

## 轻量 Compose 应用

对于 `bytebase`、`gitea`、`jupyter`、`kong`、`metabase`、`minio`、`nocodb`、`pgadmin`、`pgweb`、`postgrest`、`pg_exporter`、`wiki` 等应用，也可直接使用对应目录下的 Compose 模板。
[FerretDB](/docs/app/ferretdb/) 是 [PostgreSQL Mongo 模式](/docs/conf/mongo/) 的 Docker APP 协议层，通过 `mongo` 配置模板配合 `docker.yml` 与 `app.yml` 部署。

```bash
cd ~/pigsty/app/<name>
make up
```

如果你希望统一纳入 Pigsty IaC，可用 `app.yml` 指定应用目录：

```bash
./app.yml -e app=<name>
```

## 关于历史 Applet

`pglog`、`covid`、`db-engine`、`sf-survey`、`cloud`、`isd` 等数据应用保留为参考示例，适合学习数据建模与可视化思路。

它们不再是主线“应用交付”方式；请优先使用上面的软件模板工作流。

---

本节页面：

- [Supabase 企业级自建](/docs/app/supabase/): 使用 Pigsty 自托管企业级 supabase，带有监控、高可用、PITR、IaC 以及 575 个 PG 扩展。
- [Odoo：自建开源 ERP](/docs/app/odoo/): 如何拉起开箱即用的企业级应用全家桶 Odoo，并使用 Pigsty 管理其后端 PostgreSQL 数据库。
- [Dify：AI 工作流平台](/docs/app/dify/): 如何使用 Pigsty 自建 AI Workflow LLMOps 平台 —— Dify，并使用外部 PostgreSQL，PGVector，Redis 作为存储？
- [InsForge：AI 后端即服务](/docs/app/insforge/): 使用 Pigsty 自建 InsForge OSS，并将 PostgreSQL 数据库、备份、监控与入口交给 Pigsty 管理。
- [Hindsight：AI 长期记忆](/docs/app/hindsight/): 使用 Pigsty 自建 Hindsight，并使用外部 PostgreSQL 存储长期记忆。
- [FerretDB：MongoDB 协议](/docs/app/ferretdb/): 在 Pigsty 托管的 PostgreSQL 与 DocumentDB 之上部署无状态 FerretDB 代理。
- [业务软件](/docs/app/_div_enterprise/)
- [NocoDB：开源 Airtable](/docs/app/nocodb/): 使用 NocoDB 将 PostgreSQL 数据库转变为智能电子表格，无代码数据库应用平台。
- [Teable：AI 无代码数据库](/docs/app/teable/): 使用 Pigsty 自建 Teable，并接入外部 PostgreSQL 与 Silo。
- [Gitea：自建简易代码托管平台](/docs/app/gitea/): 使用 Pigsty 的 Compose 模板部署 Gitea，并接入外部 PostgreSQL。
- [Wiki.js：维基百科站](/docs/app/wiki/): 如何使用 Wiki.js 搭建你自己的开源维基百科，并使用 Pigsty 管理的 PG 作为持久数据存储
- [Mattermost：开源团队协作](/docs/app/mattermost/): 使用 Pigsty 部署 Mattermost，并将状态托管到外部 PostgreSQL。
- [Maybe：自建个人财务](/docs/app/maybe/): 使用 Pigsty 自建 Maybe 个人财务管理应用，并将 PostgreSQL 数据库、备份、监控与入口交给 Pigsty 管理。
- [Immich：自建照片视频库](/docs/app/immich/): 使用 Pigsty 自建 Google Photos 开源替代 Immich，并将元数据、向量检索、备份与入口交给 Pigsty 管理。
- [Metabase：BI 分析工具](/docs/app/metabase/): 使用 Metabase 进行快速的商业智能分析，友好的用户界面让团队自主探索数据。
- [Kong：API 网关](/docs/app/kong/): 使用 Pigsty Compose 模板部署 Kong（PostgreSQL 后端）。
- [Registry：容器镜像缓存](/docs/app/registry/): 使用 Pigsty 部署 Docker Registry Pull-Through Cache 与可选 Web UI。
- [JumpServer：开源堡垒机](/docs/app/jumpserver/): 使用 Pigsty 自建 JumpServer 社区版，并将 PostgreSQL 后端数据库、备份、入口与运维纳入 Pigsty 管理。
- [数据库工具](/docs/app/_div_tools/)
- [ByteBase：模式迁移](/docs/app/bytebase/): 使用 Pigsty 提供的 Docker Compose 模板部署 Bytebase，并接入外部 PostgreSQL。
- [pgAdmin：PostgreSQL 图形管理工具](/docs/app/pgadmin/): 使用 Pigsty 的 Docker Compose 应用模板部署 pgAdmin4，并安全加载 PostgreSQL 服务器清单。
- [PGWeb：网页客户端](/docs/app/pgweb/): 使用 Docker 拉起 PGWEB，以便从浏览器进行小批量在线数据查询
- [PostgREST：自动 API](/docs/app/postgrest/): 使用 Pigsty Compose 模板部署 PostgREST，基于 PostgreSQL 模式自动生成 REST API。
- [Electric：PostgreSQL 同步引擎](/docs/app/electric/): 使用 Pigsty 自建 Electric，同步 PostgreSQL 数据到前端应用，支持部分复制与实时分发。
- [Jupyter：Notebook 与数据分析环境](/docs/app/jupyter/): 使用 Pigsty 的独立 Docker Compose 模板运行 JupyterLab，并安全访问 PostgreSQL。
- [数据应用](/docs/app/_div_applet/)
- [PGLOG：PG自带日志分析应用](/docs/app/pglog/): Pigsty 自带的，用于分析 PostgreSQL CSV 日志样本的一个样例 Applet
- [NOAA ISD 全球气象站历史数据查询](/docs/app/isd/): 以 ISD 数据集为例，展现如何将数据导入数据库中
- [COVID-19 数据大盘](/docs/app/covid/): Pigsty 自带的，用于展示世界卫生组织官方 COVID 疫情数据的一个样例 Applet
- [StackOverflow 调研](/docs/app/sf-survey/): 分析 StackOverflow 最近七年全球开发者调研数据中关于数据库的部分
- [DB-Engine 热度分析](/docs/app/db-engine/): 分析 DB-Engine 上的数据库管理系统，查阅其流行度变迁。
- [云上算力价格计算器](/docs/app/cloud/): 分析阿里云 / AWS 上算力与存储的价格 (ECS/ESSD)