Orbit

Te Whakatūruki i ngā Tukurua me ngā Tukatuka

Orbit has a built-in redirect and rewrite engine that runs before your project is asked for anything, configured either in KPanel or as a file in your repository. This guide covers both, the pattern…

Orbit he whare hono me te tauhohenga rau ā-pūmanawa e piki ana i mua i te patai atu ki ō harikoa, kua whakatūtia i roto i te KPanel, i roto rānei i te konae i roto i ō kārangaranga. Ko tēnei aratohu e kōkiri ana i a rāua e rua, te rereketanga o te āhuatanga me ōna hopunga, pēhea te raupapa o ngā ture, ngā rohe, me te whanonga e rapu ana i te hunga.

Kei Hea Te Whakatū Ture

E rua ngā wāhi, a e aromatawai ana i tētahi raupapa o te mea kua whakatau.

  1. I roto i te KPanel. Whakatupu i tō harikoa i Orbit, haere ki Settings, ka pikitia ki te redirects and rewrites wāhanga mō te ahuatanga. Ko ia ahuatanga he ōna ture motuhake, nō reira ko te whai rawa me te whakaaturanga e whakatūia ana i waihangahangā.
  2. I roto i ō kārangaranga, hei kaps.json konae. E whakawhitia ake ana i raro.

Ko ngā ture o te Paipai e aromatawai ana i te mutunga. Mehemea karekau he tahi e ū ana, ka whakamatau atu ki ngā kaps.json ture.

Redirects and rewrites section in Orbit project settings

Te Tāpiri Ture I Roto I te KPanel

  1. Pāwhiri Add rule.
  2. Whakakī te source, te ahuatanga ara hei whakarite i ngā tono e tae ana. Ko te whakaari tuihoho e whakaatu ana i ngā āhuatanga e rua e tahitia ana: /old-path or /blog/:slug.
  3. Whakakī te destination. Ko te whakaari tuihoho e whakaatu ana /new-path or https://..., nō reira he ara ā-Local me te URL o waho e tika ana.
  4. Tohu te momo ture:
    • 301 Permanent: kua neke te URL mō tonu. Ka penapena atu ngā tirotiro me ngā pēpē rapu.
    • 302 Temporary: neke mō ināianei, ehara i te penapena. Whakamahia mō ngā kaupapa me ngā whakamatautau.
    • Rewrite: tukumahu te ara tohu i te waahi karekau te URL e huri i te pae whakatū o te tirotiro.
  5. Pāwhiri Save rules.

Ka whakaae atu te ture mai i te next deployment, ehara i te tūturu. Karekau te tiaki ture e huri i te kaupapa e whakaatu nei te tūranga ahi i tēnei wā. Whakahoki anō i muri i te tiaki, i te kore e puta te ture ki te mahi.

Ka penapena atu te 301 e ngā tirotiro, i ngā wā nei takitahi, a karekau he mea e taea ai e koe i te pūrere kia marama. Mehemea karekau e tūturu te neke, whakamahia te 302 i te tuatahi ka hurihia atu ki te 301 i te wa e tūturu ai koe. Ko te hē i tēnei mea ki te ara whakapā nui he tōkeke tino uaua ki te hoki whakamuri.

Pūtake Ara Ahuatanga

AhuatangaE ū anaE hopunga ana
/old-pageTīkanga /old-pageKarekau
/blog/*Whatunga ka timataria ki /blog/Te toenga o te ara, e tohungia ana hei * i te tohu mutunga
/posts/:id/posts/ me te waahanga ara tahiTērā waahanga, hei :id
/files/:rest*/files/ me te katoa i muri, ngā poupou kua ruaTe toenga katoa, hei :rest

Ko te rereketanga i waenganui i :id me :rest* te mea nui. Ko te tawhā ingoa e ū ana i te waahanga kotahi me te tipu ki te poupou e whai. Ko te whakapuaki e ū ana i te katoa e toe ana, me ngā poupou.

Te Whakamahi Hopunga I te Tohu Mutunga

Tohungia he tawhā ingoa ki te ingoa, me te whakapuaki ā-karanga hei *:

PūtakeTohu MutungaHua
/blog/:slug/articles/:slug/blog/hello-world ka huri ki /articles/hello-world
/docs/:rest*/help/:rest*/docs/a/b/c ka huri ki /help/a/b/c
/old/*/new/*/old/a/b ka huri ki /new/a/b

Raupapa Ture

Ko ngā ture e whakamatautauhia ana mai i te timatanga o te rārangi whakatō me ko te ūnga tuatahi e wīna. Kia ū te ture, karekau he ture muri e whakaarohia. E kī atu ana te paipai i raro i te rārangi: "Rules are tested in order. First match wins."

Whakatupuria ngā ture ūtekau i runga i ngā mea whakarite. Ko te /blog/* ture i tuhia ki runga i /blog/2023/:slug ka pau i ia tono te ture ūtekau e kīia ana kia āwhina, a ka ahua pukumahi te ture ūtekau.

Mehemea karekau he ture e ū ana, ka tukumahungia te tono i te noa.

Ngā Whakamahi Noa

Te Whakaingoa Anō i te Whārangi

I whakaingoa anō koe i /about-us ki /about e hiahia ana ngā hononga tawhito kia mahi tonutanga.

  • Pūtake: /about-us
  • Tohu Mutunga: /about
  • Momo: 301 Permanent

Te Neke i te Wāhanga Katoa

I neke ō pānui mai i /news/:slug ki /blog/:slug.

  • Pūtake: /news/:slug
  • Tohu Mutunga: /blog/:slug
  • Momo: 301 Permanent

Te Whakawaahi i te Ara API i Ahurutia

E hiahia ana koe ki te /api/v1/* tukumahungia mai i tētahi ara ā-roto rerekē karekau te whakaatuhia te huri.

  • Pūtake: /api/v1/:path*
  • Tohu Mutunga: /api/internal/:path*
  • Momo: Rewrite

He Whārangi Pupuri Whakaatu

  • Pūtake: /checkout
  • Tohu Mutunga: /maintenance
  • Momo: 302 Temporary

Te Tuku Tōkani Ki Tētahi Rohe Rerekē

Ko te tohu mutunga he URL ā-uta pūmau, nō reira ka taea e te ture te tohu ki tētahi tīpuna tino rerekē.

  • Pūtake: /shop/:rest*
  • Tohu Mutunga: https://shop.example.com/:rest*
  • Momo: 301 Permanent

Te Whakatūnga Hei Akoranga Me kaps.json

Kua ahu te ture ki ō kārangaranga i waihangahangā i te paipai. Tāpiri he kaps.json konae, me te āta kōpī i ō whakahanga ki ō output directory, i te mea ko Orbit e pānui ana i te pūtake o te whakahanga whakahira karekau i te pūtake kārangaranga.

{
  "redirects": [
    { "source": "/about-us", "destination": "/about", "permanent": true },
    { "source": "/news/:slug", "destination": "/blog/:slug", "permanent": true },
    { "source": "/promo", "destination": "/spring-sale", "permanent": false }
  ],
  "rewrites": [
    { "source": "/api/v1/:path*", "destination": "/api/internal/:path*" }
  ],
  "headers": [
    {
      "source": "/*",
      "headers": [
        { "key": "X-Frame-Options", "value": "DENY" },
        { "key": "X-Content-Type-Options", "value": "nosniff" }
      ]
    }
  ]
}

permanent: true e whakaputa ana i te 301 me permanent: false he 302. Karekau te whakatupunga e hoatu he 301.

kaps.json e pā ana ki static deployments anake. Mehemea kua karanga te Server mode, ka whakatakoto ā-ine tō taupānga me te konae karekau whakaarohia. Ka aromatawai anō i muri noa iho i ngā ture paipai ahuatanga kua hapa ki te ū, nō reira ka ringa tonutanga te ture paipai mō te ara kotahi.

Whakamahia kaps.json i te whakatupuranga e pai ana kia whakaako atu i te akoranga, nō reira ka arotake atu i roto i te pātono tāwhi me te whakawhiti me te whakahoki. Whakamahia te paipai i te wa e hiahia ana koe i te ture ahi i tēnei wā karekau te whakauru. Kaua e pupuri i te ture kotahi i a rāua e rua: ka ringa tonutanga te ture paipai a ka ahua whakahē te ture konae, otirā, kei te whakahē.

Ngā Rohe

  • Ki te 100 redirect me te rewrite ture ia ahuatanga, me te 100 i kaps.json.
  • Ki te 200 ture kaitiaki whakahoki āhuatanga ia ahuatanga.

Ko ngā ture i tua atu i te rohe ka whakamahia pēnei i te pāpuri karekau te pūrongo, nō reira ki iti anake i raro.

Ngā Kaitiaki Whakahoki Āhuatanga

I te taha o ngā hono, ko ia ahuatanga he wāhanga kaitiaki whakahoki i Settings mō te whakauru HTTP kaitiaki i ngā ara e ū ana. Ka whakamahia te ahuatanga ara pūtake kotahi, me ngā tapepe tāpiri tere mō HSTS, CSP, no-embed, no-sniff, whakahoki kaupapa me CORS.

He rerekē i ngā hono, ka whakamahia katoa ngā ture kaitiaki e ū ana, karekau i te tuatahi noa iho, me te ture muri e whakagiti ana i te ture o mua i te tohu ake i te kaitiaki kotahi. Content-Length, Transfer-Encoding me Connection ka tohu i te pūrongo, i te mea he mea pēnei e whakakotikotinga ai te whakahoki.

Te Whanonga E Tika Ai Koe I te Tuatahi

Karekau ngā tāwhā raupapa e whiti i te hono. Ko te ture e ū ana he tāwhā raupapa, ahakoa karekau te tono he tāwhā raupapa, engari ko te tohu mutunga e hanga atu ana i ō ahuatanga me ngā waahanga ara hopungia noa iho. Ko te tono ki /old?utm_source=email e hono ana ki /new, kua motu ngā tawhā. Mehemea e whakawhirinaki ana koe i te tohu i ngā tawhā raupapa kia tonutanga, whakahaere te hono i roto i te mahi taperuarua, koia te āhuatanga e whakahaere tonutanga i te URL tohu mutunga.

  • Ngā ture e ū ana i te ara noa iho. Ngā waahanga waihanga (#section) karekau e ahu atu ki te pūrere i te wa; ka whakahoki anō te tirotiro i muri i te hono.
  • Ko te whakatauhohenga ki te ara karekau i te āhuatanga whakahua he 404, karekau te takahi whakaroa ki te ara taketake. Ko ngā tohu mutunga whakatauhohenga me noho i ō whakahua.
  • Ngā ture e mahi ana i mua i te patai atu ki ō harikoa i te mea, nō reira ka āwhina i ngā konae tūmataiti me ngā tono arorau-pūmanawa.
  • Ko ia ahuatanga he motuhake. Karekau ngā ture i runga i te whai rawa ki te whakaaturanga, me ngā arokite. Kopia atu ā-matua.

Te Whakakore Ture

Pāwhiri te āhua repo i te rarangi ture, me pāwhiri Save rules hei whakaae i te whakarereke. Ka pēnei me te tāpiri, ka whakaae atu te whakarereke mai i te next deployment.

I te Wā Hei Whakamahi Mahi Taperuarua I Waihangahangā

Ko te pērā hono-ki-ara e whakatakoto ana i ngā ture. Haere ki te mahi taperuarua i te wa e hiahia ana koe i te arorau karekau te pēra hono e whakaputa. Titohu i te kaitiaki me te biscuit, te whakatauhohenga, me te rewrite tawhā raupapa, te taumaha A/B rūpeke, me te mea āhuatanga.

Te Pānui e Whai Hononga

E hiahia ana koe i te awhina?

Tīmēra mai ki a support@kapsulehost.com manatoko tahi rānei i roto i KPanel.

Whakatuwhera KPanel
Te Whakatūruki i ngā Tukurua me ngā Tukatuka