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.
- 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ā.
- I roto i ō kārangaranga, hei
kaps.jsonkonae. 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.

Te Tāpiri Ture I Roto I te KPanel
- Pāwhiri Add rule.
- 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. - 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. - 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.
- 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
| Ahuatanga | E ū ana | E hopunga ana |
|---|---|---|
/old-page | Tīkanga /old-page | Karekau |
/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 tahi | Tērā waahanga, hei :id |
/files/:rest* | /files/ me te katoa i muri, ngā poupou kua rua | Te 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ūtake | Tohu Mutunga | Hua |
|---|---|---|
/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.