UJCMS 简介
校对日期:2026-11-16。适用于社区版及全部商业版;各版本的功能差别见“版本”一节。
UJCMS 是一款基于 Java 的开源网站内容管理系统(Java CMS),用于建设和维护企业、机构的网站:在后台管理栏目和文章, 前台按主题模板显示为网页。也可以只用它管理内容,通过接口把内容提供给自行开发的网站前端、小程序或 App(无头 CMS)。
想马上装起来看,见快速开始;栏目、文章、区块这些名词的含义,见基本概念。
一、系统组成
UJCMS 是一个 Spring Boot 程序,启动后同时提供三样东西:
| 部分 | 地址 | 说明 |
|---|---|---|
| 网站前台 | / | 访客看到的网页,由主题里的 FreeMarker 模板渲染 |
| 后台(控制台) | /cp/ | 管理栏目、文章、用户、设置的界面,用 Vue 3 开发的单页应用 |
| 公开接口 | /api/** | REST 接口,返回 JSON,供前后端分离的前端、小程序、App 调用 |
内容保存在数据库里;上传的文件、主题模板和全文索引保存在程序目录下(各目录的位置见 Jar 部署 和 Tomcat 部署)。数据库的表由程序在启动时自动创建,升级时自动更新表结构,不需要手工执行 SQL。
使用的主要技术:
| 用途 | 技术 |
|---|---|
| 后端框架 | Spring Boot、Spring MVC、Spring Security、MyBatis |
| 前台模板 | FreeMarker |
| 表结构的创建与升级 | Liquibase |
| 全文检索 | Lucene;商业版高级版可以改用 Elasticsearch |
| 审核流程 | Flowable(商业版基础版及以上;社区版不包含这个组件) |
| 后台界面 | Vue 3、Vite、TypeScript、Element Plus、Pinia、Vue Router、Vue I18n、Tailwind CSS、ECharts、TinyMCE |
源码分为以下模块,二次开发时按需阅读:
ujcms-common:公共工具库。ujcms-cms:CMS 核心功能。ujcms-starter:Spring Boot 启动模块,默认主题也在这里(src/)。main/ webapp/ themes/ 1/ default ujcms-ui-console:后台界面。ujcms-ui-ssr-vue:前后端分离的示例站点,见“两种开发模式”一节。
二、两种开发模式
网站前台有两种做法,可以只用一种,也可以同时使用。
模板 + 标签
系统默认的方式。页面由主题里的 FreeMarker 模板渲染,模板中用 UJCMS 提供的标签(如 ArticleList、ChannelList)取数据。 部署时只有 UJCMS 一个程序;主题管理、应用市场、页面可视化设计和静态化都建立在这种方式上。
- 主题保存在
themes/目录,随程序自带的默认主题是{站点ID}/ {主题} themes/,首页模板为其中的1/ default templates/。index. html - 可以在后台的 设计 → 模板 里直接修改模板文件,也可以制作自己的主题,见主题开发。
- 会员在前台登录使用浏览器会话(session)。模板页面里提交留言、评论等数据的请求,地址以
/frontend开头(模板中写作${api})。
Vue + API
前端独立开发、独立部署,数据全部来自公开接口 /api/**。适合前后端分离的网站,以及小程序、App。
- 源码中的
ujcms-ui-ssr-vue是这种方式的示例站点,基于 Nuxt,采用服务端渲染(SSR),只调用公开接口。 - 接口不使用会话,登录后用令牌(JWT)鉴权。
标签与接口的关系
每个取数据的标签都对应一个公开接口(如 ArticleList 对应 GET /),参数名与接口的查询参数相同, 拿到的数据结构与接口返回的 JSON 相同。所以两种方式可以互相参照:会写模板标签,就知道接口怎么调用。
接口文档由程序自己生成,默认关闭。在 application. 中把 springdoc. 和 springdoc. 设为 true 后,访问 /swagger-ui/ 查看。
三、运行环境
| 项目 | 要求 |
|---|---|
| JDK | 17 或 21,见 JDK 选择与安装 |
| 数据库 | MySQL 8.0(5.7.22 及以上、8.0.20 及以上)。小版本过低可能导致程序无法启动 |
| Tomcat | 10.1 及以上。只在用 war 安装包部署时需要;Jar 安装包内置 Tomcat |
| Node.js | 22.12 及以上。只在从源码构建时需要,见 Node.js 与 pnpm 安装 |
鲲鹏、飞腾、海光、兆芯、龙芯、申威等国产 CPU 平台上 JDK 的选择,见 JDK 选择与安装的“国产 CPU 平台”一节。 达梦、人大金仓、瀚高、神通等国产数据库的支持属于商业版基础版的功能。
四、版本
UJCMS 分为社区版和商业版:
- 社区版:按 GPL-3.0 协议开源。使用时须遵守该协议的全部条款,例如分发本软件(包括修改后的版本)时,必须以 GPL-3.0 开放全部源代码。
- 商业版:按合同授权,分为基础版、标准版、高级版、旗舰版四档,高一档包含低一档的全部功能。不希望受 GPL-3.0 约束(如闭源分发、基于本软件开发商业产品)时,也需要取得商业授权。详见官网 https://www.ujcms.com。
各版本的功能一句话概括:
- 社区版:建站所需的基本功能——栏目、文章、模型、主题与模板、页面静态化、全文检索、访问统计、用户与角色等,单个站点。
- 基础版:增加文章审核流程、日志、安全设置、文章与用户的批量导入、数据迁移、国产数据库支持。
- 标准版:增加多站点、多语言、专题、自定义表单、采集、AI 功能、第三方登录、定时任务等。
- 高级版:增加页面可视化设计、微信公众号、Elasticsearch 与 Redis 等。
- 旗舰版:增加依申请公开、领导信箱、在线访谈、网站普查等政务功能。
每一项功能从哪个版本开始提供,见版本对比。
五、演示站
用手机访问前台,或者用浏览器的手机模式访问,页面会自适应为手机端的样式。英文站是另一个站点,与中文站组成一个语言组, 这种用法见多语言站点(需要商业版标准版)。
自己安装时,在安装向导里选择导入演示数据,就能得到一个带有演示栏目和文章的站点,见快速开始。