# ChanCMS

**Repository Path**: chancms/ChanCMS

## Basic Information

- **Project Name**: ChanCMS
- **Description**: ChanCMS是一款基于Node、Express5、MySQL、Vue3研发的高质量实用型CMS系统。轻量、灵活、稳定、高性能、易扩展，让开发更简单。
- **Primary Language**: NodeJS
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://www.chancms.top
- **GVP Project**: No

## Statistics

- **Stars**: 540
- **Forks**: 186
- **Created**: 2022-12-16
- **Last Updated**: 2025-09-01

## Categories & Tags

**Categories**: cms

**Tags**: CMS, Express, Nodejs, MySQL, JavaScript

## README

# ChanCMS内容管理系统

ChanCMS是一款基于Node、Express5、MySQL、Vue3研发的高质量实用型CMS系统。轻量、灵活、稳定、高性能、易扩展，让开发更简单。

> 🌟 开发友好，推崇JS优先。适合全栈开发者，独立而高效、优雅的代码、极致的性能、稳定的生产实践，灵活强大。

## 🌈系统特色

* 自研。基于自研chanjs轻量级mvc框架实现，轻量、灵活、稳定、高性能、可持续。
* SEO。专注于`seo`,伪静态`html`和拼音导航，灵活设置关键词和描述。
* 安全。基于`knex`,高防`sql`注入，接口权限校验，为安全提供保障。
* 灵活。JSON配置按需生成页面模板数据。碎片功能，支持零碎文案配置，方便各类灵活文案配置。
* 高扩展。支持扩展模型，字段配置，可动态生成表，超强扩展。
* 模块化。一切模块相互独立，互不干扰。
* 插件化。灵活开发，支持完整功能模块。
* 无头cms，为多端（微信，app，小程序，h5）提供接口支持。

## 🚧功能介绍

* 网站信息
* 站点管理
* 栏目管理
* 文章模块
* 标签管理
* 碎片管理 (广告，碎片文案，公司地址、电话、名称，微信等万能模块)
* 扩展模型
* 文章采集
* 用户管理
* 菜单管理
* 登录日志
* 在线留言
* 中英切换
* 语音播报
* pdf预览（按需加载）
* 本地上传&七牛云上传
* 日志功能

## ⛱️软件环境

* nodejs v22.18.0
* pm2 v6.0.8

## 🛠 技术栈

| 技术 | 说明 |
|------|------|
| **Express** | 轻量级web框架  |
| **ChanJS**  | 基于Express轻量级mvc框架 |
| **Zod**     | Schema 校验库，保障数据安全 |
| **Node.js** | 运行时环境（建议 v22.18.0+） |
| **Knex.js** | SQL 查询构建器 + 迁移工具 |
| **MySQL**   | 关系型数据库 |
| **PM2**     | 生产环境进程管理与守护 |

### ✨项目架构 遵循约定优于配置 JS优先

函数式架构，模块化设计，易于扩展和重构。

```javascript
|- app
    |- helper      //工具函数
    |- common      //通用函数库(分页, 文件上传, 加密, 解密, 校验, 转换, 等)
    |- extend      //第三方组件扩展（第三方组件的扩展）
    |- middleware  //全局中间件
    |- modules     //多模块mvc
        |- api 
            |- controller 
            |- service 
            |- guard  //权限控制 (可选) 
            |- middleware  //模块中间件 (可选)
            |- model  //数据库模型 (可选)
            |- view //模板文件 (可选)
            |- router.js 
        |- base 
            |- controller 
            |- service 
            |- view 
            |- router.js
        |- cms 
            |- controller 
            |- service 
            |- view 
            |- router.js
        |- web 
            |- controller 
            |- service 
            |- view 
            |- router.js
    |- plugin //插件
        |- plus-module1 
            |- controller 
            |- service 
            |- view 
            |- router.js 
        |- module2 
            |- controller 
            |- service 
            |- view 
            |- router.js
|- config 
|- public
|- index.js
|-.env.dev
|-.env.prd
```

* **注:ChanCMS自带基于vue3+element-plus+js研发的后台管理界面,如果不满足你编码风格，如native等其它UI，或热衷于如react + antd +TS技术，可以自行调用接口进行二次开发**
* **后台管理ChanAdmin源码以及接口参考 [https://gitee.com/yanyutao0402/ChanAdmin](https://gitee.com/yanyutao0402/ChanAdmin)**

### 案例🍅️

* [北京辉达科技](http://www.huidaep.com/ )
* [北京诺丰科技](http://www.novontrade.com/ )
* [北京智慧城市供需对接平台](https://gongxudj.com/#/headerNav/newHome)
* [上海昂翊信息](http://www.angyi-iot.com/)
* [广东天波股份](https://sec.telpo.cn/)
* [广东HANSA中国](http://www.hansa-asia.com/)
* [武汉微科智汇](http://www.whwkzh.cn/)
* [浙江金卡实业](http://zjjksy.com/)
* [浙江华宇科技](http://www.kinka.net.cn/)
* [西安圣豆电子](https://www.sundaytek.com/)
* [石家庄诺德房产](https://www.nuodefangchan.com/)
* [山西蝌蚪云](https://kd-yun.top/)
* [香港日报](http://www.hongkongdaily.net/)
* [国际健康健美长寿论坛](http://www.internationjms.cn/)
* [世界大健康运动联盟](http://www.worldhealthgames.com/)
* [世界气功网](http://www.shijieqigong.com/)
* [香港大湾区](https://hk.bossyun.com/)
* [七弈国象](https://doc.7yi.link/)
* [有道IT官网](http://www.wmjtyd.net/)
<!-- * [萌狮换电](http://www.51mshd.com/) -->
<!-- * [历史人物网](https://ancestries.cn/) -->
<!-- * [同宇宙官网](http://www.zdmedia.com.cn:81/) -->
<!-- * 十 [超前端](https://zoye.top/) -->

* 演示站1 [雅俗共赏](http://www.cqsmservices.cn/)

## 👵开发文档

* **官网:<https://www.chancms.top>**
* **官网文档 <https://www.chancms.top/docs/index.html>**
* **视频教程：<https://space.bilibili.com/1885628820>**

## ❤️项目关注

* **码云：<https://gitee.com/yanyutao0402/chanyue-cms>**

## 👴项目交流

 如果喜欢我们的项目，请点个 Star。
 微信群交流请联系微信: `yanyutao2014` 🧒 👧 👱 🧔 👴,纯技术交流，广告党勿扰，谢谢合作！！！

## 许可证

本项目采用 [Apache License 2.0](LICENSE) 许可证。详情请参阅 [LICENSE](LICENSE) 文件。

## 警告

* 禁止用于任何非法商业用途或其他任何违法或不道德的行为。
* 不当使用本项目中的代码或资源而导致的任何直接或间接损失，项目维护者及贡献者概不负责。
* 请尊重法律和道德规范，合理合法地使用本项目的资源。
* 任何违反上述规定的行为都将受到法律追究。

## 管理后台部分截图

![登录](https://pic.imgdb.cn/item/6749e83fd0e0a243d4db4f12.jpg)
![board](https://pic.imgdb.cn/item/6749e83fd0e0a243d4db4f11.jpg)
![category](https://pic.imgdb.cn/item/6749e83fd0e0a243d4db4f10.jpg)
![article](https://pic.imgdb.cn/item/6749e83fd0e0a243d4db4f13.jpg)