> ## 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 團隊會提供對應的技術對接方案與報價。
