ZhyCMS:基于 Flask 技术栈的企业内容管理系统项目

轻量级开源企业 CMS,Apache 2.0 免费商用。插件化扩展、多主题切换、RBAC 权限、内容工作流、审计日志、SEO 伪静态、对象存储、Docker 一键部署。适合替代传统 PHP CMS,用 Python 技术栈搭建企业官网。

Branch3Tags22

ZhyCMS

一个基于 Flask 的轻量级企业内容管理系统,内置多主题模板引擎、栏目级模板选择、自定义字段、表单收集、SEO 优化、全文搜索、对象存储等能力,适合搭建企业官网、资讯门户、产品展示站等。

Version License Python Docker Tests GitHub Stars

当前版本:v3.2.3(角色体系站点化版:新增「站点管理员」预设角色,账号角色按站点分配并支持一人多站多角色;站点管理员仅能在授权站点内管理账号,角色配置保留为平台级功能;新增迁移 0015,无新增依赖,详见 CHANGELOG 与 UPGRADE)

项目官网:https://zhycms.tzzhy.cn/(在线演示与使用文档)

如果这个项目对你有帮助,欢迎点个 Star 支持一下;也欢迎在 Gitee / GitHub 提 Issue、发 PR 一起共建。


目录


简介

ZhyCMS 采用 Flask + SQLAlchemy + Jinja2 技术栈,以「插件优先、主题驱动」为架构理念,在保持轻量的同时覆盖企业建站的核心需求:

  • 前台:多主题切换、栏目级模板选择、伪静态、全文搜索、多语言
  • 后台:RBAC 权限、内容工作流、审计日志、备份恢复、表单收集
  • 扩展:插件零侵入扩展、REST API、对象存储、统计代码

界面预览

以下截图取自内置演示数据(制造业主题),完整功能可在 在线演示 体验。

前台

首页(轮播 + 产品展示)
前台首页

后台

仪表盘 文章管理(工作流状态与批量操作)
后台仪表盘 文章管理
文章编辑(富文本 / Markdown 双模式) 可视化页面构建器
文章编辑 页面构建器
插件管理(启用 / 禁用 / 上传安装) 主题管理(内置 8 套主题)
插件管理 主题管理

核心特性

特性 说明 版本
多主题模板系统 前台模板按主题组织,后台一键切换;内置 8 套主题(含 2 套英文主题) v1.0
主题管理 上传/启用/删除/打包下载主题压缩包,缺失模板自动兜底 v2.2
插件机制 plugins/<slug>/ 零侵入扩展,启停即时生效、无需重启 v2.2
国际化(i18n) Flask-Babel 界面文案 + 内容级多语言翻译表(文章/栏目/碎片/产品/表单/岗位/友情链接,v2.5.2 起含产品规格参数与岗位部门/地点/薪资) v2.3/v2.5
Redis 缓存 环境变量自动检测,RedisCache + 服务端 Session,支撑多实例负载均衡 v2.5
数据库迁移 Flask-Migrate(Alembic)管理 schema 版本,支持回滚 v2.4
全文搜索 默认 Tantivy(Rust 内核)+ pkuseg 中文分词,可选 Meilisearch;多语言检索、插件内容接入、SQL 兜底 v2.4
对象存储 OSS 阿里云 OSS / 腾讯云 COS / 七牛云 Kodo,一键迁移本地文件上云 v2.4
Docker 部署 官方镜像 pollybird/zhycms 已发布,MySQL/PostgreSQL 一键启动,支持本地构建 v2.4
REST API /api/v1/ 只读端点,Token 鉴权 + CORS,适合小程序/Headless v2.2
RBAC 权限 角色/权限点两级模型,菜单与按钮级授权,栏目级内容粒度 v2.0
内容工作流 草稿 → 待审核 → 已发布/已驳回,版本快照与对比还原 v2.0
审计日志 登录、配置变更、内容 CRUD 等全量留痕,支持多维度检索 v2.0
SEO 优化 伪静态、sitemap、robots.txt、页面缓存、图片默认 ALT v2.0
表单收集 可视化表单设计,提交后邮件/企业微信实时通知 v2.0
备份恢复 MySQL/PostgreSQL/JSON 三种方式,一键备份与恢复 v2.0
前台会员体系 社区插件 member:注册/登录/资料/改密/找回密码、微信/QQ 一键登录、短信验证码登录、注册协议、栏目会员可见性 v2.6.4
插件依赖治理 manifest.json 支持 requires/extends/min_core_version,启用强校验 + 禁用反向依赖校验 v2.6.4
可视化页面构建器 自研轻量拖拽构建器:24 个 Bootstrap4 组件、四页面类型(首页/单页/列表/文章详情)、草稿/发布/修订回滚、中英双语与会员可见性、iframe 内服务端真实渲染;插件可注册自有组件并贡献默认布局片段(启用即开箱即用) v3.0.0
站群模式(多站点) 一个后端实例 + 一个库按站点切分内容:独立域名 / 泛解析子域解析、后台站点 CRUD 与切换、站点级配置/主题/SEO、搜索与缓存按站隔离、会员共享或独立、插件站群 SDK;默认站点 0 单站点部署零感知 v3.2.0
数据库迁移插件 内置插件 db_migrator(默认不启用):后台一键把 SQLite 开发库迁移到 MySQL/PostgreSQL,建表+数据复制+序列重置,目标库非空保护,支持迁移后免重启热切换 v3.1.0

版本速览

v3.2.3(2026-11-17)

角色体系站点化。新增「站点管理员」预设角色:拥有指定站点的全部后台管理权限(站点设置、用户、审计、栏目、内容、页面构建、表单),不含站点增删改与备份运维等平台级功能;内容审核员/内容编辑/只读查看员同样绑定到具体站点。user_roles 新增 site_id 并改为 (user_id, role_id, site_id) 唯一(迁移 0015),支持一人多站多角色;账号表单为每个站点提供角色下拉。超级管理员可为任意站点分配角色,站点管理员只能在自己有权限的站点内添加/管理账号,角色配置页仅平台管理员可访问。存量 site_id IS NULL 的全局角色保持全站语义。无新增依赖。

v3.2.2(2026-11-17)

站群内容隔离补全。闭环潜在威胁报告 11 项:教程/页面构建/上传索引/第三方绑定新增 site_id 并改为站点级唯一(迁移 0014),前台、后台、模板函数与构建器组件全部按站过滤;跨站页面 404、去重与物理路径按站隔离、删站检查补齐、会员删除与 OAuth 绑定站点化、备份/监控收敛为平台级运维、缓存按 frontend/site{N}/* 失效、浏览量按站分键、插件 sql_search 支持 site_id、平台级后台入口豁免。无新增依赖。

v3.2.1(2026-11-16)

站群缺陷修复。闭环第三方测试报告的 P0/P1/P2 共 5 项:站点权限 ?site= 越权(解析层校验 + 后台统一守卫)、status=closed 未覆盖 API 与插件前台蓝本(提升为 app 级校验,API 返回 503 JSON、healthz 固定 200)、独立会员会话跨站有效(current_member() 校验站点)、站点 SEO 字段不生效(前台与 API 接入站点 SEO 回退链)、0012 降级半回滚(DDL 前预检跨站重复);另加固子域唯一约束、域名校验、删站内容检查、accessible_sites N+1、JWT 首启告警等边界项。新增迁移 0013,无新增依赖。

v3.2.0(2026-11-15)

站群版。新增站点注册表 sites 与 site_id 内容维度:请求按「后台切换 → 精确域名 → 子域标签 → 默认站点 0」解析站点,栏目/文章/碎片/配置/会员/内置插件内容全部按站隔离;后台新增站点管理(CRUD + 切换器)与站点级权限 site:manage / UserSitePermission;站点化配置、主题、sitemap、全站搜索与缓存命名空间;会员支持共享(默认,与现网一致)或独立;插件 SDK 提供 SiteScopedMixin / current_site_id() / site_filter()。默认站点 site_id=0 恒等变换,单站点部署 URL 与行为完全不变。数据库迁移 0012,无新增依赖。

v3.1.10(2026-11-09)

纵深防御与合规加固。闭环 GitCode Issue #14 残留 Low/Info 项与 SAST P3 共 9 项:主题模板静态审计新增下标内字符串拼接检测、加密密钥不可用时后台全页红色横幅 + error 日志高可见度告警(fail-open 语义不变)、CORS 新值拒 * 与非法来源格式(存量不清空仅 UI 告警)、后台管理员新密码统一 12 位四类字符(存量与会员端不受影响)、CI 工作流 10 处 Actions pin 完整 commit SHA、新增 dependabot 周更、TestingConfig 固定密钥误用于生产时启动直接拒绝;SSRF DNS TOCTOU 与 Markdown 内联 HTML 维持文档披露不新增代码。无数据库结构变更、无新增依赖。

v3.1.9(2026-11-08)

安全修复。完成 v3.1.8 顺延的 6 个 Medium 并闭环 GitCode Issue #14:插件 AST 审计支持 import 别名/赋值传播/危险 getattr(间接引用绕过全部拦截)、JWT 登出后 jti 进入 Redis 黑名单即时失效、登录前清空 Session(会话固定)、SQL LIKE 通配符统一转义、Meilisearch 地址保存与使用前校验(允许内网)、生产环境 DEBUG 强制阻断、数据库连接错误对外脱敏;另修复验证码随机源与 fragment 操作审计日志。无数据库结构变更、无新增依赖。

v3.1.8(2026-11-06)

安全加固专项(GitCode issue #12,SAST 深度审计)。修复 P0+P1 共 7 个漏洞:主题模板 SSTI(构建器渲染强制 Jinja 沙箱 + 上传静态审计)、插件包 RCE(上传静态审计 + 直传开关默认关闭)、敏感凭证明文入库(Fernet 加密 + 惰性迁移)、企业微信/短信 Webhook SSRF(域名白名单 + 内网 IP 拒绝)、JWT 密钥与 SECRET_KEY 隔离(未配置自动生成持久化);新增 CSP 第三方资源白名单(后台「后台安全」页可配 script/style/img/font/connect/media/frame-src 7 个指令来源)。无数据库结构变更、无新增依赖。

v3.1.7(2026-11-03)

稳定性修复。修复文章/栏目批量删除、归档、发布、移动等操作因 CSRF Token 缺失导致的 403,并消除批量表单与行内表单的非法嵌套;全站索引重建改为后台异步任务 + 页面轮询进度,重建期间增量变更自动补索引;数据库迁移插件新增源库外键孤儿预检与可空列自动置空,迁移失败时给出表名/行数定位。无数据库结构变更、无新增依赖。

v3.1.6(2026-11-01)

异常吞噬专项治理。全库通用异常捕获统一中文 warning 留痕、可判定场景收窄为具体异常类型、插件隔离处保留宽捕获并注释;文章五状态流转收敛为 app/services/workflow_service.py 状态机并改为单事务提交(状态与版本快照原子生效);新增 CI 门禁 scripts/check_excepts.py(配套白名单)。无数据库结构变更、无新增依赖。

v3.1.5(2026-11-01)

后台富文本双模式编辑。文章正文、单页栏目内容与富文本碎片新增 Markdown 模式(表单内一键切换 + 实时预览,系统设置可改默认模式),Markdown 原文双写存储、content 始终为 HTML,前台主题 / 搜索 / API 零改动。数据库迁移 0011,新增依赖 markdown。

v3.1.0(2026-10-10)

数据库迁移插件。新增官方内置插件 db_migrator(默认不启用):后台一键把 SQLite 开发库迁移到 MySQL/PostgreSQL——目标库建表 → 按外键依赖逐表复制(单事务失败整体回滚)→ PostgreSQL 自动重置自增序列 → 同步 Alembic 版本号;连接测试、目标库非空保护(需显式勾选覆盖)、迁移后立即热切换引擎免重启(失败自动回滚配置)。修复文章批量操作(发布/撤回/删除/归档/移动/提交审核)不更新搜索索引的问题;修复后台用户管理表单与业务层脱节导致的多项账号管理异常(两次密码一致却提示不一致、新增账号默认禁用、角色未绑定、重置密码校验失败等)。无数据库结构变更、无新增依赖。

v3.0.0(2026-09-15)

可视化页面构建器。原生 HTML5 拖拽 + JSON Schema 组件注册 + iframe 服务端真实渲染,覆盖首页/单页/列表页/文章详情页;24 个内置组件、草稿/发布/修订回滚、中英双语文案、语言与会员可见性、三端预览与全屏预览、全局页面样式设置。默认布局三层合并:新建构建页按「当前启用主题 fixture → 核心回退」解析基础布局(第三方主题上传时校验自带 builder JSON,8 套官方主题必备首页 fixture),再叠加已启用插件贡献的布局片段(get_builder_layouts() + builder/<scope>.json,启用强校验、撞 id 自动重写、卸载清理);轮播图/产品/招聘/教程四个内容型插件启用后新首页开箱即用。插件通过 get_builder_widgets() 钩子扩展,禁用/卸载安全降级与引用拦截。「构建器为主、手写模板永久兜底」双轨策略,老站升级零行为变化。数据库迁移 0009,无新增依赖。详见 docs/PAGE_BUILDER.md。

v2.6.4(2026-09-12)

前台会员体系 + 插件依赖治理。新增社区插件 member(注册/登录/微信QQ一键登录/短信登录/找回密码/栏目会员可见性);核心新增 Column.member_only 字段与前台访问守卫;插件系统新增 requires/extends/min_core_version 启用强校验与禁用反向依赖校验。数据库迁移 0008,无新增依赖。

v2.6.0(2026-09-10)

  • 工程化完善:发布 Checklist(RELEASE.md + scripts/check_release.py)
  • pytest 测试脚手架 + GitHub Actions CI(34 项测试,3 Python 矩阵)
  • 统一异常处理(app/errors.py,403/404/500 三协议分发:前台主题 / 后台模板 / API JSON)
  • 常量治理(app/constants.py 零依赖统一命名空间 + scripts/check_constants.py CI 门禁)

v2.5.2(2026-09-09)

  • 新增:一键翻译插件——编辑页多语言 Tab 一键调用百度/有道/Google/DeepSeek 翻译回填
  • 新增:全站搜索纳入插件内容(SearchProvider 提供者机制)——产品、招聘岗位进入搜索,保存/删除/上下架实时同步
  • 新增:插件结构化内容多语言——产品「规格参数」、岗位「部门/工作地点/薪资待遇」按语言维护(迁移 0007)
  • 修复:英文搜索页文案、核心翻译 .mo 启动自动编译
  • 改进:「产品展示」「招聘管理」插件升级至 1.1.0

v2.5.1(2026-09-08)

  • 新增:全文检索国际化——Whoosh/Meili/SQL 三后端按语言分索引,搜索随当前语言返回对应内容

v2.5.0(2026-09-07)

  • 新增:内容级多语言(i18n 2.0)——文章/栏目/碎片/产品/表单/岗位/友情链接多语言翻译表,前台 t(obj, field) 全局函数,后台「多语言版本」Tab
  • 新增:Redis 缓存后端 + 服务端 Session——环境变量自动检测,多实例负载均衡
  • 改进:移除后台左侧菜单冗余项、富文本翻译字段使用 CKEditor5

v2.4.2(2026-09-06)

  • 安全:CSRF 同源校验 + 纯文本字段 XSS 防御
  • 修复:Docker 部署 worker 启动失败、CSP 拦截 CDN、初始化向导 localhost 问题

v2.4.0(2026-09-04)

  • 新增:Alembic 数据库迁移、Whoosh 全文搜索、Docker 容器化、对象存储 OSS 插件
  • 改进:存储抽象层、搜索索引自动更新、健康检查端点 /healthz

v2.3.0(2026-09-02)

  • 新增:国际化(Flask-Babel)、统计代码插件、英文主题模板
  • 改进:自定义表单插件化、插件独立翻译域

v2.2.0(2026-08-31)

  • 新增:插件优先架构、主题管理机制、轮播图/产品展示/友情链接插件、REST API

v2.1.x(2026-08-30)

  • 改进:环境变量前缀统一、项目治理文件、审计日志人性化、伪静态分页

v2.0(2026-08-29)

  • 新增:RBAC 权限、审计日志、内容工作流、备份恢复、登录安全加固、上传安全、表单通知、SEO 高级设置

完整变更历史见 CHANGELOG.md。


快速开始

环境要求

  • Python 3.10+(CI 覆盖 3.10 / 3.11 / 3.12 / 3.13,3.14 实验性)
  • 数据库:MySQL 5.7+ 或 PostgreSQL 12+(生产推荐)
  • SQLite 仅用于开发/测试(不支持并发写入)

本地开发

# 克隆代码(三平台镜像同步,任选其一)
git clone https://gitee.com/pollybird/zhycms          # Gitee(国内推荐)
# git clone https://gitcode.com/pollybird/ZhyCMS       # GitCode
# git clone https://github.com/pollybird/zhycms        # GitHub
cd zhycms

# 创建虚拟环境
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# 安装依赖(国内建议用镜像源)
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

# 启动开发服务器
python run.py

浏览器访问 http://127.0.0.1:5000,首次访问自动跳转到 /admin/setup 初始化向导。

Docker 部署

官方镜像已发布到 Docker Hub(pollybird/zhycms)、GitHub Container Registry(ghcr.io/pollybird/zhycms)和 阿里云 ACR(crpi-9u7ztjb0thx22k1a.cn-hangzhou.personal.cr.aliyuncs.com/pollybird/zhycms),当前版本 v3.1.10,开箱即用,无需本地构建:

# 1. 配置环境变量
cp docker/.env.example .env
# 编辑 .env 修改 SECRET_KEY 和数据库密码

# 2. 启动(MySQL 8.4,镜像 pollybird/zhycms:mysql)
docker compose -f docker-compose.mysql.yml up -d

# 或启动(PostgreSQL 16,镜像 pollybird/zhycms:postgresql)
docker compose -f docker-compose.postgresql.yml up -d

# 3. 访问 http://localhost:5000 完成初始化

也可直接拉取镜像:

  • Docker Hub:docker pull pollybird/zhycms:mysql(或 :postgresql / :latest / :v3.1.10)
  • GitHub GHCR:docker pull ghcr.io/pollybird/zhycms:mysql(或 :postgresql / :latest / :v3.1.10)
  • 阿里云 ACR(国内推荐,速度快):docker pull crpi-9u7ztjb0thx22k1a.cn-hangzhou.personal.cr.aliyuncs.com/pollybird/zhycms:mysql(或 :postgresql / :latest / :v3.1.10)

三个 tag(mysql / postgresql / latest)指向同一镜像,内置 MySQL / PostgreSQL 驱动,通过 ZHYCMS_DB_URI 切换数据库。GHCR 镜像默认与 GitHub 账号关联,如需匿名拉取请到 GitHub Packages 页面将可见性改为 Public。

如需本地构建或使用 MariaDB 方案,仍可用通用编排文件:

docker compose --profile mysql up -d      # 本地构建 + MySQL
docker compose --profile mariadb up -d    # 本地构建 + MariaDB 11.4
docker compose --profile postgres up -d   # 本地构建 + PostgreSQL

容器启动时自动执行数据库迁移、编译 i18n 翻译并启动 gunicorn。instance/ 和上传目录通过 volume 持久化。

生产部署

# 方式一:直接运行
ZHYCMS_ENV=production ZHYCMS_SECRET_KEY=your-secret python run.py

# 方式二:gunicorn(推荐)
gunicorn -w 4 -b 0.0.0.0:5000 "run:app"

# 方式三:Docker(见上文)

生产环境请务必使用 MySQL/PostgreSQL,并设置强密钥。


目录结构

zhycms/
├── app/
│   ├── admin/              # 后台模块(栏目、文章、用户、角色、审计、备份、设置等)
│   ├── frontend/           # 前台模块
│   │   └── templates/
│   │       └── themes/     # 前台主题目录(含 css/js/images/fonts)
│   ├── models/             # 数据模型(用户、RBAC、审计、工作流、备份、上传等)
│   ├── translations/       # 国际化翻译文件
│   ├── utils/              # 工具模块(上传、通知、备份、存储、主题等)
│   ├── static/             # 静态资源
│   ├── __init__.py         # 应用工厂
│   ├── config.py           # 配置
│   ├── builder/            # 页面构建器(组件注册表/Schema/渲染器/默认布局/插件片段合并)
│   ├── plugin_system.py    # 插件运行时
│   ├── plugin_api.py       # PluginBase 基类
│   └── extensions.py       # 扩展初始化
├── plugins/                # 插件目录
│   ├── banner/             # 轮播图插件
│   ├── product/            # 产品展示插件
│   ├── recruit/            # 招聘管理插件
│   ├── tutorial/           # 教程中心插件
│   ├── friend_link/        # 友情链接插件
│   ├── form/               # 自定义表单插件
│   ├── analytics/          # 统计代码插件
│   ├── oss_storage/        # 对象存储插件
│   ├── auto_translate/     # 一键翻译插件
│   ├── db_migrator/        # 数据库迁移插件(默认不启用)
│   └── member/             # 前台用户中心插件(社区插件)
├── migrations/             # Alembic 数据库迁移脚本
├── docker/                 # Docker 部署辅助文件
├── instance/               # 实例数据(数据库、配置、备份、索引等)
├── requirements.txt        # 核心依赖
├── requirements-prod.txt   # 生产依赖(gunicorn + gevent)
├── Dockerfile              # 多阶段构建镜像
├── docker-compose.yml      # 通用编排文件(--profile mysql/mariadb/postgres,本地构建)
├── docker-compose.mysql.yml      # MySQL 独立编排(拉取 pollybird/zhycms:mysql)
├── docker-compose.postgresql.yml # PostgreSQL 独立编排(拉取 pollybird/zhycms:postgresql)
├── wsgi.py                 # 生产 WSGI 入口
├── run.py                  # 开发启动入口
└── babel.cfg               # pybabel 提取配置

核心功能详解

主题系统

  • 多主题组织:前台模板按主题目录存放,后台一键切换,即时生效
  • 主题管理:支持上传 .zip/.tar.gz/.tgz 压缩包,8 步安全校验后解压;支持打包下载跨站复用
  • 栏目级模板:每个栏目可独立指定列表页/内容页/单页模板
  • 安全兜底:启用主题缺失必备模板时自动回退 default 主题,杜绝白屏
  • 静态资源隔离:每套主题独立拥有 css/js/images/fonts 子目录

页面构建器

  • 拖拽建页(v3.0.0):原生 HTML5 拖拽编辑器 + iframe 内服务端真实渲染,覆盖首页/单页/列表页/文章详情页四作用域,无 Node 构建链
  • 24 个内置组件:布局(section/grid 等)、基础(标题/文本/富文本/图片/按钮等)、数据(文章列表/轮播/友情链接/联系卡等)三组;草稿/发布/修订回滚,匿名访客只见已发布版
  • 默认布局三层合并:当前主题 fixture → 核心回退 → 已启用插件贡献片段;8 套官方主题必备首页布局,第三方主题上传时校验自带 builder JSON
  • 双语与可见性:文案中英 Tab、节点语言白名单与会员限定;桌面/平板/手机三端预览与全屏预览
  • 插件扩展:get_builder_widgets() 注册组件、get_builder_layouts() 贡献默认布局片段(启用强校验、卸载引用拦截);轮播图/产品/招聘/教程启用即开箱即用
  • 双轨兜底:「构建器为主、手写模板永久兜底」,只有已发布布局的页面才走构建器,老站升级零行为变化

插件机制

  • 零侵入扩展:plugins/<slug>/ 目录 + manifest.json + PluginBase 基类
  • 运行时门控:以 site_settings.enabled_plugins 控制启停,禁用即隐身、不删数据
  • 能力扩展:可扩展后台页面、前台路由/模板函数、数据表、REST API、sitemap、全站搜索内容贡献(SearchProvider)、审计模块、演示数据钩子、页面构建器组件(get_builder_widgets())与默认布局片段(get_builder_layouts())
  • 依赖/继承/最低版本校验(v2.6.4):manifest.json 支持 requires / extends / min_core_version,启用时强校验、禁用时反向依赖校验,详见 PLUGIN_DEPENDENCIES.md
  • 官方内置插件:轮播图、产品展示、友情链接、自定义表单、统计代码、对象存储、一键翻译、数据库迁移(8 个,不可卸载;数据库迁移默认不启用)
  • 社区插件:前台用户中心(member)、招聘管理(recruit)、教程中心(tutorial),随包分发、可卸载
  • 构建器开箱即用(v3.0.0):轮播图/产品/招聘/教程四个内容型插件启用后,向页面构建器贡献组件与首页默认布局片段,新建首页自动带上对应区块

国际化

  • 界面文案国际化(v2.3):Flask-Babel 全站覆盖,前台 + 后台界面文案支持中英文切换
  • 内容级多语言(v2.5):文章/栏目/碎片/产品/表单/岗位/友情链接支持多语言翻译表,前台 Jinja 全局 t(obj, field) 按当前 locale 取翻译,无翻译 fallback 默认语言
  • 结构化字段多语言(v2.5.2):产品「规格参数」(JSON)与岗位「部门/工作地点/薪资待遇」支持按语言维护,翻译留空回退默认语言
  • 多级 Locale 选择:URL 参数 → Session → Cookie → Accept-Language → 默认语种
  • 插件独立翻译域:每个插件可在 plugins/<slug>/translations/ 自带译文;启动时缺失/过期的核心 .mo 自动编译
  • 默认关闭:不影响现有站点,开启后即时生效
  • 英文主题:内置 default_en、manufacturing_en 两套英文主题模板

数据库迁移

  • Flask-Migrate(Alembic):统一管理 schema 版本,支持 upgrade/downgrade
  • 旧站自动升级:v2.3.x 及更早站点覆盖代码后首次启动自动 stamp baseline,仅执行增量迁移
  • 插件迁移支持:插件可通过 get_migration_files() 自带迁移脚本,纳入 Alembic 统一管理
  • SQLite 兼容:render_as_batch=True 绕过 SQLite ALTER TABLE 限制
  • 数据库类型一键迁移(v3.1.0):内置插件 db_migrator(默认不启用),后台把 SQLite 开发库整体迁移到 MySQL/PostgreSQL——目标库建表、按外键依赖逐表复制(单事务失败整体回滚)、PostgreSQL 自动重置自增序列、同步 Alembic 版本号;目标库非空保护、连接测试、支持迁移后免重启热切换引擎

全文搜索

  • 默认引擎:Tantivy(Rust 内核,tantivy-py 绑定,v3.1.4 起)+ pkuseg 中文分词(spacy-pkuseg)
  • 可选后端:Meilisearch(大型站点推荐)
  • 索引范围:文章(标题 + 正文去 HTML + 摘要 + 栏目名)+ 插件内容(产品、招聘岗位)
  • 多语言检索(v2.5.1):按当前语言分索引检索,未翻译内容回退默认语言
  • 插件内容接入(v2.5.2):插件通过 get_search_provider()(SearchProvider 协议)接入全站搜索,产品规格参数、岗位部门/地点/薪资均可检索
  • 自动更新:文章与插件内容保存/删除时通过钩子自动更新索引,文章批量操作(发布/撤回/删除/归档/移动/提交审核)逐篇同步更新
  • 故障回退:索引异常或零命中时自动降级为 SQL LIKE 查询(同步覆盖插件内容),搜索不中断
  • 高亮与分页:6 套主题搜索模板均支持关键词高亮和分页

对象存储

  • 存储抽象层:app/utils/storage.py 统一驱动协议,所有上传走同一入口
  • 支持厂商:阿里云 OSS、腾讯云 COS、七牛云 Kodo(SDK 可选安装、懒加载)
  • 默认本地:未配置时行为与旧版完全一致,零侵入
  • 一键迁移:本地历史文件批量上传云端,自动改写文章正文/封面等链接为云域名
  • 安全设计:上传失败显式报错、禁用插件自动回退本地、备份文件强制留本地

安全体系

层面 措施
访问控制 自定义后台路由前缀(即时生效)、RBAC 权限、栏目级内容授权
登录安全 连续失败锁定、图形验证码、异地 IP 登录提醒
上传安全 后缀白名单 + MIME 双重校验、SHA-256 内容去重、图片自动压缩
输入安全 路径穿越拦截、审计日志详情 HTML 转义防 XSS
运维安全 审计日志全量留痕、备份恢复前自动释放连接池

SEO 与性能

  • 伪静态:/{slug}.html、/{slug}-{page}.html、/article-{id}.html
  • Sitemap:栏目与文章独立配置更新频率/优先级,插件 URL 自动聚合
  • Robots.txt:后台可视化编辑,支持追加自定义规则
  • 页面缓存:Flask-Caching,首页/栏目/文章独立 TTL,内容变更自动清理;配置 REDIS_URL 后自动切 RedisCache,支撑多实例
  • Redis 缓存后端(v2.5):设置环境变量 REDIS_URL 后,Flask-Caching 切 RedisCache、Flask-Session 存 Redis,多实例共享缓存与 Session;后台「系统设置 → Redis 缓存」展示运行状态
  • 图片优化:自动压缩、缩略图生成、默认 ALT 注入

内容工作流

  • 状态流转:草稿 → 待审核 → 已发布 / 已驳回
  • 版本管理:每次保存自动生成快照,支持对比差异与一键还原
  • 权限分离:无发布权限的作者提交后进入审核队列,编辑审核后发布

审计日志

  • 覆盖范围:登录/登出、配置变更、内容 CRUD、备份恢复、权限调整、插件/主题操作
  • 检索维度:按模块、操作类型、操作人、时间范围筛选
  • 详情人性化:键名/配置项中文翻译、状态语义化、变更对照(旧值 → 新值)、ID 自动显示名称

开发者文档

深入开发与运维排障请阅读仓库 docs/ 目录下的权威文档:

文档 内容
docs/PAGE_BUILDER.md 页面构建器手册:用户指南、组件开发 API、默认布局三层解析与插件贡献片段约定
docs/PLUGIN_DEV.md 插件开发手册:目录结构、manifest.json 字段、PluginBase API、钩子与数据模型规范,含可直接复制的最小示例插件
docs/THEME_TEMPLATE_API.md 主题模板开发 API:模板继承链、全局变量、Jinja 过滤器与函数、页面上下文
docs/OPERATIONS_FAQ.md 运维故障排查 FAQ:常见报错、数据库迁移失败处理、缓存/主题/插件/伪静态/Docker 排障速查
PLUGIN_DEPENDENCIES.md 插件依赖 / 继承 / 最低核心版本校验详解

单页版文档见 wiki.html,在线 Wiki 见 Gitee / GitCode / GitHub 仓库 Wiki 页(三平台镜像同步)。


升级指南

v2.6.x → v3.0.0

覆盖代码 + pip install -r requirements.txt + 重启应用即可。首次启动自动执行 Alembic 迁移 0009(新增 builder_pages / builder_revisions 两张表),无新增 Python 依赖。

  • 升级后所有页面默认仍走手写模板,行为与 v2.6.4 完全一致;到后台「页面构建」创建并发布布局后对应页面才切换为构建器渲染
  • 启用轮播图/产品/招聘/教程插件的站点,新建首页时默认布局会自动增补对应区块(已有草稿与已发布页不受影响)
  • 详见 UPGRADE.md 与 docs/PAGE_BUILDER.md

v2.5.x → v2.5.2

覆盖代码 + pip install -r requirements.txt + 重启应用即可。

  • 首次启动自动编译核心翻译 .mo(英文界面立即生效)并自动执行 Alembic 迁移 0007(产品规格参数/岗位结构化字段多语言列)
  • 后台「插件管理」启用「一键翻译」并配置服务商密钥即可使用
  • 全站搜索已包含产品/岗位:升级后到「系统设置 → 搜索设置」点一次「重建索引」立即将存量产品/岗位纳入检索(新保存内容会自动同步)
  • 启用「产品展示」「招聘管理」的站点,插件随核心升级至 1.1.0,历史数据与翻译无缝保留

v2.4.x → v2.5.0

覆盖代码 + pip install -r requirements.txt + flask db upgrade 即可。新增 7 张翻译表(迁移 0005 + 0006),无破坏性变更。

  • 启用多语言:后台「系统设置 → 国际化」开启,配置默认语言与可用语种
  • 启用 Redis:设置环境变量 REDIS_URL=redis://127.0.0.1:6379/0 后重启应用
  • 未启用 i18n / Redis 的站点,行为与 v2.4.2 完全一致

v2.3.x → v2.4.0

仅覆盖代码 + pip install -r requirements.txt 即可。首次启动自动 stamp Alembic baseline 并执行增量迁移,无需手动操作。

  • 全文搜索默认 Tantivy,升级后首次启动自动后台重建索引(重建期间回退 SQL LIKE),无需手动操作
  • 对象存储插件升级后自动启用,不配置凭证不产生云端调用

v2.2.x → v2.3.0

仅覆盖代码即可。自定义表单已并入插件体系,升级后首次启动自动启用表单插件一次,旧数据与审计日志无缝保留。

v1.1 → v2.0+

  1. 备份站点目录与数据库(必做)
  2. 停服并更新代码:git fetch && git checkout v2.4.0
  3. 更新依赖:pip install -r requirements.txt
  4. 执行迁移:.venv/bin/python scripts/upgrade_v2.py(v1.1 专用)
  5. 启动服务,按 UPGRADE.md 逐项核对

升级涉及新建表、补列、数据回填,仅启动程序无法完成迁移。


Star 支持

如果 ZhyCMS 帮你快速搭起了站点,欢迎在 GitHub / Gitee / GitCode 点个 Star,这是对项目最直接的鼓励;也欢迎提 Issue、发 PR 一起共建。


参与贡献

欢迎报告问题与提交 PR!


许可证

本项目基于 Apache License 2.0 开源。

Copyright 2026 泰州姜堰钟毓信息技术有限公司

Introduction

轻量级开源企业 CMS,Apache 2.0 免费商用。插件化扩展、多主题切换、RBAC 权限、内容工作流、审计日志、SEO 伪静态、对象存储、Docker 一键部署。适合替代传统 PHP CMS,用 Python 技术栈搭建企业官网。

Customize your domain