如何把多个站点作为目录映射到一个域名上？

• www.yourcompany.com/product-a/
• www.yourcompany.com/product-b/
• www.yourcompany.com/cn/docs/
• www.yourcompany.com/en/docs/

一、 用户场景

• 访问 help.yourcompany.com/cloud/ 显示 Cloud 产品的帮助中心。
• 访问 help.yourcompany.com/studio/ 显示 Studio 产品的帮助中心。
• 访问 help.yourcompany.com/fabric/ 显示 Fabric 产品的帮助中心。

二、 如何配置与使用

步骤 1：在 Baklib 后台获取配置信息

1. 导航至域名管理 进入目标站点的 Baklib 后台，在左侧菜单栏依次点击 “应用设置” -> “域名管理”。
2. 绑定一个内部识别域名
   • 点击 “绑定域名” 按钮。
   • 在弹出的输入框中，您需要为当前站点设置一个仅用于内部识别的域名。这个域名的作用是作为您 Nginx 配置中的 Host 标识，来告诉 Baklib 您想请求哪个具体站点。
   • 强烈推荐使用 .local 作为后缀，以确保它不会与任何真实的公共域名冲突。
   • 格式建议：产品名.公司名.local
   • 示例：假设您的产品是 Cloud，公司是 YourCompany，您可以填写 cloud.yourcompany.local。
3. 切换至反向代理模式并获取参数
   • 域名绑定成功后，在列表中找到您刚刚添加的 .local 域名，点击其右侧的 “配置” 按钮。
   • 在弹出的窗口中，将“部署模式”切换为 “反向代理模式”。
   • 切换后，界面将展示 Nginx 配置所需的全部关键信息。请记录或复制它们，以备下一步使用：
     • 入口域名：这是您站点被访问的真实域名，非常重要。例如，填写 help.yourcompany.com。
     • 部署路径 ：如果您希望站点在域名的某个子目录下访问（如 /app），请填写此项。如果站点直接在根目录，请留空。注意： 路径不能以 / 结尾。例如，填写/cloud
     • Token：这是一个安全凭证，用于验证请求的合法性。请妥善保管，并将其配置到 Nginx 中。

    # Nginx 配置示例, 实现用户访问 help.yourcompany.com/cloud 等于访问 cloud.yourcompany.local
    # 通过此配置可将多个站点统一管理在同一域名的不同目录下
    server {
      listen       80;
      server_name  help.yourcompany.com;
      location /cloud/ {
          rewrite ^/cloud/(.*)$ /$1 break;
          proxy_pass http://site-7kr1j63g.cname.baklib.site;
          proxy_set_header Host cloud.yourcompany.local;
          # 用于验证自建反向代理的身份, 如果 Token 泄漏可点击上面的重置凭证按钮
          proxy_set_header baklib-x-token 4607d3f686c3f0362fa45f383033a89a;
          proxy_set_header baklib-x-script-name /cloud;
          proxy_set_header baklib-x-forwarded-for $proxy_add_x_forwarded_for;
          proxy_set_header baklib-x-forwarded-host $server_name;
          proxy_set_header baklib-x-forwarded-proto $scheme;
          proxy_set_header baklib-x-forwarded-port $server_port;
      }
    }

步骤 2：配置您自己的 Nginx 服务器

server {
    listen 443 ssl http2; # 推荐使用 443 端口和 SSL 加密
    server_name help.yourcompany.com; # 这里填写您自己的主域名

    # SSL 证书配置 (请替换为您自己的证书路径)
    ssl_certificate      cert/yourcompany.com.pem;
    ssl_certificate_key  cert/yourcompany.com.key;
    
    # ... 其他 SSL 和服务器配置 ...

    # === 映射第一个站点：Cloud ===
    # 访问 help.yourcompany.com/cloud/
	location /cloud/ {
		  rewrite ^/cloud/(.*)$ /$1 break;
		  proxy_pass http://site-kr1j63gx.cname.baklib.site;
		  proxy_set_header Host cloud.yourcompany.local;
		  # 用于验证自建反向代理的身份, 如果 Token 泄漏可点击上面的重置凭证按钮
		  proxy_set_header baklib-x-token 4607d3f686c3f0362fa45f383033a89a;
		  proxy_set_header baklib-x-script-name /cloud;
		  proxy_set_header baklib-x-forwarded-for $proxy_add_x_forwarded_for;
		  proxy_set_header baklib-x-forwarded-host $server_name;
		  proxy_set_header baklib-x-forwarded-proto $scheme;
		  proxy_set_header baklib-x-forwarded-port $server_port;
	}

    # === 映射第二个站点：Studio ===
    # 访问 help.yourcompany.com/studio/
    location /studio/ {
		  rewrite ^/studio/(.*)$ /$1 break;
		  proxy_pass http://site-7kr2j63g.cname.baklib.site;
		  proxy_set_header Host studio.yourcompany.local;
		  # 用于验证自建反向代理的身份, 如果 Token 泄漏可点击上面的重置凭证按钮
		  proxy_set_header baklib-x-token a1e9335164d214aee1f224d0f432c9f9;
		  proxy_set_header baklib-x-script-name /studio;
		  proxy_set_header baklib-x-forwarded-for $proxy_add_x_forwarded_for;
		  proxy_set_header baklib-x-forwarded-host $server_name;
		  proxy_set_header baklib-x-forwarded-proto $scheme;
		  proxy_set_header baklib-x-forwarded-port $server_port;
    }
    # ... 您可以根据需要，添加任意多个 location 块来映射更多站点 ...
}

• server_name: 填写您对外展示的主域名。
• location /path/: 定义一个目录路径。当用户访问这个路径时，该 location 块内的规则生效。
• proxy_pass: 必须填写对应 Baklib 站点后台提供的CNAME地址。
• proxy_set_header Host: 必须填写对应 Baklib 站点后台绑定的以 .local结尾的域名。
• proxy_set_header baklib-x-token: 必须填写对应 Baklib 站点后台生成的 Token。
• proxy_set_header baklib-x-script-name: 必须填写，并且值与 location 的路径保持一致，这能确保站点内的链接（如CSS、JS文件）生成正确。

三、 实现原理

1. 用户请求：当一个用户在浏览器输入 https://help.yourcompany.com/cloud/ 时，这个请求首先到达的是您的 Nginx 服务器。
2. 路径匹配：Nginx 服务器作为“总前台”，查看请求的路径是 /cloud/。它会在自己的规则手册（配置文件）里查找，发现有一个 location /cloud/ 的规则与之匹配。
3. 请求转发：匹配成功后，Nginx 并不会自己处理这个请求，而是扮演代理的角色。它会悄悄地将这个请求转发给规则中指定的“后台专家”——也就是 Baklib 的服务器（由 proxy_pass 指定）。
4. 附加信息：在转发请求时，Nginx 会附上几张“便签”（HTTP Headers），告诉 Baklib：
   • “你好，这个请求是想访问 cloud.yourcompany.local 这个站点”（通过 proxy_set_header Host）。
   • “这是我的身份凭证 976d6f...，证明我是合法的请求者”（通过 proxy_set_header baklib-x-token）。
5. Baklib 处理：Baklib 的服务器收到请求后，会检查这些“便签”。它验证 Token，然后根据 Host 知道用户想要的是 cloud.yourcompany.local 站点的内容，于是将该站点的页面数据准备好。
6. 返回响应：Baklib 将页面数据返回给 Nginx 服务器。
7. 最终呈现：Nginx 服务器再将收到的内容原封不动地交给用户的浏览器。

总结