KyCMS 博客版介绍与部署教程

博客集面向想创建个人博客的站长推出此开源建站系统。

简介

KyCMS 博客版是一个单二进制交付、全代码开源的博客/内容管理系统。

截图基于 极简深蓝 主题，支持第三方自定义主题。

首页

文章页

文章详情页

后端：Go (Gin + GORM + MySQL 8)

前台：Go 模板服务端渲染

管理后台：Vue 3 + TypeScript + TDesign SPA

核心：后台 SPA、站点模板、cwebp 等资源全部在编译期通过 go:embed 打包进同一个可执行文件。

部署无需拆分前后端服务、不用单独维护静态资源目录，一个二进制 + .env 即可运行；Docker Compose 可一键拉起应用 + MySQL 8.4。

多部署形态：Docker Compose / 裸机 systemd / 宝塔 / 1Panel 面板部署；附带 kycms 运维工具，支持状态查看、备份、端口修改
可自定义后台入口：ADMIN_PATH 运行时注入前端资源，修改管理路径不用重新编译；内置 reset-admin-path / reset-admin-totp 命令用于自救
安全机制：TOTP 二次验证、首次登录强制改密、会话吊销、CSRF、CSP nonce、IP 限流、审计日志、蜜罐、黑名单、Turnstile 反垃圾
内容 & SEO：文章（草稿/定时发布/置顶/回收站）、分类树、标签、独立页面、附件下载、评论审核、留言墙、友链申请、导航菜单、sitemap / RSS / JSON-LD
主题系统：内置「极简深蓝」主题，支持安装、切换第三方主题

核心程序采用 AGPL-3.0 + 主题模板附加许可。

个人自用、自建博客并私下修改，无需公开修改后的代码；若你将修改后的程序对外分发，或是以网络服务形式对外提供托管服务，则修改后的核心代码需要继续以 AGPL-3.0 开源。

第三方主题视为独立作品，可自选许可证，支持制作收费主题。

欢迎提交功能建议、缺陷反馈、代码 PR、主题开发、文档优化。

功能需求、普通 Bug：在仓库 Issue 提交；较大改动、重构建议先开 Issue 沟通方案，避免重复工作
代码提交：Pull Request 提交至 main，一个 PR 只处理一件事；提交前执行 ./scripts/ci.sh（格式化、vet、单元测试、前端类型检查与构建）
提交规范：遵循 Conventional Commits
著作权说明：不需要签署 CLA，无需转让著作权；提交即代表你的贡献以 AGPL-3.0 授权，你保留著作权，也不强制承担后续维护责任
主题开发文档：docs/THEME-API.md；架构设计文档：docs/design/；注释规范：docs/COMMENT-STYLE.md
安全漏洞：不要公开 Issue，请按 SECURITY.md 的方式私下报告

Beta 阶段最需要真实场景的试用与反馈。提一个 Issue、修正一处文档笔误、帮忙测试，都是很有价值的贡献。

beta 阶段，文档未完善，体验部署可参考：