前言
做技术内容的人大概率都纠结过同一个问题：内容发在哪？
第三方平台抽成高、规则说变就变、粉丝和数据都不是自己的；自己搭一个又怕工作量劝退。我前阵子还是自己动手搭了一个，成品已经上线——优享（UO4Share，uo4.com），一个支持「文章/教程 + 可下载资源」双形态的数字内容分享平台。
这篇文章不吹产品，而是复盘它背后的技术架构和几个关键设计决策。如果你也在考虑自己搭类似的东西，下面的取舍应该能帮你少走弯路。
一、技术选型：为什么是 Go + Gin + 服务端渲染
平台的技术栈很克制：
- Go + Gin 做 Web 框架；
- html/template 服务端模板渲染（SSR），不是 SPA；
- MySQL 存内容、用户、订单；
- 前端基本是原生 JS + CSS，没有引入重型框架。
为什么不跟风上 React/Vue 全量 SPA？因为这是一个内容站，两个硬需求决定了选型：
- SEO：搜索引擎要能直接抓到文章正文。服务端直出 HTML，爬虫拿到就是完整内容；SPA 还得等 JS 跑完，很多场景抓不全。
- 首屏与运维：内容站首屏要快、服务器要省。直出 HTML 没有前端构建链路，部署就是一个二进制 + 模板文件，维护成本极低。
Gin 的 ParseGlob 一次性加载模板，路由按内容类型分发，整个后端就一个可执行文件。对单人维护的项目，这种"能跑、好改、易部署"的属性比技术时髦重要得多。
二、内容模型：一篇文章，三种渲染模板
平台里的内容分两类：免费文章（教程、资讯）和付费资源（软件、源码包、音视频）。它们共用一套底层模型，但渲染方式不同。
设计上我用了一个 categories.template 字段来控制详情页模板：
default → 标准图文详情（detail.html）
document → 长文档阅读页（detail-document.html，适合教程）
audio → 音频/视频资源页（detail-audio.html）
后端路由根据分类的 template 字段选模板，而不是写死在代码里。这样新增一种内容形态，只加一个模板文件、改一条分类配置，不动核心逻辑。
分类本身也带元数据——比如每个分类有一个主题色，首页列表和详情页的标签徽章直接复用后台配置的颜色，而不是前端写死。这个细节让运营改版配色时不用动代码。
三、资源交付闭环：付费下载怎么落地
免费内容直接看；付费资源要走「下单 → 支付 → 授权下载」的闭环。
支付接的是聚合支付网关（微信 / 支付宝统一收单），关键不在"接上"，而在回调验签：
// 支付结果异步回调（伪代码）
func paymentNotify(c *gin.Context) {
params := c.Request.Form
if !gateway.VerifySign(params, secret) { // 必须验签
c.String(400, "sign fail")
return
}
order := loadOrder(params.Get("out_trade_no"))
if order.Status == Paid { c.String(200, "OK"); return }
// 落库：标记订单已支付 + 给用户开通下载权限（事务）
withTx(func(tx) {
order.markPaid()
user.grantDownload(order.ItemID)
})
c.String(200, gateway.SuccessEcho)
}
这里有几个容易踩的坑，我在下面单独讲。
四、几个工程决策
1. SSR 直出 + 结构化数据
内容站除了正文直出，我顺手补了 JSON-LD 结构化数据（文章标题、作者、发布时间），让搜索引擎更准地理解页面。这是内容站 SEO 性价比最高的一笔投入。
2. 付费文件不能放公开目录
早期付费资源直接丢在 Web 可访问的 uploads/ 目录，结果被人拿到直链后绕过支付无限下载。正确做法是：付费文件存私有目录，下载走鉴权接口——接口校验"该用户对此资源是否有有效授权"，再流式返回文件，同时做限流和防盗链（Referer / 临时令牌）。
3. 评论互动的 XSS 防护
用户评论是 UGC，直接渲染必然有 XSS。正文用 Markdown 渲染，但评论做了输入过滤 + 输出转义，富文本内容只允许白名单标签。这一步不能省。
4. 阅读体验的细节
详情页参考了 Flarum 的体验：右侧一个"阅读进度 / 楼层导航"的 scrubber，长文档里能快速跳到楼主帖或最新评论；首页列表做了摘要截断和分类色徽章。这类交互纯原生 JS 就能做，不值得为它引入框架。
五、踩过的坑（安全向，最值得记一笔）
自己搭付费平台，安全是底线，这几条是我实打实交过学费的：
- 支付回调必须验签：没有验签的回调等于"谁都能伪造支付成功"。早期我用过本地 mock 回调调试，上线前务必删干净并换成真实验签，否则接口被刷只是时间问题。
- 付费文件隔离存储：如上，公开目录 + 直链 = 形同免费。授权下载一定要过接口。
- 余额/支付要走事务：用户充值、扣余额、开通权限，这几步必须在一个数据库事务里，否则中途失败会出现"钱扣了权限没开"或反过来。
- 别留直充后门：调试时图方便加的"直接改余额"的内部接口，上线后就是定时炸弹，必须删。
这些坑单独看都简单，但任何一个漏掉，平台上线后都是资损或数据事故。
六、小结
搭一个自己的数字内容 + 资源分享平台，技术难度没有想象中高：Go + Gin + 服务端渲染就能撑起核心，真正要花心思的是支付闭环的严谨性和付费资源的安全隔离。
成品已经跑在线上：优享（UO4Share）https://www.uo4.com —— 一个软件 / 源码 / 文档 / 音视频的数字资源分享平台，目前既有免费技术教程，也有付费资源。如果你也在犹豫要不要自己搭，可以先去逛一圈，对照上面的架构看看哪些能直接复用。
下一篇可以聊聊它的 SEO 优化和索引提速，感兴趣的同学评论区告诉我。