自建部署

自建部署 Rocketadmin

使用 Docker、Kubernetes 或 Terraform 部署在您自己的基礎設施上。完全掌控資料與完整隱私。

在 GitHub 上查看技術文件

原始碼可用

BUSL 授權。非競爭用途免費使用，可查看和修改程式碼。

自建部署安全性

您的資料永不離開您的基礎設施。完全掌控一切。

定期更新

積極開發中，頻繁發布版本和安全修補。

社群支援

在 GitHub Discussions 上獲得社群協助。

安裝

選擇您的部署方式

選擇最適合您基礎設施和團隊專業知識的安裝方式。

Docker

最快的入門方式。以最少設定在單一容器中執行 Rocketadmin。

Kubernetes

使用 Helm Chart 部署到 Kubernetes 叢集，適合生產環境。

Terraform

使用 helm_release 資源進行基礎設施即程式碼部署。

Docker

使用 Docker 快速開始

執行 Rocketadmin 最快的方式。拉取官方映像檔，幾分鐘內即可開始管理資料庫。

環境變數

DATABASE_URL PostgreSQL connection string for Rocketadmin metadata Required

JWT_SECRET Secret key for JWT token signing (min 32 characters) Required

APP_DOMAIN_ADDRESS Your domain URL (e.g., https://admin.yourcompany.com)

PRIVATE_KEY RSA private key for encryption

完整 Docker 指南

Docker Run

# Pull the latest image
docker pull rocketadmin/rocketadmin:latest

# Run with environment variables
docker run -d \
  --name rocketadmin \
  -p 3000:3000 \
  -e DATABASE_URL="postgres://..." \
  -e JWT_SECRET="your-secret-key" \
  rocketadmin/rocketadmin:latest

docker-compose.yml

version: '3.8'
services:
  rocketadmin:
    image: rocketadmin/rocketadmin:latest
    ports:
      - "3000:3000"
    environment:
      DATABASE_URL: postgres://user:pass@db:5432/rocketadmin
      JWT_SECRET: your-secret-key-min-32-chars
    depends_on:
      - db

  db:
    image: postgres:15
    environment:
      POSTGRES_DB: rocketadmin
      POSTGRES_USER: user
      POSTGRES_PASSWORD: pass
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

Helm 安裝

# Add the Rocketadmin Helm repository
helm repo add rocketadmin https://charts.rocketadmin.com
helm repo update

# Install Rocketadmin (uses PGlite by default)
helm install rocketadmin rocketadmin/rocketadmin \
  --namespace rocketadmin \
  --create-namespace

values.yaml

# Default configuration uses PGlite - no external DB needed!
replicaCount: 1

image:
  repository: rocketadmin/rocketadmin
  tag: latest

service:
  type: ClusterIP
  port: 80

ingress:
  enabled: true
  hosts:
    - host: admin.yourcompany.com
      paths:
        - path: /
          pathType: Prefix

# Optional: use external PostgreSQL instead of PGlite
# env:
#   DATABASE_URL: "postgres://user:pass@host:5432/db"

Kubernetes

使用 Helm 進行生產部署

使用 Helm 將 Rocketadmin 部署到任何 Kubernetes 叢集。支援水平擴展、Ingress 設定和持久化儲存。

Helm Chart 功能

預設使用 PGlite — 無需外部資料庫
透過 DATABASE_URL 使用外部 PostgreSQL
Ingress 支援 TLS 憑證
可設定資源限制和請求

在 Artifact Hub 上查看

Terraform

基礎設施即程式碼

使用 Terraform 的 helm_release 資源部署 Rocketadmin。以基礎設施即程式碼的方式管理 Kubernetes 部署。

優勢

版本控制的基礎設施
跨環境可重現的部署
狀態管理與漂移偵測
與現有 Terraform 工作流程整合

Helm Provider 文件

main.tf

terraform {
  required_providers {
    helm = {
      source  = "hashicorp/helm"
      version = "~> 2.0"
    }
  }
}

provider "helm" {
  kubernetes {
    config_path = "~/.kube/config"
  }
}

# Uses PGlite by default - no external DB required
resource "helm_release" "rocketadmin" {
  name       = "rocketadmin"
  repository = "https://charts.rocketadmin.com"
  chart      = "rocketadmin"
  namespace  = "rocketadmin"

  create_namespace = true

  set {
    name  = "ingress.enabled"
    value = "true"
  }

  set {
    name  = "ingress.hosts[0].host"
    value = "admin.yourcompany.com"
  }
}

部署指令

# Initialize Terraform
terraform init

# Preview changes
terraform plan

# Apply infrastructure
terraform apply

常見問題

什麼是 BUSL 授權？

Business Source License（BUSL）允許您自由查看、修改和使用程式碼，但不得與 Rocketadmin 競爭。4 年後，程式碼將轉換為寬鬆的開放原始碼授權。

我可以在公司內部使用自建版本嗎？

可以。您可以在內部使用 Rocketadmin 管理資料庫。授權僅限制將 Rocketadmin 作為競爭性託管服務提供。

雲端版和自建版有什麼區別？

兩個版本功能相同。雲端版由我們管理並自動更新。自建版在您的基礎設施上執行，讓您完全掌控資料和部署。

自建版是免費的嗎？

是的，自建版在非競爭用途下免費使用。您可以在自己的伺服器上部署，無需任何授權費用。

什麼是 PGlite？

PGlite 是嵌入式 PostgreSQL，在 Rocketadmin 容器內執行。它在本地儲存設定資料，因此您無需另外建立資料庫。

可以為專案做貢獻嗎？

可以。我們歡迎在 GitHub 上的貢獻。您可以提交錯誤回報、功能請求或 Pull Request。

需要幫助嗎？

查看文件、瀏覽 GitHub Issues，或加入社群討論。

技術文件討論區

準備好建立您的管理面板了嗎？

加入 1,000+ 個團隊。幾分鐘即可開始，而非數月。

開始免費試用預約展示

無需信用卡 · 永久免費方案