产品官网还在原来的前端框架上,博客却零散、更新困难,帮助文档又放在另一套系统或另一个域名里,搜索引擎几乎抓不到,市场同学也不能自己发教程、改文档。这类问题常被当成「再多写几篇博客」或「把整个产品站重做成 WordPress」。现场更常见的是:文档和主站不在同一域名下,抓取入口断裂、权重分散;即便已经打算用 WordPress 做内容中心,也没先核清是挂在子目录并用反向代理与主站统一域名,还是另开了一个子域。还没有看清域名、路径和反向代理之前,不要先改主题,不要先把文档整站搬到新域名,更不要先堆一批互不关联的文章。
这和已经写过的「内容站主题很好看、栏目空或深层搜不到」(已发 11-17-2000)不是一类起点:那篇处理的是内容站已经在 WordPress 里时,栏目架构、分页和主题 / SEO 配置为什么让深层页搜不到;本文的起点是帮助文档还在另一套系统里,或内容中心和主站域名是分裂的。也要和「发布很久仍不被收录」(已发 11-08)分开:那是站点可见性、robots 与 noindex;本文即使主站可以被抓,文档只要还在外站或反向代理没通,依然几乎搜不到。和「询盘跟进不及时或投放渠道对不上」(已发 11-16-0900)、「搜索标题错乱或两个 SEO 插件互相覆盖」(已发 11-15-1400)也要分开,那些是线索归因或标题模板问题;本文先要分清是「文档根本不在统一域名下」,还是「域名已经统一,但没有支柱页和统一模板」。还没有看清子目录、反向代理和支柱页之前,不要先把问题写成「主题选错了」或「再投一波广告」。
更稳的顺序是:先分清是「文档在外站或外系统」「子目录或反向代理没通」「没有支柱页和内链」「模板不统一,市场没法持续发布」→ 先核内容中心是否部署在子目录、反向代理是否与主站统一域名 → 再查支柱页、文档模板和转化入口 → 最后做验收和回滚。别一上来同时改主题、另开子域、批量搬家和清全站缓存。帮助文档搜不到,常常不是「再写几篇就能好」,验收只能证明「卡在哪一处、能不能讲清、能不能按原路径恢复」,而不是把产品官网整站推倒重来。
先分清:文档在外站 / 反向代理没通 / 没有支柱页 / 模板不统一
「帮助文档放在另一系统几乎搜不到」至少有四条岔路,混着改容易把域名分裂和主题、SEO 插件问题一起返工:
- 帮助文档还在另一套系统,或内容中心开在独立子域 :产品官网、博客、文档各走各的域名,搜索引擎要分别发现入口,权重也无法集中。只在主站加几篇博客,说明不了文档为什么抓不到。另开
docs子域看起来干净,却常常让文档站变成一个几乎没有外链和权的新站点。 - 已经打算把 WordPress 内容中心挂在子目录,但反向代理或站点地址没核清 :路径前缀、回源 Host、HTTPS 和
X-Forwarded-Proto、尾斜杠任意一处对不上,就会出现子目录 404、后台进不去、静态资源裂图或预览页跑偏。这和「主站没被收录」不是同一句话。 - 域名已经统一,但文章互不关联,没有支柱页:教程、对比、文档和客户故事各发各的,没有围绕产品核心场景建成支柱页,也没有让每篇文章至少挂到一个支柱页。收录了也是一盘散沙,用户从一篇教程进站后找不到完整路径。
- 模板不统一,市场团队无法独立发布:没有固定的教程、对比、文档模板,每发一篇都要找开发改版式,内容中心很快又停更。这时应先收敛模板,而不是先换主题或先上新的编辑器。
先记下:文档当前是独立系统、独立域名,还是已经准备挂到主站子目录;反向代理有没有把同一域名下的路径回源到 WordPress;WordPress 的站点地址是否写成带路径前缀的地址;有没有支柱页和统一模板;产品官网是否仍保持原技术栈。明确这是 文档与主站是否同一域名、子目录反向代理是否通、支柱页是否立得住,不是内容站主题架构专文,不是 robots / noindex 专文,也不是询盘归因或 SEO 标题冲突专文。

第一步:定界 ------ 这次卡在域名、代理还是结构
不要先把整个产品站重做,更不要先另开一个文档域名再批量搬家。先把边界看清楚:
- 先看文档现在住在哪,而不是先改主题:打开一篇典型帮助文档和一篇产品页,对比主机名和路径。是另一个系统、另一个子域,还是已经在主站某个子目录下。把当前 URL 记下来。
- 再看搜索引擎能不能从主站走到文档:主站有没有指向文档的稳定入口;文档页是 200 还是要跳到外域;是不是只有登录后才看得到。抓不到的前提,往往是入口根本不在同一域名下。
- 若已经在做 WordPress 内容中心,先核子目录计划,而不是先选主题 :计划挂在
/docs/、/blog/还是别的前缀;反向代理有没有配;WordPress 自己的站点地址有没有写成带这个前缀的地址。 - 再看内容是不是一盘散沙:有没有按产品核心场景建立支柱页;教程、对比评测、文档和客户故事会不会至少挂到其中一个支柱页。没有支柱页时,不要先把锅扣给「关键词没选对」。
- 有没有并行改动:同一窗口里有没有既改反向代理,又改站点地址,还换主题、开缓存插件。并行改动会让对比和回滚都失真。
预期:能一句话说清「是文档还在外站、子目录反向代理没通、没有支柱页,还是模板不统一导致发不出来」;并确认不是内容站主题架构专文,不是 robots / noindex 专文,也不是线索归因专文。
第二步:先核子目录与反向代理,把主站和文档放回同一域名
定界之后,先让「文档是不是和主站在同一域名下、子目录能不能稳定打开」清楚,再谈支柱页和模板:
- 产品官网可以保持原技术栈,内容中心单独用 WordPress:没有必要先把整个产品站重做。更稳的是把内容中心部署在主站子目录,通过反向代理与主站统一域名,让抓取和权重留在同一主机名下。
- 先把路径前缀写成同一套,而不是先改主题 :反向代理的路径、WordPress 的站点地址、固定链接和内部链接,都要落在同一个前缀上,例如都是
/docs/。只改了服务器规则、没改站点地址,或只改了站点地址、代理还在根路径回源,都会出现前台能开、后台打不开,或反过来。 - 反向代理要把协议和主机名传对 :核回源 Host、HTTPS 与
X-Forwarded-Proto、尾斜杠是否被来回跳。协议传错时,后台和预览页会在 HTTP / HTTPS 之间循环,或出现混合内容。路径多一次或少一次斜杠,看起来像「子目录 404」,其实是规则没对齐。 - 缓存不要误伤 wp-admin、登录态和预览页:页面缓存、CDN 和反向代理缓存都要排除后台、预览和带登录 Cookie 的请求。内容中心刚挂上就把全部 HTML 缓存,常见后果是编辑看到旧页、未登录用户看到别人的预览。
- 在 DEVDIY 这类内容站验收里,更常见的是先把「同一域名 + 子目录反向代理」写清楚,再决定迁哪些文档:先确认主站打开子目录是 200、静态资源不裂、后台可登录,再分批把帮助文档迁到内容中心。不要先另开子域「看起来隔离」,也不要一次搬完再回头查代理。
涉及帮助文档放在另一系统几乎搜不到、要先核子目录与反向代理再查支柱页时,可对照 帮助文档放在另一系统搜不到时,应先把内容中心放到子目录并用反向代理统一域名,再围绕场景建支柱页 把「文档是否还在外站、内容中心是否挂在子目录、反向代理和站点地址是否同一前缀、产品官网是否不必整站重做」从清单里单独勾掉:先让同一域名可访问、代理可复测,再去建支柱页和统一模板------顺序反了,主题和文章都换过之后仍然说不清为什么文档站还是搜不到。
预期:当前样本已经能说明文档或内容中心是否与主站同一域名、子目录反向代理是否通;还没有把问题扩大成同时另开子域、整站重做产品官网和清空全部缓存规则。
第三步:再查支柱页、模板与转化入口
同一域名和子目录稳定之后,再处理「页面能打开,但内容仍像一盘散沙」以及「市场没法独立更新」:
- 先围绕产品核心场景建支柱页,而不是先堆单篇教程:每个核心场景有一个能独立讲清楚的支柱页,下面再挂教程、模板、对比评测和客户故事。所有文章至少关联一个支柱页,形成可走的内链,而不是只靠标签云。
- 模板先统一,再追求文笔:教程用「问题 → 结论 → 步骤 → 常见问题」,对比页用维度列表和适用场景,文档页要有目录、版本标注和反馈入口。模板统一,是市场团队能持续发布的下限,也避免每篇都找开发改版式。
- 按页面意图放转化入口,但不要把本文写成线索归因专文:教程可引导下载或继续阅读支柱页,对比页可引导预约,文档页可引导试用。表单只要能带上来源文章即可,来源追踪和 CRM 同步不是本篇的主线。
- 帮助文档要按可收录的 HTML 发布,而不是继续锁在外系统里:文档迁入内容中心后,应能不登录打开、能被内链到达、能进入站点地图里该进的那一类。还留在需登录的外系统里,搜索引擎仍然抓不到。
- 选题优先来自一线问题,而不是先做一份纯关键词清单:销售和客服反复被问到的步骤、对比和排障,做成教程或文档后,比先堆一批互不关联的热词页更容易形成完整路径。
预期:能指出问题主要来自外站域名、反向代理,还是支柱页和模板;同一域名下已经有可说明的支柱结构和统一模板;没有为了「先上线几篇」又把文档留在外系统,或把产品官网整站推倒。

第四步:验收与回滚
- 用未登录的浏览器打开主站上的内容中心入口,确认子目录或文档页返回 200,主机名与主站一致,不会跳到外域。
- 抽查一篇文档、一篇教程和一篇支柱页:内链可互达,静态资源不裂,移动端主内容可阅读。
- 用编辑账号登录 wp-admin,确认后台可进、预览正常;再清一次仅针对该路径的缓存,未登录复查仍是同一内容。
- 若改过反向代理或站点地址,核对路径前缀、
X-Forwarded-Proto和缓存排除项与清单一致;wp-admin 和预览页没有被缓存。 - 若已开始迁文档,确认是分批迁移,并且外系统下线前,旧文档 URL 有可回滚或可跳转的安排。不要在代理未通时一次切光全部文档入口。
回滚点:改反向代理、站点地址或固定链接之前,先备份当前配置并记下原值;迁文档之前,先保留外系统的只读入口。不要在同一窗口里同时改代理规则、改站点地址、换主题和清全站缓存。
验证
- 能说明文档几乎搜不到,是来自外站或外系统、子目录反向代理未通,还是没有支柱页和统一模板。
- 主站同一域名下的内容中心入口可打开,反向代理与站点地址前缀一致,后台和预览可用。
- 支柱页能到达所属教程或文档,模板可复用,市场同学能按模板发布,而不必先找开发改版式。
- 复查 24h:子目录没有被缓存或新的代理规则改回外域跳转,分批迁移的文档入口仍然可访问。
常见坑
- 一发现文档搜不到,就先另开一个文档子域,结果主站权重带不过去,文档站仍然几乎没有收录。
- 只配了反向代理,没改 WordPress 站点地址,或只改了站点地址、代理路径还对不上,子目录和后台只有一处能开。
- 把全部 HTML 都缓存掉,编辑预览和未登录访问看到的不是同一页。
- 还没核清同一域名,就先换主题、先做视觉,内容中心仍然挂在外系统。
- 文档迁进来了,但没有支柱页,也没有统一模板,发了几篇后又要找开发改版,很快停更。
- 把「主站没被收录」和「文档在外站抓不到」当成同一句话,反复改 robots,却不看域名和反向代理。
按照「先核子目录与反向代理,再查支柱页和模板,最后才分批迁文档」这条线验收,帮助文档放在另一系统几乎搜不到,大多能收成可说明、可回滚的一次改动,而不必先把产品官网整站重做。