← 所有迁移指南

竞争对手迁移指南

从 Bun.serve 迁移到 Webship，无需盲切换。

将应用程序代码与边缘职责分开：保留 Bun 作为源，而 Webship 接管 TLS、静态交付、HTTP/3、保护和请求路由。

适用于 Webship 1.5.3TypeScript

在更改流量之前定义迁移边界。

首先只迁移 Webship 能够再现和验证的行为。在其替代品通过类似生产测试之前，保持应用程序认证、服务发现、脚本和专用缓存规则在现有源上。

先翻译最小的生产路径。

源片段标识了迁移概念；Webship 片段展示了目标形态。用针对您的环境验证过的值替换示例域、地址、证书、限制和健康路径。

代表性 Bun.serve 配置
Bun.serve({
  port: 443,
  tls: { cert: Bun.file("cert.pem"), key: Bun.file("key.pem") },
  routes: {
    "/": new Response(Bun.file("./public/index.html")),
  },
});
等效 Webship TOML
listen = "0.0.0.0:443"
workers = 4

[[sites]]
domain = "app.example.com"
root = "/srv/app/public"
listen = "0.0.0.0:443"
cert = "/etc/letsencrypt/live/app.example.com/fullchain.pem"
key = "/etc/letsencrypt/live/app.example.com/privkey.pem"

[sites.protocols]
h1 = true
h2 = true
h3 = true

映射概念，而不是语法。

技术指令并不总是一一对应。使用此表查找等效的 Webship 配置区域，然后验证有效配置和运行时行为。

当前概念或指令Webship 配置目标
listener / virtual hostlisten + [reverse_proxy.protocols]
document root[[sites]].root
host matcher[[reverse_proxy.routes]]
certificate and private key[reverse_proxy.tls] / [[sites]] cert + key

使用可逆的五步切换。

在 Webship 在代表流量上通过正确性、容量、安全性、可观测性和回滚检查之前，保持旧的监听器准备就绪。

  1. 1

    库存可观察行为

    记录监听器、域、路由、上游、证书、重写、认证、缓存规则、健康探测、限制和操作集成。

  2. 2

    翻译一个边界

    将一个主机或路由移入严格的 TOML。在单独替代方案被验证之前，保留供应商特定模块和应用逻辑在 Webship 后面。

  3. 3

    离线及本地验证

    运行 --check-config 和 --print-effective-config，检查被编辑的结果，在本地探测健康状况，并在启用 HTTP/3 时通过 TCP 和 UDP 使用 TLS。

  4. 4

    小范围真实流量（Canary 测试）

    向 Webship 发送一小部分可观察的流量。比较状态码、头信息、响应体、延迟、上游健康状况、缓存行为、日志和安全决策。

  5. 5

    推广并准备回滚

    在测量阶段增加流量。保持之前的目标健康并可立即路由，直到约定的观察窗口和负载门通过。

首先验证。通过路由回滚，而不是编辑实时内容。

验证候选文件，检查经过编辑的有效配置，并在更改流量之前探测私有侦听器。在观察窗口关闭之前，保留旧的二进制文件、配置、侦听器以及 DNS 或负载均衡目标。

/usr/local/bin/webship --check-config --config /etc/webship/production.toml
/usr/local/bin/webship --print-effective-config --config /etc/webship/production.toml
curl --http3-only --insecure https://127.0.0.1:443/health