Työnkulut, jotka kestävät seuraavan uudelleenkäynnistyksen.

Suojaa editori

Sijoita editori HTTPS ja tuetun todennuksen taakse. Rajoita pääkäyttöoikeuksia ja vältä julkista rekisteröitymistä, kun se ei ole tarpeen. Webhook-reitit tarvitsevat omat altistus- ja todennuspäätöksensä.

Säilytä tunnistetietojen avain

Varmuuskopioi määritetty salausavain asianmukaisella suojauksella. Tietokannan palauttaminen ilman oikeaa avainta voi jättää tallennetut tunnistetiedot käyttökelvottomiksi. Pidä avain poissa kuvakaappauksista, tietovarastoista ja suodattamattomista lokeista.

Skaalaa suorituspolku harkiten

Kiireisessä kokoonpanossa tarkista tuettu tietokanta, jono ja työntekijämalli. Redis ja erilliset työntekijät lisäävät omat pääsy- ja pysyvyysvaatimuksensa. Rajoita samanaikaisia töitä, jotta piikki ei kuluta VPS- tai ulkoista API-budjettia.

Säilytä vain hyödyllinen suoritusdata

Työnkulut voivat käsitellä tokeneita, henkilötietoja ja asiakirjoja. Aseta suoritushistorian karsinta, peitä arkaluontoiset arvot ja määrittele uudelleenyritykset huolellisesti. Kopioitu webhook ei saa aiheuttaa tahatonta toista maksua tai viestiä.

Käsittele salausavainta osana tietokantaa

Tallennetut tunnistetiedot riippuvat n8n salausavaimesta. Säilytä tilakansio, joka sisältää automaattisesti luodun avaimen, tai aseta N8N_ENCRYPTION_KEY yksityisestä salaisuuksien säilöstä. Kaikki jonotyöntekijät tarvitsevat saman avaimen kuin pääprosessi. Testaa palautus kertakäyttöisellä tunnistetiedolla; pelkästään palautettu tietokanta voi näyttää terveeltä, vaikka sen tunnistetiedot pysyvät lukukelvottomina.

• Pidä avain julkisen hakemiston ja tietovaraston ulkopuolella
• Varmuuskopioi tietokanta johdonmukaisesti
• Käytä tuettua PostgreSQL:ää aiottuun tuotantokäyttöön

Virallinen dokumentaatio: n8n salausavaimen kokoonpano

Anna verkkokoukuille niiden julkinen osoite

Käänteinen välityspalvelin, kuten Caddy, voi päättää HTTPS-yhteyden, kun taas n8n kuuntelee sisäisesti. Nykyinen dokumentaatio käyttää ulkoisen webhook-lähteen osoitteeseen N8N_WEBHOOK_URL-muuttujaa ja korvaa vanhemman WEBHOOK_URL-nimen versiosta 2.35.0 alkaen. Aseta luotettujen välityspalvelinhyppyjen määrä todellisen polun mukaiseksi; yksi välityspalvelin käyttää arvoa N8N_PROXY_HOPS=1. Säilytä välitetyt isäntä-, protokolla- ja asiakastiedot. Testaa webhook palvelimen ulkopuolelta ja varmista sen tuotanto-URL.

• Aseta työnkulun aikavyöhyke tarkoituksella
• Karsi pois arkaluontoisia syötteitä sisältävä suoritushistoria
• Käytä jonotyöntekijöitä ja Redis-palvelua vain vaadittujen yksityisten käyttöoikeusvalvontojen kanssa

# Example: one HTTPS reverse proxy
N8N_WEBHOOK_URL=https://automations.example.com/
N8N_PROXY_HOPS=1

Virallinen dokumentaatio: n8n käänteisen välityspalvelimen takana

Määrittele työkuorma ja sallitut integraatiot

Listaa laukaisimet, ulkoiset tilit, odotettu suoritusmäärä ja suurin kulutus tai sivuvaikutus, jonka kukin työnkulku voi aiheuttaa. Tarkista n8n lisenssi todellisen käytön varalta, erityisesti jos tarjoat sitä palveluna muille. Pienellä aikataulutetulla työnkululla ja julkisella webhook-käsittelijällä on erilaiset resurssitarpeet. Aloita tuetusta julkaisusta, yksityisestä pysyvästä tilasta, TLS-nimestä ja käyttöönottoon sopivasta tietokannasta; vältä tietokantaporttien paljastamista editorilla.

• Käytä erillisiä rajoitettuja tunnuksia jokaista integraatiota varten.
• Aseta aiottu työnkulun aikavyöhyke ja suoritushistorian säilytys.
• Pidä viedyt työnkulut vapaina upotetuista todellisista salaisuuksista.

Virallinen dokumentaatio: n8n Docker-käyttöönotto

Aseta julkinen webhook-lähde asennetulle versiolle

Käänteinen välityspalvelin, kuten Caddy, tavoittaa n8n sisäisesti, kun taas ulkoiset palvelut kutsuvat sen HTTPS-webhook-lähdettä. Käytä asennetulle julkaisulle dokumentoitua webhook-URL-muuttujaa; nykyinen dokumentaatio nimeää sen N8N_WEBHOOK_URL-muuttujaksi, kun taas vanhemmat julkaisut käyttivät WEBHOOK_URL-muuttujaa. Aseta todellinen välityspalvelinhyppyjen määrä sen sijaan, että luottaisit mielivaltaisiin välitettyihin otsakkeisiin. Pidä muokkausoikeuskäytäntö erillään webhook-todennuksesta ja varmista, ettei tuotannon takaisinkutsussa ole sisäistä isäntää tai porttia.

# Example values for a supported current release, behind one proxy:
N8N_WEBHOOK_URL=https://automations.example.com/
N8N_PROXY_HOPS=1

Virallinen dokumentaatio: n8n webhook-käänteisvälityspalvelimen asetukset

Testaa vaaratonta työnkulkua ennen kirjoitusoikeuksien myöntämistä

Aloita vain luku -pyynnöllä tai kertakäyttöisellä testitietueella. Testaa tuotannon webhook VPS ulkopuolelta, todennuksen hylkääminen ja tarkoituksellinen uudelleenyritys. Toistuva pyyntö ei saa vahingossa luoda toista merkittävää toimintoa. Tarkista suorituslokit vuotaneiden syötteiden varalta ja ota sitten käyttöön säilytyskäytäntö. Jos webhook toimii vain editorin testitilassa, tarkista, onko työnkulku julkaistu/aktiivinen ja saavuttavatko tuotanto- ja testireitit oikean prosessin.

• Testaa palautus kertakäyttöisellä integraatiotunnuksella.
• Säilytä riippumaton salattu kopio N8N_ENCRYPTION_KEY-avaimesta tai luodusta avaintilasta.
• Älä lähetä esimerkkisalasanoja tai API -tunnuksia säilytettävään virheenkorjaustulosteeseen.

Virallinen dokumentaatio: n8n salausavain

Skaalaa vasta, kun suorituksen pullonkaula on havaittu

Jonotila lisää Redisin, työntekijät ja jaetun tietokannan; pääprosessi vastaanottaa laukaisimet, kun taas työntekijät suorittavat aiot. Jokaisen työntekijän on käytettävä samaa tunnistetietojen salausavainta. Noudata nykyisiä binaaridatan tallennusvaatimuksia ennen kuin siirrät tiedostoja sisältävän työnkulun jonotilaan. Rajoita samanaikaisuutta ja ylävirran API-budjetteja ja seuraa jonon ikää ja virheitä. Varmuuskopioi tietokanta, tila ja avain yhdessä; kontin uudelleenkäynnistys ei ole palautussuunnitelma lukukelvottomille tallennetuille tunnistetiedoille.

Virallinen dokumentaatio: n8n jonotila · Suoritusten karsinta-asetukset