登录 GridCMS
GridCMS
登录 GridCMS
DEPLOYMENT GUIDE · 交付与实施

私有化部署，
从交付到上线

面向企业 IT 与实施工程师的完整教程：环境准备、安装启动、域名接入、授权激活、网关上线，全流程约 1~2 小时。SaaS、私有化、社区版同一套源码，操作路径完全一致。

咨询私有化方案 开源版自行部署
总览 / OVERVIEW

四步，完成一次私有化交付

STEP 01

环境准备

一台 2C4G 起步的服务器，装好 Docker 即可，离线内网同样适用。

STEP 02

安装启动

一条 compose 命令拉起全栈，创建管理员账号。

STEP 03

域名与授权

绑定域名与 HTTPS，输入 License 授权码激活。

STEP 04

网关接入

GridBox 指向私有实例，数据贯通，全员开始使用。

STEP 01 / PREPARE

准备一台服务器

云主机、本地虚拟化或工控机均可；数据量按 Feed 数量逐年增长，磁盘请预留余量。

项目最低配置推荐配置
CPU / 内存2 核 · 4 GB4 核 · 8 GB
磁盘40 GB SSD100 GB+ SSD（按 Feed 规模扩展）
操作系统Ubuntu 20.04+ / Debian 11+ / CentOS 7+（或国产同等发行版）
运行环境Docker 20.10+ · Docker Compose v2
开放端口80 / 443（Web 与 API）· 8883（MQTT over TLS，网关接入）
离线内网 / 完全离线环境同样支持：交付物包含离线镜像包，安装全程无需访问公网，网关只需能访问服务器对应端口。
STEP 02 / DELIVERY

获取交付物

签约后 1 个工作日内，您将收到完成部署所需的全部材料。

01

签署合同

源码交付授权、实施范围与 SLA 条款随合同一并生效。

02

接收交付邮件

包含私有 Git 仓库权限（或离线镜像包 gridcms-offline.tar.gz）、License 授权码与部署清单。

03

指定实施对接人

专属客户经理与实施工程师组建交付群，全程陪同部署直至上线。

提示等待交付的间隙，可先完成第 01 步的服务器与环境准备。
STEP 03 / INSTALL

安装与启动

在线环境走私有仓库，离线环境用镜像包，二选一。

bash — install
# 方式 A：在线环境（已获得私有仓库权限） $ git clone https://git.gridcms.cn/enterprise/gridcms.git $ cd gridcms && docker compose up -d # 方式 B：离线环境（内网 / 无外网） $ tar -xzf gridcms-offline.tar.gz && cd gridcms $ docker load -i images/gridcms.tar $ docker compose up -d # 初始化管理员账号（按提示输入邮箱与密码） $ docker compose exec app ./manage.sh create-admin # 查看运行状态 $ docker compose ps gridcms-app running 0.0.0.0:8080->8080 gridcms-db running 3306 gridcms-mqtt running 0.0.0.0:8883->8883
验证启动后即可通过 http://服务器IP 访问平台，使用刚创建的管理员账号登录。
STEP 04 / DOMAIN & TLS

绑定域名与 HTTPS

为实例绑定一个域名（如 gridcms.your-company.com），Nginx 反向代理 + TLS 证书。

nginx — reverse proxy
# /etc/nginx/conf.d/gridcms.conf server { listen 443 ssl; server_name gridcms.your-company.com; ssl_certificate /etc/nginx/certs/gridcms.pem; ssl_certificate_key /etc/nginx/certs/gridcms.key; location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; } } # 公网环境可申请免费证书，自动写入配置 $ certbot --nginx -d gridcms.your-company.com
复用MQTT 8883 端口复用同一域名证书；GridBox 网关的上云地址直接填该域名即可。
STEP 05 / LICENSE

激活授权

1

管理员登录

使用第 03 步创建的管理员账号登录私有实例控制台。

2

输入授权码

进入「系统设置 → 授权管理」，粘贴交付邮件中的 License 授权码。

3

激活完成

授权码与部署域名绑定，即时生效；更换域名请联系客户经理重新签发。

试用未激活授权前，平台以 30 天全功能试用模式运行，不影响部署联调。
AFTER LAUNCH / LOGIN ENTRY

上线后，用户从哪里登录

01

官网统一入口（推荐对外公布）

打开官网登录页，切到「私有化部署」页签，输入实例地址，校验通过后点击链接即在新窗口打开 https://您的域名/login；浏览器会记住上次输入的地址。

02

直接收藏实例地址

把 https://gridcms.your-company.com/login 加入浏览器书签或挂到企业内网门户。

03

纯内网环境

直接使用 http://服务器IP 访问，无需经过官网。

运维 / OPERATIONS

上线之后的三个运维要点

数据备份

备份数据卷：tar -czf backup-$(date +%F).tar.gz ./data。建议每日快照 + 异地副本，Feed 时序数据占绝大部分空间。

版本升级

升级通告随交付群推送：docker compose pull && docker compose up -d，分钟级完成，升级前自动备份；离线环境提供离线升级介质。

数据主权

全部数据存储于您自有服务器，我们不留存任何业务数据；支持随时完整导出，迁出无锁定。

DEDICATED SUPPORT

私有化部署，
有人陪跑

签约即配专属客户经理与实施工程师，从第一台服务器到全量上线，全程负责。

咨询私有化方案 查看三种形态对比