快速上手

5 分钟上线一个真正可用的内容站

下载、运行、打开后台。数据库、模板、SEO、多语种和主题都已经装好,剩下的只是把它放到你的域名后面。

5 分钟上线一个真正可用的内容站

你现在浏览的这个站,就是一个 gcms 实例。它不是静态截图,也不是前端 Demo,而是单个静态二进制 + 一个 SQLite 数据库文件跑出来的真实站点。第一次部署只需要三步。

gcms 发布包下载页真实截图:选择平台包、校验文件与一键安装脚本

第一步 · 拿到二进制

发布页 下载对应平台的包(linux / macOS / windows,amd64 / arm64 都有),解压即可。里面已经包含预编译好的 bin/cms、启停脚本和默认配置——部署机上不需要安装 Go,也不需要跑前端构建

如果你想直接在新机器上安装,也只要一行:

curl -fsSL https://raw.githubusercontent.com/ccvar/gcms-releases/main/install.sh \
  | sh

第二步 · 运行

./bin/cms
# 或后台运行:
./scripts/cms.sh start
# → http://localhost:8080   后台 /admin

首次启动会自动建好数据库、写入演示内容,并在控制台打印默认后台账号admin / admin123)。登录后第一件事,就是去「设置 → 安全」改掉它——首页那条提醒也会一直挂着,直到你改完。

第三步 · 上线

生产环境让 gcms 只监听回环地址,把 HTTPS、压缩、HTTP/3 交给 Caddy。正式站点可以直接设为你的域名,例如 https://ccvar.com

ADDR=127.0.0.1:8080 \
BASE_URL=https://ccvar.com \
./scripts/cms.sh start
ccvar.com {
    encode zstd gzip
    reverse_proxy 127.0.0.1:8080
}

caddy run,证书自动签发。完事。

它已经替你做好了这些

上线的同时,下面这些默认就位,不用额外配置:

  • 原生 SEO:每页服务端渲染,自带 canonical、hreflang、Open Graph、sitemap.xml、RSS 与 JSON-LD 结构化数据;
  • 多语种:URL 前缀路由(/zh/…/en/…),逐语种维护内容,自动输出 hreflang 备份链接;
  • 19 套主题:后台一键切换,还能按主题微调主色与圆角;
  • 双模式编辑器:Markdown ⇄ 所见即所得,粘贴图片、插表格、拖动段落;
  • 链接展示、代码注入、社媒页脚、自定义导航、后台在线更新……

环境要求

gcms 的运行形态很轻,小规格 VPS 就能承载一个产品官网或资料站:

  • CPU:1 vCPU 即可启动和日常运行;
  • 内存:512MB 级别机器可以部署,内容量和并发升高后再按需加;
  • 磁盘:程序包很小,主要增长来自 SQLite 数据库、上传图片和日志;
  • 系统:linux、macOS、Windows 都有预编译包,支持 amd64 / arm64;
  • 公网入口:生产环境推荐 Caddy 监听 80/443,gcms 只监听 127.0.0.1:8080

换句话说,它不要求你先准备一整套数据库、缓存、前端构建和进程编排。你只需要一台能跑二进制的小机器,和一个愿意被认真维护的内容计划。

适合哪些场景

gcms 最适合那些「内容很重要,但不想把维护做重」的网站:产品官网、开源项目官网、技术文档、课程资料站、资源导航、独立博客和小团队知识库。它不是一个大型协同平台,却很适合做一个长期稳定、SEO 友好、随时能迁移的内容入口。

把复杂留在编译期,把简单交给运行时——这套架构最值钱的一句话。

为什么能这么简单

因为只有两个「单数」:Go 用 embed.FS 把模板和静态资源焊进一个二进制,SQLite 把数据库收敛成一个文件。没有独立数据库进程、没有前端构建链、没有运行时依赖。备份就是复制那个 .db,迁移就是 scp 一个文件。

五分钟,你就拥有了一个完全属于自己、能被搜索引擎完整收录、还足够好看的内容站。