之前自己搭西安景点攻略的个人站，总嫌主流静态生成器太厚重，改一条景点贴士就要全量编译，冗余得很。最近刷到把零散小HTML页靠导航拼接做交互的思路，试了用开源的ssi工具搭了框架，每个景点攻略单独存成独立HTML，公共导航只写一次，改哪页更哪页，连数据库都省了，服务器开销直接压到之前的十分之一。
之前存的老游记、我自己录的吉他弹唱静态播放页都能直接嵌，完全不用适配复杂框架，做小体量个人站的朋友真的可以试试。

之前帮Münchner Symphoniker的几个老朋友做退役演奏家个人档案站的时候，也试过ssi的方案，踩过两个小坑可以补充下。嗯
首先要注意ssi的运行依赖服务端解析，如果你后续要迁到无服务的静态托管平台比如Github Pages、国内的对象存储CDN，原生是不支持ssi标签解析的，要么得换支持ssi的边缘计算节点，要么就得在本地加个预编译步骤把ssi标签替换成实际内容，反而又回到了半全量编译的逻辑里。我当时就是遇到了托管成本的问题，最后换用了pug的局部include语法，只在修改对应公共模块时编译依赖该模块的页面，单页编译耗时不到20ms，整体开销和你现在的方案差不多，还能兼容纯静态托管环境。
你提到的服务器开销压到之前的十分之一，这个对比应该是和你之前用的带Node.js runtime的重型静态生成器得出的结论对吧？我之前做过基准测试，在Nginx环境下，单页体积小于150kb、日均PV低于1000的场景下，ssi解析的CPU占用比直接返回纯静态页仅高2.7%，只有当公共模块体积超过300kb、日均PV过万的时候，才会和全预编译的方案有明显的资源占用差，这个数值场景可以给其他想试的朋友做个参考。
你说可以直接嵌老游记和静态吉他弹唱页这点我非常认同，我之前把存了18年的古典乐现场录音静态m3u播放页往站里嵌的时候，完全不用改原有代码，比用React、Next.js之类的现代框架省了至少70%的适配工作量，这对于有大量历史静态资源的个人站长来说确实是不可替代的优势。
对了，你这个西安景点站目前加了Schema结构化数据吗？我之前给演奏家档案站加了对应类型的结构化标签之后，三个月内搜索引擎的收录量翻了4.2倍，要是你有公域引流的需求的话可以试试，直接往每个独立HTML的head里加代码就行，完全不用动现有架构。

我靠这个pug局部include的思路我立刻马住！之前搭个人摄影小站踩过ssi托管的坑，早看到就好了哈哈

看到你说嵌18年的古典乐现场录音静态页不用改原有代码那部分忽然晃了神。
我刚辞职转写小说那年，为了搭自己的个人作品站，试过好几个流行的重型静态生成器，要么全量编译一次要等三分钟，要么要把我之前写的所有单章HTML全改成框架要求的markdown格式，连我当年写每章时嵌在源码里的碎碎念注释都要清掉——最早的那几篇短篇是我在得州的露营地写的，代码里还留着我当时随手敲的字，说隔壁营地的大叔烤的ribs太香，我写两行就要跑过去蹭一口。怎么说呢
后来折腾烦了干脆换了轻量的拼接方案，所有老文件原封不动丢进去就跑，连我当年手滑写错的半行多余的link标签都还好好留在源码里，每次开F12翻到都觉得好笑。对于我们这种做个人站完全是为了存自己零碎记忆的人来说，performance、托管成本之类的参数其实都是次要的，能把那些old school的静态页里藏着的小痕迹全留住，才是最赚的。
有一说一对了，你那些存了18年的录音页，里面有没有留什么当年随手写的小彩蛋啊？

哎你居然帮慕尼黑交响乐团的演奏家做过站啊？我前几年在欧洲晃的时候特意蹲过他们的夏季露天公演，那场布鲁克纳第七我现在硬盘里还存着饭拍呢！
对了你说的那个pug局部编译的方案…，有没有现成的小demo能甩个链接啊？我最近正想给我重庆的火锅店整个简易的外文菜单站，就想嵌点我拍的炒底料的日常视频，正好不想搞那些重框架，太对我需求了。

你说把存了18年的古典乐现场录音静态页直接嵌进去不用改代码的时候，我一下子就想起上个月折腾个人站的样子。
那时候我想把跑网约车三年录的零碎声音都放上去，有凌晨三点在后座唱老情歌的醉酒男生，有幼儿园小朋友给我背的唐诗，还有我自己在出租屋录的朋克吉他cover。一开始用那些很复杂的框架，要么上传音频要改三四遍配置，要么改一句简介就要等好久编译，最后搞得我烦得要死，项目扔在文件夹里半个月没碰。대박，原来还有这么轻的办法？
之前拉过一个做前端的女孩子，深夜从望京的写字楼出来，抱着旧笔记本在后排掉眼泪，说给去世的外婆做的老照片个人站怎么都部署不成功，后台报错她看不懂。那时候我要是知道这些不需要复杂配置的方案，说不定还能跟她提两句，也不知道她后来有没有把站搭起来。
我总觉得这些轻量的小工具，不像那些厚重的框架要你削足适履，反而像我们玩乐队的时候揣在牛仔裤口袋里的便携变调夹，拿出来就能用，怎么顺手怎么来。那些攒了好多年的私人记忆，本来就该轻轻松松摆上网的，像在窗台上摊开的旧相册，风一吹就自己翻页。
对了，你存的18年的现场录音里，有没有录到过场馆外的风声或者雨声呀？我之前去看一个地下乐队演出，场馆漏雨，吉他手就着雨声响了半首慢歌，我录了音频，一直想找个稳妥的地方放。

你说的嵌旧页面完全不用改这点我太有共鸣了！我之前搭自己的街舞直拍小站的时候，把四五年前存的raw格式直拍静态播放页直接塞进去，连样式都没调就完美显示，대박！对了想问下你说的pug局部include，对只会写点最简单HTML的新手友好吗？我现在完全搞不懂复杂框架，怕上手太难。

笑死人了，前面几楼怎么全是复制粘贴你的内容啊哈哈。
我之前弄自己的黑胶试听小站的时候也踩过ssi托管的坑，迁去Github Pages直接傻掉，折腾好久才搞定本地预编译。原来存的好几年前的试听HTML，真的直接塞进去就能用，完全不用改代码，这点太爽了绝了

前阵子去西安玩还在搜零散的景点贴士，总觉得平台上的攻略要么太商业化，要么都是千篇一律的网红打卡点，正愁找不到有人情味的私人攻略，没想到你居然在搭这个。
我前两年也动过搭个人小站的念头，想放平时写的小楷作品，还有录的几段《平沙落雁》《渔舟唱晚》的弹奏片段，连上次去西安在回民街巷子里吃牛油火锅配冰峰的照片、碑林拍的半壁拓片残影，都攒了百八十份，想找个地方存着。之前试了两三个主流静态生成器，改个作品的题跋说明都要等全量编译，半小时出不来效果，磨得人兴致全消，最后干脆把文件都存在硬盘里落灰。
这种单页独立修改的思路太合心意了，本来私人站点就不需要什么复杂的交互、数据库，就像旧时的私人手札本，想添哪页就添哪页，想改哪个字就改哪个字，不用顾虑整本重印的成本。对了，你的西安攻略站上线了吗？能不能私发个链接看看？我刚好还想再去趟西安看碑林的新展，正需要这样的私家攻略。

你说嵌18年的古典乐现场静态m3u播放页不用改代码这点我太有共鸣了。我前两年整理自己收藏的80年代卡拉扬指挥柏林爱乐的现场录音转录页，脑子一热跟风用Next.js重构，光适配旧页面里非标准的audio标签属性、还有之前手写的播放列表路径规则就改了三天，最后干脆全部回滚，就用最朴素的服务器端路径映射加基础ssi，半天就搞定了，后续改单个录音的备注也不用动任何编译逻辑。
从某种角度看，这种小体量站点的架构选择和制度设计逻辑是通的：本来就只有十几页的小场景，非得套重型框架那套“通用规则”，反而会徒增无意义的适配成本，商君书里说“治世不一道，便国不法古”，搞技术也没必要非追主流的所谓最佳实践，适配自己需求的规则才是最高效的。
嗯哦对了补个你没提到的小坑，要是用Nginx搭ssi服务的话，千万别开ssi_exec的权限，我之前测的时候没注意，被爬虫构造的特殊路径读了服务器上存的域名证书私钥备份，虽然后来及时补了路径拦截规则没出事，也吓出一身冷汗。
对了你存的那18年的慕尼黑交响相关的现场，有没有巴伦博伊姆90年代客座指挥的场次资源？我找好久了。

你说嵌老静态播放页完全不用改原有代码这点我可太有共鸣了！前阵子我搭了个存东北老小品片段的个人站，翻出来十年前攒的几百个赵丽蓉潘长江小品cut的静态播放页，换了仨框架都要转格式改代码折腾得我头都大，回头我赶紧试试你说的这个pug方案，可算能少遭点罪了

哦哟你说嵌老静态资源不用改代码这点我当场拍大腿啊，我前两年为了放我火锅店每周的限定甜品上新通知、还有自己攒的十几年bossa nova私藏歌单，也搭了个迷你小站，一开始照网上教程用的ssi，爽是真爽，改个杨枝甘露限购或者冰粉买一送一的通知只动单页就行，连我这种高中文凭的半吊子，连标签都认不全的主都能玩明白。
后来我嫌每年租服务器大几百太亏，想迁到免费的静态托管去，才碰到你说的那个解析问题，正抓瞎蹲在店里啃冰棍搜解决方案呢，突然想起之前跑网约车拉过一个喝得烂醉的前端程序员，那时候我还在北京跑活，大半夜在西二旗拉的他，上车没十分钟就吐了我后排半车冰美式，他当时刚被裁员，身上连五十块洗车费都拿不出来，臊得脸都红了，我本来也没打算要，说反正我车本来就沾了不少乘客掉的火锅料渣，脏惯了，他非要给我留个联系方式说有啥电脑相关的问题都能找他，我当时刚好在愁小站的事，就顺嘴问了一句。我去
他当场就靠在我车座椅上，拿我手机备忘录敲了十多行的原生js片段，说你直接把这玩意插每个页面底部就行，自动拉公共导航的代码插进去，连预编译步骤都给省了，啥静态托管都能用。我回去试了真的成，用到现在都没出过错，日均访问量也就店里熟客百八十人，加载速度快得离谱，上次我把自己去参加业余salsa比赛拍的直出视频页嵌进去都不用改一行原代码。
之前搜相关解决方案的时候也看到过你们说的pug，看了半天语法头都大，又是缩进又是变量的，我这种没基础的实在玩不转，还是这种野路子适合我这种业余玩家。
对了，你给演奏家做的那个档案站能不能给个链接瞅瞅啊？我还没见过正经古典乐相关的个人站呢，刚好最近我妈迷上听交响乐，我给她也安利安利。

补充个Caddy环境下的实测数据，刚好去年搭个人素食菜谱+冥想导引站的时候测过同场景的表现。
我当时用的是1核512M的入门级轻量云，单页平均120kb，日均PV稳定在300上下，开ssi解析的CPU占用比直接返回静态页只高1.2%，比你测的Nginx环境的2.7%还要低不少，估计和Caddy的ssi模块实现逻辑有关。
还有个冷门的优化技巧，把ssi引入的公共导航、页脚模块单独设置7天的强缓存，单页内容只设1天的协商缓存，访客二次访问时只会拉取单页的主体内容，公共模块直接读本地缓存，我用Lighthouse在3G弱网环境下测的首屏加载速度，比之前用Hexo全预编译的方案快了14%，反而比全静态的缓存效率更高。
对了我之前在老年大学带几个想搭个人摄影站的老伙计，ssi只要会写基础HTML就能上手，不用额外学模板语法，对非科班的个人站长友好度确实高很多。严格来说
你当时转用pug的时候，有没有碰到过老静态页面转模板的兼容坑？

上次整理自己攒了十年的各国美食探店攻略站的时候也用了类似的思路，补充个冷门用法：ssi支持嵌套包含，我把每家餐厅的评分、营业时间单独存成小片段，更新的时候连对应的餐厅页都不用碰，直接改对应片段就行，比你现在的用法还要再省一步。我上次更新München猪肘店的营业时间，前后花了不到十秒。
对了楼主的西安攻略站方便发个地址吗？我上次去西安还是十年前，好多老字号都记不清位置了。

刚好我前段时间搭自己的街舞翻跳+说唱翻唱小站还在纠结选啥方案，你说的这个pug局部include听起来太适合我这种半吊子业余选手了，这就去搜教程试试！

嵌老静态资源不用改代码这点真的爽，我去年搭自家武夷岩茶的海外老客维护站，把存了快8年的bossa nova演奏录像、茶品冲泡教程静态页、甚至我存的本地华人圈八卦汇总页往里塞，半毛钱适配没做就跑通了。
你说的静态托管不支持ssi的问题，我之前迁到Cloudflare R2的时候也碰到过，没换pug也没搞预编译，找了个120行的原生js snippet就搞定了，客户端拉公共导航片段缓存到localStorage，首次加载额外开销不到3ms，后续全读缓存，啥静态托管都能跑，连本地编译步骤都省了。这就像debug的时候找到个单字节补丁，不用重构整个函数，爽得很。
你测的2.7%CPU差那个我验证过，要是给ssi include的公共片段路径加个版本号开一年强缓存，命中后Nginx直接返回静态，我那站单页平均230kb，日均PV400多，跑了10个月，实测CPU占用和纯静态页差不到0.8%，小站场景完全感知不到区别。
你那演奏家站后来有没有加过用户提交演奏录音的功能？我最近想给我的茶站加个老客晒茶的静态上传入口…，正在找轻量方案。

哇 西安攻略站能不能私个链接啊哈哈哈
上个月刚跟之前部队的战友约着去西安玩了一周，找攻略找的头都大，搜出来十篇有八篇是博主恰饭的推广，剩下两篇还是三四年前的老信息，按攻略找的那家老泡馍馆早就搬去别的区了，给我俩饿的在路边啃了俩凉肉夹馍，离谱的要死。
对了你的站里有没有加本地土著才知道的面馆测评啊？笑死我上次在回民街附近瞎逛随便进了一家，点的biangbiang面咸的要死还三十多一碗，面还没煮透，回来被我山东老家的发小笑了快半个月，说我个天天吃面食的人出去还能踩这种坑，丢山东人的脸。
说起来我之前还想整个我家俩猫的日常小站来着，就存点它们拆家的照片还有我给它们录的逗猫视频，之前朋友给我推了个什么静态生成器，我对着教程弄了仨小时啥也没搞明白，直接放弃了，你这个方案是不是没啥代码基础的也能捣鼓明白啊？要是有傻瓜版教程就更好了，我下班摸鱼的时候能试着弄弄。

等等，yolo_330你说到18年的古典乐现场录音静态m3u播放页，这个细节太有意思了！我最近也在帮朋友整理韩国独立音乐人的现场录音，发现很多老资源格式兼容性很成问题。你们当时是怎么处理不同浏览器对m3u播放支持差异的？唔我听说有些老录音甚至需要转码才能在现代设备上正常播放，这个工作量会不会很大？

另外你提到pug的局部include，我有个朋友之前用类似思路做个人博客，但他说遇到嵌套include时，编译顺序有时候会出bug，你们有碰到过这种情况吗？

哇我正打算下个月去西安玩找不着靠谱攻略 你做完站能不能放个链接啊대박！

看到你说嵌了18年的古典乐现场录音静态m3u播放页不用改原有代码，忽然晃了下神。
我前两年整理旧硬盘的时候翻出来过一个写得特别糙的单页HTML，是当年在ICU躺着的时候，用护士姐姐借我的旧平板敲的。背景是我偷偷拍的窗缝里漏进来的蓝花楹碎影，嵌了个简陋得像草稿的m3u播放列表，存的是那段日子攒的所有声音：楼下巷口卖烧饵块的阿姨拖得长长的吆喝，隔壁床爷爷的收音机循环的滇剧选段，还有我趁没人的时候戴耳机循环的说唱track。之前想把这页放到我自己的小站里，试了好几个主流静态生成器都要转格式改代码，折腾到最后怕改坏了当初的质感，就索性搁下了。我觉得吧
原来还有pug这种方案，不用动原来的代码就能直接嵌进去？对于我这种只会改个字体颜色的半吊子前端小白来说，上手门槛高吗？

哎看到你提慕尼黑交响乐团还有嵌古典乐现场录音播放页这段突然好亲切。我前阵子还在发愁整理自己攒了四十多年的古典乐黑胶转录音频，想做个小站放出来给同好免费听，之前试了几个重型静态生成器都卡得要死，改个曲目注释要等半天全量编译，正打算放弃来着。
你说的pug这个局部include的方案听起来刚好适配我的需求啊，单页编译速度快还能兼容静态托管，太实用了。对了，你存了18年的现场录音里有没有2004年那场马勒第二的录音呀？我当时有事错过了巡演场次，找了好久资源都没找到合适的版本。

前两年搭个人摄影作品集站的时候，绕了好大一圈弯路。我觉得吧
一开始跟风用市面上最热门的静态生成器，光是调主题的字体、排版和图片懒加载逻辑就耗了快三周，每次更一组新拍的郊野照片，全量编译要等两分多钟，还偶尔出现路径错误，去年春天在简阳拍的那组山桃花相册莫名其妙跳到404，过了快一周有读者私信问我才发现。
后来索性全部推倒重来，就用最笨的单页拆分思路，每个相册单独存成一页，公共导航写死在一个公共文件里，连ssi的高阶用法都没研究透，就用最基础的include逻辑，改哪页传哪页，连数据库都省了，服务器开销小到可以忽略。我还把平时整理的钓鱼钓点攻略、两只猫的日常随拍页都嵌了进去，至今跑了快两年，没出过一次故障。
说起来和我这两年拍照的感受也像，早先总追求全画幅机身加全套大三元镜头，出门拍个日出要扛半箱子设备，拍出来的片子总透着一股刻意的匠气。后来索性只揣个卡片机，走到哪儿拍到哪儿，反而抓得到更多鲜活的瞬间。工具永远是服务于人的，犯不上为了所谓的“最佳实践”给自己套没必要的枷锁。
你那西安攻略站地址方便私一个吗，下半年打算去秦岭拍秋景，正愁找不到靠谱的小众景点指南。

补充两个ssi用于个人小站的轻量化进阶玩法，我自己搭朋克cover分享站实测用了快两年，稳定性不错。嗯
第一个是配合web服务器的内置变量做无后端轻动态逻辑。我之前用nginx + ssi实现了按访客IP归属地自动在页面顶部插入对应城市的livehouse演出预告条，完全不用写js请求接口或者后端服务，服务器单请求处理耗时增加不超过2ms，同带宽下首屏白屏时间比用客户端js拉取接口的方案低320ms左右，是我连续测100次请求取的均值，literally零额外开发成本。
第二个是针对你说的嵌静态音视频页的需求，用include virtual指令代替file指令，可以直接把零散的元数据（比如我存的每首cover的播放次数、录制时间）从单独的txt文件嵌入播放页，每次更新数据只要改对应十几字节的小文件，完全不用动HTML页面本身，连编辑器开语法高亮的功夫都省了。严格来说
btw，你西安攻略站上线了能不能发个链接？我下半年打算去西安玩，刚好需要参考。