# MCMS

**Repository Path**: mingSoft/MCMS

## Basic Information

- **Project Name**: MCMS
- **Description**: 🌈免费可商用Java开源CMS系统，🔥支持可视化拖拽设计网页，SpringBoot3，Vue3、element plus、🔥国产化、🔥信创、🔥等保，定期收集issues问题并更新版本，提供上百套模板与多款实用的插件，提供代码生成器、皮肤设计器方便快速开发业务
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://www.mingsoft.net
- **GVP Project**: Yes

## Statistics

- **Stars**: 32879
- **Forks**: 7467
- **Created**: 2015-10-28
- **Last Updated**: 2026-07-13

## Categories & Tags

**Categories**: cms

**Tags**: CMS, Java开源CMS, 铭飞MCms

## README

<p align="center">
	<a href="https://www.mingsoft.net/" target="_blank" rel="noopener">
<img src="http://cdn.mingsoft.net/global/images/logo-blue.png"  alt="铭飞MCMS开源Java内容管理系统Logo" width="50" height="50">
</a>
</p>
<p align="center">
	<strong>价值源自分享</strong>
</p>

<p align="center">
   <a target="_blank" rel="noopener" href="https://search.maven.org/search?q=ms-mcms">
        <img src="https://img.shields.io/maven-central/v/net.mingsoft/ms-mcms.svg?label=Maven%20Central" alt="MCMS内容管理系统在Maven中央仓库的最新稳定版本号"/>
   </a>

   <a target="_blank" rel="noopener" href="https://baike.baidu.com/item/MIT%E8%AE%B8%E5%8F%AF%E8%AF%81/6671281">
        <img src="https://img.shields.io/:license-MIT-blue.svg" alt="铭飞MCMS采用MIT开源协议免费开放源代码" />
   </a>

   <a target="_blank" rel="noopener" href="https://www.oracle.com/technetwork/java/javase/downloads/index.html">
      <img src="https://img.shields.io/badge/JDK-17+-green.svg" alt="铭飞低代码平台支持JDK17及以上Java运行环境"/>
   </a>

   <a target="_blank" rel="noopener" href="https://gitee.com/mingSoft/MCMS/stargazers">
      <img src="https://gitee.com/mingSoft/MCMS/badge/star.svg?theme=dark" alt='开源Java CMS项目MCMS在Gitee社区的Star星标数量'/>
   </a>

   <a target="_blank" rel="noopener" href='https://github.com/ming-soft/mcms'>
      <img src="https://img.shields.io/github/stars/ming-soft/mcms.svg?style=social" alt="铭飞开源内容管理系统在GitHub平台的Star关注度"/>
   </a>
</p>

<p align="center">
	<a href="#皮肤设计器" title="MCMS开源可视化皮肤设计器" >皮肤设计器</a> 
    <a href="#mstore-使用模板" title="MStore网站模板使用教程" >MStore模板使用</a>
    <a href="#代码生成器" title="MCMS低代码Java代码生成器">代码生成器</a> 
	<a href="http://a.cms.demo.mingsoft.net/ms/login.do" target="_blank" rel="noopener" title="MCMS开源Java CMS后台管理系统演示">后台演示</a> 
    <a href="http://a.cms.demo.mingsoft.net/" target="_blank" rel="noopener" title="MCMS前台网站效果展示">前台演示</a> 
	<a href="http://doc.mingsoft.net/mcms/" target="_blank" rel="noopener" title="在线使用手册与官方开发文档">在线使用手册</a>
	<a href="https://space.bilibili.com/1825880395" target="_blank" rel="noopener" title="B站Java CMS视频教程中心">B站视频</a><br/>
	<a href="https://cloud.189.cn/web/share?code=7veQBn3i267f%EF%BC%88%E8%AE%BF%E9%97%AE%E7%A0%81%EF%BC%9Aapz2%EF%BC%89" target="_blank" rel="noopener" title="Windows与Linux一键运行版本下载">一键运行版本</a>
    <a href="#快速体验docker" title="Docker一键部署体验">Docker体验</a>
</p>

-------------------------------------------------------------------------------

<p align="center">
	<strong>一直在改变，从未停止过！努力打造一款国内好用的Java CMS内容管理软件</strong>
</p>

## 官方技术交流与社区支持


[![加入QQ群](https://img.shields.io/badge/QQ一群-231212174-red.svg?logo=tencentqq&style=for-the-badge)](https://qm.qq.com/cgi-bin/qm/qr?k=FVvyoF1YwtFpCGLf--h42_AwtF6JOD9M&jump_from=webapi&authKey=EyNayGyX0U/6hJKtpBInh9FsCpeM8Vx2KqrmmCZyXe3f1PD5kboChBSIWkB6SOb5)
[![加入QQ群](https://img.shields.io/badge/QQ二群-221335098-red.svg?logo=tencentqq&style=for-the-badge)](https://qm.qq.com/cgi-bin/qm/qr?k=fedNH1fR6niG16cYVPXPZJ3U8m9Hfxaf&jump_from=webapi&authKey=6rMUTyta7sKlSpeF/fYkVHp6mF9sZc6i5vmHzGgdh6WHW34yww5eDBXJwCVmoMyl)
[![加入QQ群](https://img.shields.io/badge/QQ三群-242805203-red.svg?logo=tencentqq&style=for-the-badge)](https://qm.qq.com/cgi-bin/qm/qr?k=1K_RsMwZcf09Y-_74PhA_NfI85RqeDyK&jump_from=webapi&authKey=vCeXrE2f5QCobzDFZ4lHzHyH7sGtmhVfR326MjEmeMy6u0NgHlIglCCxD/6b7tEK)
[![加入QQ群](https://img.shields.io/badge/QQ四群-881894877-red.svg?logo=tencentqq&style=for-the-badge)](https://qm.qq.com/cgi-bin/qm/qr?k=TzRiJf4x7tZsjKEzo8EuwuHqTALc0xCA&jump_from=webapi&authKey=04YpueACppV1tLykhOQ+fdzPhPwOkIU685LgCOQqrwEjtVQCOvTAyd6qn3xAiXl2)
[![加入QQ群](https://img.shields.io/badge/QQ五群-231211521-red.svg?logo=tencentqq&style=for-the-badge)](https://qm.qq.com/cgi-bin/qm/qr?k=IfVdHXCm13Ui6NrcjvrraFkGsI8L3U1r&jump_from=webapi&authKey=Go37VdoKublA0p47ww9fS+fxt2DAh1URslG0/7ugg8zs1b+heVlGZwkASM/PlJPG)


<a href="http://store.mingsoft.net" target="_blank" rel="noopener">
	<img src="https://foruda.gitee.com/images/1689152074095382619/e477707b_542665.png" 
	     alt="MStore商城：提供丰富的响应式网站模板与功能插件，价值源自分享" 
	     title="点击进入 MStore 商城获取更多 Java CMS 模板插件">
</a>


<a href="https://www.mingsoft.net/renwudating.html" target="_blank" rel="noopener">
	<img src="https://foruda.gitee.com/images/1686668592600137699/9ce47a46_542665.png" 
	     alt="铭飞任务大厅：构建良好的开源生态，让开发者知识共享与发布悬赏任务" 
	     title="点击进入铭飞任务大厅参与定制开发与技术共创">
</a>


<a href="https://www.mingsoft.net/" target="_blank" rel="noopener">
	<img src="https://foruda.gitee.com/images/1689149903145351822/c3fed309_542665.png" 
	     alt="免备案建站服务：安全可靠稳定的站群SaaS部署平台，9.9元在线开通网站" 
	     title="访问铭飞官网了解低代码SaaS快速建站方案">
</a>


<a href="https://www.mingsoft.net/1915279312982421506.html" target="_blank" rel="noopener">
	<img src="https://www.mingsoft.net/upload/1/cms/content/20250424/1745473233713.png" 
	     alt="MCMS全面适配国产数据库服务：完美支持达梦、人大金仓、神通等国产数据库" 
	     title="点击查看开源Java CMS支持国产化信创环境的升级配置说明">
</a>

## 开源说明

* 系统100%开源
* 模块化开发模式，铭飞所开发的模块都发布到了maven中央库。 可以通过pom.xml文件的方式拉取源代码

```
<dependency>
	<groupId>net.mingsoft</groupId>
	<artifactId>模块</artifactId>
	<version>版本号</version>
	<classifier>sources</classifier>
	<scope>provided</scope>
</dependency>
```

## Vue 3 脚手架版本

目前开发版本以上已经支持 VUE 3 脚手架，您可以通过 [MCMS企业版与开源版本对比](https://www.mingsoft.net/banben.html "查看MCMS版本功能差异说明") 了解更多细节。

## 商用

基于<a href="https://www.oschina.net/question/12_2829" target="_blank" rel="noopener" title="查看开源中国关于 MIT 协议商用授权的合规说明" >MIT</a> 开源协议，可直接商用无需授权，但请尊重开源精神不要去掉代码中铭飞的注释和版权信息


## 特点

* 支持可视化模板拖拽网页设计<br>
* 免费完整开源：基于MIT协议，源代码完全开源，无商业限制,MS开发团队承诺将MCMS内容系统永久完整开源；<br/>
* 标签化建站：不需要专业的后台开发技能，只要使用系统提供的标签，就能轻松建设网站；<br/>
* html静态化：系统支持全站静态化；<br/>
* 跨终端：站点同时支持PC与移动端访问，同时会自动根据访问的终端切换到对应的界面，数据由系统统一管理；<br/>
* 海量模版：铭飞通过MStore（MS商城）分享更多免费、精美的企业网站模版，降低建站成本；<br/>
* 丰富插件：为了让MCms适应更多的业务场景，在MStore用户可以下载对应的插件，如：站群插件、微信插件、商城插件等；<br/>
* 每月更新：铭飞团队承诺每月28日为系统升级日，分享更多好用等模版与插件；<br/>
* 文档丰富：为了让用户更快速的使用MCms系统进行开发，铭飞团队持续更新开发相关文档，如标签文档、使用文档、视频教程等；<br/>

## 面向对象

* 企 业：帮助创立初期的公司或团队快速搭建产品的技术平台，加快公司项目开发进度；
* 开发者：帮助开发者快速完成承接外包的项目，避免从零搭建系统；
* 学习者：初学JAVA的同学可以下载源代码来进行学习交流；

## 开发环境
建议开发者使用以下环境，这样避免版本带来的问题
* Windows、Linux
* Eclipse、Idea
* Mysql≧8 (开启忽略大小写)
* JDK≧17
* Tomcat≧10


## 快速体验（导入到 Eclipse 或 IDEA）

1、检出源代码：
```bash
git clone https://gitee.com/mingSoft/MCMS.git
```

2、导入项目<br/>
* Eclipse导入，菜单 File -> Import，然后选择 Maven -> Existing Maven Projects，点击 Next> 按钮，选择检出的项目MCMS文件夹，然后点击 Finish 按钮，即可成功导入
* IDEA导入，点击 Import Project，选择 pom.xml 文件，点击 Next 按钮，选择 Import Maven projects automatically 复选框，然后一直点击 Next 按钮，直到点击 Finish 按钮，即可成功导入<br/>

4、Eclipse（IDEA）会自动加载 Maven 依赖包，初次加载会比较慢（根据自身网络情况而定），若工程上有小叉号，请打开 Problems 窗口，查看具体错误内容，直到无错误为止<br/>
5、创建数据库mcms（数据库使用utf-8编码），导入doc/mcms-版本号.sql，如果升级现有系统请使用＊-up-*.sql升级，如果导入了系统对应的完整版SQL，sql升级补丁不需要重复导入；<br/>
6、修改src\main\resources\application-dev.yml文件中的数据库设置参数；<br/>
7、运行MSApplication.java main方法<br/>
8、首先先访问后台地址：http://localhost:8080/ms/login.do ，管理员账号，用户名：msopen 密码：msopen，进入后台点击内容管理->静态化菜单，进行"生成主页"，"生成栏目","生成文章"操作一遍 （注意！！！是后台登录界面，不是会员中心登录界面）

## 快速体验（docker）

```
docker run -p 3316:3306 -p 8181:8080 --name mcms --privileged=true -e TZ=Asia/Shanghai  \
--restart=always -e MYSQL_ROOT_PASSWORD=123456 -d docker.1ms.run/mingsoft/mcms:6.0.0 \
--sql-mode="STRICT_TRANS_TABLES,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION" \
--lower-case-table-names=1 \
--query-cache-type=1 \
--query-cache-size=600000 \
--max-connections=1000

# 容器启动成功后执行启动mcms服务

docker exec mcms /home/start.sh

#后台访问地址
http://localhost:8181/ms/login.do
账号：msopen
密码：msopen

```

`MYSQL_ROOT_PASSWORD` 数据库密码，如果修改需要修改容器 `/home/mcms/config/` 下配置文件的链接，实际部署可以将 `/home/mcms` 挂载到外部文件夹，方便更新 `mcms` 系统文件




## 技术选型

### 后端框架

| 技术            | 名称               | 官网                                                       | 开源协议       |
| :------------- |:------------------| :--------------------------------------------------------- |:------------|
| Spring Framework | 容器               | [http://projects.spring.io/spring-framework](http://projects.spring.io/spring-framework/) | Apache 2.0 |
| Spring Boot      | MVC               | [https://spring.io/projects/spring-boot](https://spring.io/projects/spring-boot) | Apache 2.0 |
| Apache Shiro     | 安全               | [http://shiro.apache.org](http://shiro.apache.org/) | Apache 2.0 |
| MyBatis          | DAO                | [http://www.mybatis.org](http://www.mybatis.org/mybatis-3/zh/index.html) | Apache 2.0 |
| MyBatis-Plus     | ORM                | [https://baomidou.com/](https://baomidou.com/) | Apache 2.0 |
| Freemarker       | 视图               | [http://freemarker.foofun.cn](http://freemarker.foofun.cn/) | Apache 2.0 |
| PageHelper       | MyBatis分页插件    | [https://gitee.com/free/Mybatis_PageHelper](https://gitee.com/free/Mybatis_PageHelper) | Apache 2.0 |
| Log4J            | 日志组件           | [http://logging.apache.org](http://logging.apache.org) | Apache 2.0 |
| Maven            | 项目构建           | [http://maven.apache.org](http://maven.apache.org/) | Apache 2.0 |
| Elasticsearch    | 分布式搜索引擎     | [https://www.elastic.co](https://www.elastic.co/) | Apache 2.0 |
| Redis            | 分布式缓存数据库   | [https://redis.io](https://redis.io) | MIT |
| Hutool           | 工具类             | [http://hutool.mydoc.io](http://hutool.mydoc.io) | MIT |

### 前端框架

| 技术            | 名称               | 官网                                                       | 开源协议       |
|:--------------| :-----------------| :---------------------------------------------------------- |:-------------|
| Vue 3         | MVVM框架           | [https://cn.vuejs.org//](https://cn.vuejs.org/) | MIT |
| Element Plus  | UI库               | [https://element-plus.org/](https://element-plus.org/) | MIT |
| jQuery        | 函式库             | [http://jquery.com/](http://jquery.com/) | MIT |
| hover.css     | 点击效果插件       | [https://github.com/fians/Waves/](https://github.com/fians/Waves) | MIT |
| validator     | 验证库             | [https://github.com/chriso/validator.js](https://github.com/chriso/validator.js) | MIT |
| animate       | 动画               | [http://daneden.github.io/animate.css/](http://daneden.github.io/animate.css/) | MIT |
| icon          | 矢量小图标(待更新) | [https://www.iconfont.cn/](https://www.iconfont.cn/) | N/A (Free use) |


## 文件说明

* doc 项目文档文件夹，里面有数据库文件
* src/main/java java源代码
* src/main/resources 项目的资源配置文件
* src/main/webapp
* src/main/webapp/static 静态资源文件，如：js、css、image、等第三方前端插件库
* src/main/webapp/html 生成的静态页面，实际项目需要删除，只是提供给开发者快速预览生成后的静态页面
* src/main/webapp/templet 模版文件夹
* src/main/webapp/upload 上传资源文件夹
* src/main/webapp/WEB-INF/manager 后端视图页面
* LICENSE 项目协议说明
* README.md 项目说明文档
* pom.xml 依赖配置文件



## 文档

* 使用手册 <a href="https://doc.mingsoft.net/mcms/" target="_blank" rel="noopener">https://doc.mingsoft.net/mcms/ </a>
* 插件手册 <a href="https://doc.mingsoft.net/plugs/" target="_blank" rel="noopener">https://doc.mingsoft.net/plugs/ </a>
* 部署手册 <a href="https://doc.mingsoft.net/server/" target="_blank" rel="noopener">https://doc.mingsoft.net/server/ </a>

## 关于版本说明 <a href="https://www.mingsoft.net/banben.html" target="_blank" rel="noopener">更多版本查看</a>

1. 开源版本永久免费发布源代码，开发者、企业可以终身免费使用，每个月团队会收集开源系统的问题并在每月的28号进行更新；
2. 企业版本以上更新频率上更快，功能也比开源版本的要多，同时会根据不同版本提供额外插件，不同版本也会提供不同的人工在线服务（服务时间工作日 9:30-17:30）





## 铭飞MS平台

以下功能都可以在平台 <a href="https://www.mingsoft.net" target="_blank" rel="noopener">https://www.mingsoft.net</a> 上免费使用
做开源我们是业余的，写代码我们是认真的。研发产品的路上我们一直在探索、一直在学习、一直在用心投入，希望能给更多的企业与开发者提供一些更有价值的服务。

### MStore 使用模板
模版可以在线进行拖拽设计
![MStore 使用模板](https://cdn.mingsoft.net/gif/store-local.gif)

通过MStore远程安装模板
![MStore 远程安装模板](https://cdn.mingsoft.net/gif/store-remote.gif)

价值源自分享，开发者分享模板或好用的插件，让代码给开发者带来更多的自由的被动收入！

### 皮肤设计器

<a href="https://designer.mingsoft.net/" target="_blank" rel="noopener">立即体验</a>
<table>
	<tr>
		<td><img src="https://cdn.mingsoft.net/gif/designer.gif" alt="MCMS可视化皮肤设计器拖拽在线建站与网页模板设计演示" title="MCMS可视化皮肤设计器拖拽建站演示"></td>
	</tr>
</table>

### 代码生成器

<a href="https://coder.mingsoft.net/" target="_blank" rel="noopener">立即体验</a>
<table>
	<tr>
		<td><img src="https://www.mingsoft.net/upload/1/cms/content/1600746629646.gif" 
              alt="MCMS低代码平台-Java代码生成器在线配置表单与业务模型流程演示" 
              title="Java代码生成器一键配置业务表单"></td>
	</tr>
	<tr>
		<td><img src="https://www.mingsoft.net/upload/1/cms/content/1600746692814.gif" 
              alt="MCMS低代码开发-自动生成前后端解耦的Java源代码前端HTML预览" 
              title="Java代码生成器一键生成前后端源代码"></td>
	</tr>	
</table>

### 项目管理
<a href="https://pm.mingsoft.net/people/index.do" target="_blank" rel="noopener">立即体验</a>
<table>
   <tr>
      <td>
         <img src="https://www.mingsoft.net/upload/1/cms/content/1600746325257.gif" 
              alt="铭飞项目管理平台-低代码开发团队协同与研发任务指派流程演示" 
              title="项目管理团队协同与任务指派演示">
      </td>
   </tr>
   <tr>
      <td>
         <img src="https://www.mingsoft.net/upload/1/cms/content/1600746514131.gif" 
              alt="铭飞项目管理系统-项目看板、工时日志统计与任务排期日历展示" 
              title="项目管理工时统计与任务排期日历演示">
      </td>
   </tr>  
</table>

## 软件截图

<table>
    <tr>
        <td>
            <img src="https://cdn.mingsoft.net/ad/1.png" 
                 alt="MCMS后台登录界面-安全稳定的Java内容管理系统登录中心" 
                 title="MCMS内容管理系统后台登录页">
        </td>
        <td>
            <img src="https://cdn.mingsoft.net/ad/2.png" 
                 alt="MCMS系统控制台工作台-多维度数据统计看板与常用功能快捷入口" 
                 title="MCMS系统控制台工作台">
        </td>
    </tr>
    <tr>
        <td>
            <img src="https://cdn.mingsoft.net/ad/3.png"  
                 alt="MCMS插件管理与MStore本地市场-一键在线升级与扩展系统功能" 
                 title="MCMS插件商城与组件一键升级管理">
        </td>
        <td>
            <img src="https://cdn.mingsoft.net/ad/4.png" 
                 alt="MCMS多级树状栏目编辑-支持自定义模型映射与伪静态路径生成配置" 
                 title="MCMS栏目编辑与高级属性配置">
        </td>
    </tr>
    <tr>
        <td>
            <img src="https://cdn.mingsoft.net/ad/5.png" 
                 alt="MCMS全站HTML静态化管理-一键生成主页栏目文章提升SEO抓取速度" 
                 title="MCMS全站HTML静态化一键生成">
        </td>
        <td>
            <img src="https://cdn.mingsoft.net/ad/6.png" 
                 alt="MCMS文章内容发布管理-支持富文本编辑、自定义属性" 
                 title="MCMS文章发布与内容列表管理">
        </td>
    </tr>
    <tr>
        <td>
            <img src="https://cdn.mingsoft.net/ad/7.png" 
                 alt="MCMS应用全局参数设置" 
                 title="MCMS系统应用全局参数配置">
        </td>
        <td>
            <img src="https://cdn.mingsoft.net/ad/8.png" 
                 alt="MCMS模板管理-支持可视化快速建站的后台配置界面" 
                 title="MCMS模板管理">
        </td>
    </tr>
    <tr>
        <td>
            <img src="https://cdn.mingsoft.net/ad/9.png" 
                 alt="MCMS系统日志审计管理-记录管理员操作行为日志与高安全性审计" 
                 title="MCMS系统操作与行为日志审计">
        </td>
        <td>
            <img src="https://cdn.mingsoft.net/ad/10.png" 
                 alt="MCMS栏目架构管理-支持无限层级分类、隐藏显示及权限划分" 
                 title="MCMS无限层级栏目管理">
        </td>
    </tr>
</table>