为主域名确定一个清楚的页面职责
个人网站可以让主域名提供欢迎与导航，把完整博客放在子域名。这样主域名仍然有可读取的内容，访客也有明确入口进入文章。设计时先写出页面职责：欢迎文字、网站用途说明、博客链接以及需要核实后展示的公开信息。不要只放一张没有语义的背景图，也不要依赖脚本加载完以后才出现唯一导航。本文采用纯静态文档说明这种结构，演示域名与信息占位不代表真实网站数据，实际部署需要替换并完成验收。
静态首页应该真实反映当前网站用途。例如个人博客入口可以说明记录技术与项目实践，而不应为了某个展示要求填写与实际内容无关的名称。需要公开展示的信息应从真实记录核对，链接也要指向正确服务。技术上能够访问页面，并不能替代其他接入或审核结果；交付时只报告实际完成的技术检查。把页面职责与博客服务分开，可以让首页保持轻量，同时避免用看似完整但并不真实的占位内容作为正式发布页面。
两个名称分别配置解析与站点入口
主域名与博客子域名可以指向同一台服务器，但 DNS 中仍是不同名称，需要分别检查记录与地址族。代理也需要为两者建立明确站点块。主域名采用静态文件根目录，博客子域名采用反向代理目标。访问者进入哪个站点，由请求名称和代理配置共同决定，不是由 IP 是否相同决定。验证时分别请求两处，记录正文、证书和跳转行为，不能因为博客已经工作就推断主域名也具备完整入口。
如果还需要 www 入口，应明确它显示相同内容还是跳转到主域名。重定向由网站服务完成，DNS 别名只处理名称关系。主域名首页中的博客链接最好使用清楚的完整地址，避免站点迁移以后相对路径指向错误位置。子域名与主域名还可能拥有不同的会话和缓存行为，静态首页通常不需要共享后台登录状态。保持这种独立性，可以减少首页导航与管理服务之间的不必要联系，让公开页面只承担已经说明的职责。
静态文档先保证语义与可读性
页面应包含正确的语言标记、标题和视口设置，用主标题说明欢迎信息，再用普通链接提供进入博客的动作。链接文字应描述目标，键盘可以直接聚焦并激活。正文与背景要有足够对比，窄屏下内容仍能完整显示。没有 JavaScript 的访问者也应能够读取欢迎与导航，页面就不会因为脚本、框架或网络加载问题失去最核心功能。这个结构并不限制视觉设计，但需要让视觉服务于页面的实际阅读与操作。
页脚信息应保持可见和可访问，不能为了画面简洁把必要文字做成很小或接近背景颜色的装饰。若展示公开登记信息，应填写核实后的内容，并使用正确超链接，而不是把示例号码直接复制到正式页面。外部链接是否新开窗口，可以根据用户预期选择，同时保留合适的关系属性。首页不应保存密钥、内部接口或管理员账号，也不需要暴露构建版本与服务器端口；这些内容不会帮助普通访客决定如何进入博客。
文件目录与应用运行数据分开
静态首页的制品可以放在专门的站点目录中，由 Caddy 的文件服务读取。博客应用拥有自己的发布目录、上传目录和数据库，首页更新不应接触这些路径。明确分开以后，修改一段欢迎文字只需要替换静态制品，不必重新导入文章种子，也不会重建数据库。目录命名可以采用发布版本与当前入口，方便保留上一份文件并回退。管理者需要说明谁能写入制品，代理服务只获得提供文件所需的读取权限。
文件根目录应该只包含准备公开的资源。不要把项目根目录直接作为静态根，那里可能存在环境文件、备份和日志。隐藏文件是否默认可访问，不应成为保护敏感内容的唯一依赖；敏感文件本来就不应该进入公开目录。部署前检查归档成员与目录清单，确认只有页面和必要资源。若采用符号链接指向当前发布，核对链接最终目标仍属于预期站点目录，避免一个错误路径把其他项目内容暴露到首页。
代理配置保留其他站点
在已有多站点 Caddy 环境中，可以新增独立的主域名文件，再由统一主配置导入。不要为了部署静态页重新生成只包含一个站点的主文件，那会覆盖其他应用入口。先将当前站点复制到暂存配置，只替换本次文件并校验完整结果，然后按受控步骤加载。校验应覆盖文件根目录引用与实际服务权限，管理员能读取页面不代表代理账号能够读取。更新后再检查旧站点，确认共享入口仍然提供预期服务。
静态页与博客采用不同处理方式，因此检查也应不同。静态页重点是根目录、文件名、读取权限和响应资源；博客重点是上游地址、应用健康和数据连接。代理重启不是每次修改页面内容的必要动作，具体是否需要加载配置取决于本次是否改变了入口规则。把制品更新与配置更新分开，能够减少对其他站点的影响，并让回退只涉及已经改变的那一层。部署记录应说明本次更新了页面还是代理规则。
在切换之前验证候选制品
候选页面应先在本地或暂存路径检查标题、文本、链接和布局。可以读取 HTML，确认博客地址正确、页脚没有示例占位残留，再用实际浏览器检查窄屏与键盘操作。资源若保存在本地目录，还需核对引用路径和文件存在性。不要只看设计截图，截图无法证明链接有效，也不能说明辅助技术能够识别导航。静态首页的功能很少，逐项检查通常成本不高，适合在正式替换之前一次完成。
服务器上的候选配置可以通过保留目标名称的固定地址请求测试，但要明确它是否绕过了正常 DNS。确认候选文件正确以后，再替换当前入口，并立即从公开地址读取实际正文。浏览器缓存可能让旧版本继续显示，应通过响应内容与资源标识核对发布结果，而不是重复刷新猜测。没有实际访问的状态只能记为待验证。尤其是外部页脚链接，应该使用当前有效的官方入口，不应将一个已经失效的旧地址当作完成展示的证据。
独立部署也要考虑导航一致性
首页进入博客的链接、博客返回主页的入口和 www 跳转应形成一致导航。访客不能从一个入口进入以后，又被错误地跳回相同页面形成循环。链接目标需要检查协议、名称和路径，不带内部端口或开发环境地址。对于博客处于临时维护的情况，首页可以保持可访问，并清楚说明目标服务的当前状态；这种说明必须来自实际维护安排，不能长期展示未经核实的状态。页面独立只是提供一种维护选择，并不自动保证所有链接永远正常。
品牌与内容说明可以保持统一，但无需把博客应用的全部资源加载到静态页。字体、样式和小型图形应按首页所需选择，避免为一个导航入口引入大型编辑器或应用框架。若使用外部资源，应考虑它们不可达时页面仍能阅读。纯静态文档可以通过基础样式获得完整布局，核心链接保持原生行为。这里不提前提供任何加载速度结论，因为性能需要实际环境测量；设计目标是减少不必要依赖，并把关键内容放在直接返回的文档中。
回退与缓存策略保持可解释
每次更新可以保存带版本的制品目录，当前入口指向已验证版本。发现页面内容错误时，回退入口并重新读取公开响应，确认旧页面确实恢复。若更改了代理规则，则还需要校验和加载旧配置。静态资源的缓存策略应与更新方式一致：内容带明确版本的资源适合较长缓存，可变入口文档需要考虑更新及时性。不要把浏览器显示旧内容直接解释成回退失败，应同时检查服务器响应和客户端缓存条件。
保留少量可恢复版本通常足够，长期增长的备份与日志应另有规则。清理制品时只处理已经确认属于该站点的旧版本，保留当前目标与必要回退目标，不触碰博客上传数据。记录发布版本、入口切换时间和验收内容，就能把页面问题与变更对应起来。即使最终只改了一句话，也应检查它已出现在真实地址中，防止本地文件修改完成却没有进入服务器正在提供的目录。
完成验收以后再报告可访问
最终清单应包括主域名正文、博客链接、页脚公开信息、HTTPS 证书、窄屏布局和键盘操作。还要检查博客本身仍然可以访问，其他站点没有因配置更新受到影响。公开信息的真实性由真实记录核对，技术检查只确认展示与链接是否符合预期。没有完成的检查应保留清楚状态，不用一个配置成功消息代替整份验收。这样交付时可以给出真实访问链接和具体观察结果，而不是笼统报告域名已经绑定。
本文适用于主域名提供轻量入口、子域名运行博客应用的个人站点结构。若主域名本身承载动态业务，或者前置平台管理全部入口，需要调整制品与代理组织方式。独立部署的收益来自明确职责：页面文件、博客进程、数据存储与共享代理各有更新边界。保持这些边界，再用实际请求与可访问性检查收尾，欢迎页面就能成为一个长期可维护的入口，而不只是为了短期展示临时放上的空壳。
实现片段
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>欢迎来到我的个人博客</title>
</head>
<body>
<main>
<h1>欢迎来到我的个人博客</h1>
<p>记录技术、项目实践与日常思考。</p>
<nav aria-label="网站入口">
<a href="https://blog.example.com/">进入博客</a>
</nav>
</main>
<footer>在此展示经过核实的公开网站信息及对应链接。</footer>
</body>
</html>
评论 · 0