> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 私有化部署

> superun 企业私有化部署的方案概览与对接方式。

## 概述

如果你需要将 superun 云服务运行在自有内网环境、确保业务数据不经公网链路，可以选择私有化 / 自建部署。superun 提供两条路径。

## 路径一：自助本地化部署（无技术支持）

1. 在**研发阶段**通过项目导出功能下载前端代码
2. 将代码部署到自有服务器或第三方托管平台（如 Netlify、Vercel）运行
3. 后端数据、登录、云函数等依赖 superun 云计算的能力，需你自行替换实现

此路径下的代码维护、安全加固、升级与故障排查均由你自行负责，superun 团队不提供自建环境的部署类技术支持。

## 路径二：superun 企业私有化部署（付费服务）

由 superun 在客户内网环境中部署，应用的生成与运行都在内网完成，业务数据不经公网链路。

### 会部署些什么

简单说，就是把 superun 云服务「搬」到你自己的机房 / 云账号里，主要包括：

* **superun 云服务**：给你的业务应用提供接口、登录认证、数据读写等能力
* **数据库**：存放业务数据和运行所需信息
* **内网访问入口**：让你的应用在内网就能访问 superun 云服务
* **管理通道**：superun 团队在你授权的范围内做部署、升级、检查和故障处理

你的业务应用只需要连接 superun 云服务的地址即可，不用关心它内部是怎么跑的。

### 两种部署方式怎么选

根据你现有的基础设施，superun 会选其中一种：

**方式一 · 用你现成的容器平台（推荐，适合正式生产）**

如果你已经有一套 Kubernetes 集群（比如阿里云 ACK、腾讯云 TKE），superun 云服务和数据库都装在里面。

* 优点：隔离清晰、长期稳定、扩展性好；**在资源充足时可以按需创建多个项目**
* 需要你：准备并维护这套集群，提供存储和备份能力

**方式二 · 只提供服务器 + 数据库（适合试点、轻量部署）**

如果你没有现成的集群，只提供几台服务器和一个数据库（PostgreSQL/RDS），superun 云服务跑在服务器上，数据存到你的数据库里。

* 优点：准备成本低、上手快
* 需要你：提供服务器、数据库和内网网络
* **重要限制**：这种方式**不能像方式一那样随时新建项目**——每新增一个项目，都要先单独准备一个对应的数据库。正式上线前需要先做一轮验证测试（POC）。

### 简单对比

|        | 方式一 · 完整集群       | 方式二 · 服务器 + 数据库 |
| ------ | ---------------- | --------------- |
| 推荐程度   | 推荐作为正式生产         | 适合试点 / 轻量，需先验证  |
| 你的准备成本 | 较高               | 较低              |
| 新建项目   | 资源够就能按需创建        | 每个项目要单独准备数据库    |
| 后续扩展   | 好                | 有限制             |
| 适合谁    | 长期生产、对隔离和运维有明确要求 | 先小范围试用、暂时没有集群   |

### 基本网络前提（两种方式都要满足）

* 你的业务应用能在**内网**访问 superun 云服务
* 数据库原则上**不开放公网**
* 运行环境能访问 superun 指定的镜像仓库
* DNS、证书、负载均衡、防火墙等由客户侧负责配置

> 具体的服务器规格、存储和网络细节，会在对接阶段由 superun 技术团队根据你的环境提供，你不需要提前搞懂所有技术参数。

### 无法访问公网的内网环境

如果政府、国企或其他内网环境完全无法访问公网，通常需要采用源码交付和手动部署方式：

1. 在可访问 superun 的环境中导出项目源码。
2. 准备源码运行所需的依赖和部署文件。
3. 按客户的安全流程将文件带入内网。
4. 在客户提供的服务器和数据库中完成部署。
5. 项目更新后，重新导出源码并手动更新内网版本。

部署前需要确认：

* 内网是否允许访问外部 API，以及 AI、短信、地图等第三方能力能否使用
* 数据库、文件存储、日志和备份由谁维护
* 内网域名、证书和访问权限如何配置
* 是否有数据不出域、审计、等保或信创要求

<Warning>完全离线的环境无法直接使用依赖公网的自动部署和第三方服务。具体可用能力、交付方式和合规要求，需要由客户技术团队与 superun 团队在部署前共同评估。</Warning>

## 费用

企业私有化部署涉及**一次性实施费用**与**常规使用费用**。整体上，方式二初期投入更低，但项目变多后数据库相关成本会上升；方式一初期准备成本较高，长期扩展更从容。

**具体费用与报价请联系 superun**（企业微信客服或商务），我们会根据你的环境和部署方式给出对应方案。

## 如何开始

添加企业微信客服或联系商务，说明你的内网环境与部署需求，superun 团队会提供对应的技术对接方案与报价。