项目源码｜铭飞 MCMS 开源内容管理系统｜Spring Boot + Vue 3 · Docker

想搭一套能改皮肤、能出静态站的内容管理系统？ CMS（Content Management System，内容管理系统）就是干这个的。 铭飞 MCMS 把栏目、文章、模板和全站 HTML 输出收进一套工程。 本机 Docker 已跑通。建议 80 积分。

4 步上手

1. 拉镜像：docker pull mingsoft/mcms:6.0.0
2. 起服务：按下文 docker run 起容器，再执行 docker exec mcms /home/start.sh
3. 登录后台：打开 /ms/login.do，账号 msopen / 密码 msopen
4. 静态化看前台：生成主页、栏目、文章后，打开 /html/web/index.html

能做什么

• 栏目与文章：树形栏目、列表/单页类型，文章可挂封面与外链
• 模板换肤：上传模板 ZIP，用标签拼页面
• 全站静态化：把动态页渲染成 HTML 文件，前台直接访问静态站
• Docker 一键：镜像内含 MySQL 与业务包，适合课设快速验收

静态化：把后台内容按模板写成静态 HTML，访问更快，也方便部署到纯静态空间。

技术栈（压缩）

• 运行：官方 Docker 镜像（内置 MySQL 5.7 + 业务 jar）；也可源码跑
• 后端：Spring Boot、MyBatis-Plus（简化数据库增删改查的持久层工具）、Shiro（登录与权限框架）
• 前台模板：Freemarker（用标签把数据填进 HTML 的模板引擎）
• 管理端：Vue 3、Element Plus
• 本机实跑入口：http://127.0.0.1:8080/ms/login.do（映射写法见下）

本机部署（已跑通）

常规有 Docker 网桥时：

docker run -d --name mcms --privileged=true \
  -e TZ=Asia/Shanghai -e MYSQL_ROOT_PASSWORD=123456 \
  -p 3316:3306 -p 8181:8080 \
  mingsoft/mcms:6.0.0 \
  --lower-case-table-names=1

docker exec mcms /home/start.sh

浏览器打开 http://localhost:8181/ms/login.do。 前台静态页在 http://localhost:8181/html/web/index.html。

Hub 拉不动时，可换镜像前缀或改走源码（JDK 17+、导入 doc 下 SQL）。 本机若端口映射无效，可临时改用 host 网络，业务口改为 8080。

验收：静态化三步

进入「内容管理 → 静态化」：

1. 选主页模板 index.htm，点生成主页
2. 点生成栏目（可先选全部）
3. 选时间范围后点生成文章

三步成功后，前台首页和栏目页才有完整内容。

实测踩坑

1. 必须进后台 /ms/login.do，别进会员中心登录页。
2. 登录后一定做静态化三步，否则前台可能空页。
3. MySQL 建议 --lower-case-table-names=1，字符集用 utf-8。
4. 改了 MYSQL_ROOT_PASSWORD，还要同步改容器内业务库连接配置。
5. 本机 Docker 无网桥时，-p 可能无效，需改 host 网络并改访问端口。

安全与合规

• 默认账号 msopen / msopen、示例库根密码 123456：公网前必须改密
• 协议为 MIT：再分发请保留版权注释与 LICENSE
• 开源版与企业版功能有差异；本文只写开源仓可跑范围
• 截图均来自本机 127.0.0.1，不是官方演示站
• 源码包可在本帖下载区获取（已去 .git，保留 LICENSE 与 DEPLOY.txt）

按上文起容器 → 登录后台 → 静态化三步 → 打开前台，一套可演示的 CMS 就验收完了。