GoWind CMS 产品介绍

GoWind CMS（全称 GoWind Content Hub，简称 GoWind HCH）是一款开箱即用的企业级 Golang 全栈 Headless 内容平台。为企业提供灵活、可扩展的全域内容管理与分发解决方案，支持多端内容输出（Web、小程序、App），原生多语言，多租户架构。

一、核心特性

1. Headless 架构 — 内容与展示分离

• API 优先：完整的 RESTful API，OpenAPI 文档自动生成，前后端完全解耦
• 双服务接口：管理后台 API（/admin/v1/）和前台应用 API（/app/v1/）独立部署
• 多端适配：前台支持 Vue（Nuxt.js）、React（Next.js）、Taro（小程序/H5）、Flutter 四套前端
• 灵活输出：内容可通过任意终端消费，适配 Web、App、小程序等场景

2. 组织与权限

• 多租户管理：租户新增、启用/禁用、套餐配置与数据隔离；新增租户自动初始化部门、角色与管理员
• 用户管理：用户全生命周期管理，支持多角色、多部门绑定，一键代登录，高级条件查询
• 角色管理：角色与角色分组管理，精细化配置菜单权限、接口权限与数据权限
• 权限管理：权限分组、菜单节点与权限点管理，支持按钮级细粒度控制
• 菜单管理：可视化菜单配置，支持目录、页面、按钮三级，按权限动态渲染
• 部门管理：多级部门树形管理，联动绑定用户，划分组织层级

3. 内容与站点

• 内容管理：帖子（Post）增删改查、发布/下架、置顶、排序、回收站与批量操作
• 分类管理：多级分类树形管理，前台按分类快速筛选
• 标签管理：标签增删改查与内容关联，支持按标签检索
• 评论管理：评论审核、删除、回复、屏蔽，可按内容、用户、时间筛选
• 页面管理：自定义页面（Page）创建与发布
• 多语言管理：语种管理、内容/菜单/提示统一翻译，原生国际化支持
• 站点管理：多站点独立配置，独立域名、标题、Logo、SEO 与展示风格
• 站点配置：基础信息、SEO、上传限制、缓存策略等全局参数配置
• 导航管理：站点导航栏与导航项管理，支持多级导航

4. 媒体资源

• 媒体资产管理：图片/文档/视频统一管理
• 文件存储：支持本地存储或 MinIO（兼容 S3 协议）对象存储
• 文件上传下载：完整的文件传输服务，支持大文件处理

5. 系统与运维

二、应用场景

新闻媒体

快速发布新闻、评论、专题等内容，支持多编辑协作和审核流程。

博客平台

个人或企业博客，支持内容分类、标签、存档等功能。

内容门户

大型内容聚合平台，支持多频道、多分类、多站点管理。

企业官网

企业宣传网站，支持多语言、SEO 优化、自定义页面。

知识库

企业内部或对外的知识库、文档管理平台。

三、技术架构

技术栈

后端

管理后台前端

前台展示前端

系统架构

GoWind CMS 采用 三服务微服务架构，管理后台与前台应用独立部署，共享核心业务逻辑：

三服务职责划分

Admin Service 和 App Service 作为 API 网关层，接收 HTTP 请求后通过 gRPC 调用 Core Service 完成业务处理，实现了接口与业务逻辑的解耦。

四、项目结构

go-wind-cms/
├── backend/                        # 后端服务
│   ├── api/                        # Protobuf API 定义 & 生成代码
│   │   ├── protos/                 # .proto 源文件
│   │   │   ├── admin/service/v1/   # 管理后台 API 定义（41 个 proto 文件）
│   │   │   ├── app/service/v1/     # 前台应用 API 定义（11 个 proto 文件）
│   │   │   ├── content/service/v1/ # 内容领域消息（Post/Category/Tag/Page）
│   │   │   ├── site/service/v1/    # 站点领域消息（Site/Navigation...）
│   │   │   ├── identity/           # 身份管理（User/Role/OrgUnit/Tenant...）
│   │   │   ├── permission/         # 权限管理（Permission/Menu...）
│   │   │   └── ...                 # 其他领域
│   │   └── gen/                    # 生成代码（Go / TypeScript / Dart / OpenAPI）
│   ├── app/
│   │   ├── admin/service/          # 管理后台服务（HTTP/gRPC）
│   │   ├── app/service/            # 前台应用服务（HTTP/gRPC）
│   │   └── core/service/           # 核心业务服务（业务逻辑 + 数据层）
│   ├── pkg/                        # 公共包（鉴权/加密/事件总线/JWT/中间件/OSS...）
│   └── scripts/                    # 部署脚本（Docker/PM2/环境安装）
├── frontend/
│   ├── admin/                      # 管理后台前端（Vue3 + Ant Design Vue + Vben Admin）
│   └── app/                        # 前台应用
│       ├── react/                  # React 前台（Next.js）
│       ├── vue/                    # Vue 前台（Nuxt.js）
│       ├── taro/                   # Taro 前台（微信小程序/H5）
│       └── flutter_app/            # Flutter 前台（跨平台原生）
└── docs/                           # 文档 & 截图

五、Protobuf API 组织

GoWind CMS 采用 Protobuf First 的 API 开发模式，所有接口通过 Protobuf 定义，借助 Buf 工具链自动生成 Go 服务端代码、TypeScript/Dart 客户端代码和 OpenAPI 文档。

API 路由前缀

管理后台 API（Admin Service）

Admin Service 提供 40+ 个 Service，覆盖完整的后台管理功能：

组织与权限：

内容与站点：

系统管理：

前台应用 API（App Service）

App Service 提供精简的面向终端用户（C 端）的接口：

代码生成

cd backend

# 生成 Protobuf Go 代码
make api

# 生成 OpenAPI v3 文档
make openapi

# 生成 TypeScript 代码（管理后台 + React/Taro/Vue 前台）
make ts

# 一键生成全部代码（ent + wire + api + openapi）
make gen

六、演示地址

所有演示站点通用账号：admin / admin

七、快速开始

环境要求

• Go 1.25+
• Docker & Docker Compose
• Node.js 18+ & pnpm
• buf（Protobuf 工具链）

1. 启动依赖服务

cd backend

# Windows
.\scripts\docker\libs_only.ps1

# Linux / macOS
./scripts/docker/libs_only.sh

这将启动 PostgreSQL、Redis、MinIO、OpenSearch、Etcd、Jaeger 等依赖服务。

2. 启动后端服务

# 推荐方式：使用 gow CLI
gow run admin

# 或在 IDE 中直接调试运行

3. 启动前端

# 管理后台
cd frontend/admin
pnpm install
pnpm dev

# React 前台
cd frontend/app/react
pnpm install
pnpm dev

详细的安装和部署说明请参考 CMS 安装指南。

八、与 GoWind Admin 的关系

GoWind CMS 与 GoWind Admin 共享相同的技术基座（go-kratos + Ent + Wire + Protobuf + Vben Admin），在组织管理、权限体系、系统管理等方面保持一致。主要差异在于：

九、相关文档

基础文档

• CMS 安装指南
• CMS 后端架构总览
• CMS Protobuf API 定义
• CMS 配置与部署指南
• CMS 后端模块总览
• CMS 后端扩展机制
• CMS 前端架构
• CMS 前端模块总览
• GoWind Admin 文档 — 共享技术基座的详细说明

循序渐进教程