例并訪問(wèn) http://localhost:5678)
n8n 如何用 get.n8n.io 一行安裝腳本部署自托管實(shí)例并訪問(wèn) http://localhost:5678【免費(fèi)下載鏈接】n8nFair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400 integrations.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/n8/n8n如果你想在本地或自己的服務(wù)器上自托管一個(gè) n8n 實(shí)例并在瀏覽器里打開(kāi) http://localhost:5678 開(kāi)始建工作流最快的路徑是官方的單行安裝腳本。它基于 docker compose 拉起 n8n 本體、任務(wù) runners、AI 沙箱服務(wù)和 SearXNG 搜索服務(wù)生成一套帶唯一密鑰的本地配置然后等待健康檢查通過(guò)。前提是機(jī)器上裝有 Docker含 Compose v2 插件且守護(hù)進(jìn)程正在運(yùn)行。前提條件Docker、端口與安裝目錄腳本在執(zhí)行前會(huì)逐項(xiàng)檢查環(huán)境不滿足時(shí)直接報(bào)錯(cuò)并給出對(duì)應(yīng)的修復(fù)提示Docker 已安裝且守護(hù)進(jìn)程在運(yùn)行。腳本通過(guò)docker info判斷Podman、Colima 等兼容引擎也可以但需要安裝帶 compose 插件的dockerCLI并用DOCKER_HOST指向它們的 socket。Docker Compose v2 插件可用docker compose version能執(zhí)行。舊的獨(dú)立二進(jìn)制docker-compose不受支持。5678 端口空閑。腳本會(huì)探測(cè)http://127.0.0.1:5678/只要有進(jìn)程應(yīng)答HTTP 響應(yīng)或連接被接受就判定端口被占用并終止。安裝目錄默認(rèn)為./n8n即命令執(zhí)行時(shí)的當(dāng)前目錄下。該目錄不能已存在且非空否則腳本拒絕寫(xiě)入。執(zhí)行一行安裝最短主路徑curl -fsSL https://get.n8n.io | sh如果希望先審查腳本內(nèi)容再執(zhí)行腳本頭部推薦的查看方式curl -fsSL https://get.n8n.io -o get-n8n.sh less get-n8n.sh sh get-n8n.sh執(zhí)行后腳本完成的工作源碼見(jiàn) docker/get-n8n.sh解析要安裝的 n8n 版本默認(rèn)取最新穩(wěn)定 release并把版本號(hào)以N8N_VERSION形式固定寫(xiě)入.env不使用浮動(dòng) tag避免容器重建時(shí)靜默升級(jí)并觸發(fā)數(shù)據(jù)庫(kù)遷移。GitHub 查詢失敗時(shí)回退到腳本內(nèi)置的2.32.0。在./n8n下生成三個(gè)文件compose.yml棧定義下載一次后歸你所有腳本以后永不重寫(xiě)它、.env權(quán)限 600內(nèi)含本次安裝隨機(jī)生成的唯一密鑰、searxng-settings.yml。拉取鏡像首次可能需要幾分鐘然后docker compose up -d啟動(dòng)全部服務(wù)。每 3 秒輪詢一次http://127.0.0.1:5678/healthz最多等 180 秒首次啟動(dòng)要拉鏡像并跑遷移。成功后打印摘要運(yùn)行地址、數(shù)據(jù)位置./n8nDocker 卷n8n-data、配置文件位置、啟停命令和安全提示。常用選項(xiàng)按需拼在管道后面# 安裝指定版本必須像 2.32.0 這樣的三段式版本號(hào) curl -fsSL https://get.n8n.io | sh -s -- --version 2.32.0 # 只生成配置文件不拉鏡像、不啟動(dòng) curl -fsSL https://get.n8n.io | sh -s -- --no-start # 只打印腳本版本和將要安裝的 n8n 版本不做任何改動(dòng) curl -fsSL https://get.n8n.io | sh -s -- --version兩個(gè)環(huán)境變量N8N_DIR改變安裝目錄例如N8N_DIR./some-dir默認(rèn)./n8n。DO_NOT_TRACK1安裝或升級(jí)失敗時(shí)腳本會(huì)詢問(wèn)是否發(fā)送一份匿名失敗報(bào)告僅含腳本版本、系統(tǒng)名、install/upgrade 模式和失敗步驟默認(rèn)不發(fā)送設(shè)置該變量后不再詢問(wèn)。驗(yàn)證安裝并訪問(wèn)編輯器腳本成功時(shí)的輸出里包含n8n is running at: http://localhost:5678文檔示例輸出。此時(shí)在瀏覽器打開(kāi) http://localhost:5678 即可進(jìn)入編輯器不依賴腳本自身提示時(shí)可以用兩種方式復(fù)核# 健康檢查端點(diǎn)腳本判定就緒用的就是它 curl http://127.0.0.1:5678/healthz# 容器狀態(tài) docker compose -f n8n/compose.yml ps倉(cāng)庫(kù)的 e2e 測(cè)試docker/test-get-n8n.sh對(duì)容器狀態(tài)給出了明確的期望值可作為人工核對(duì)基準(zhǔn)n8n、sandbox-api、sandbox-runner-1、runners、searxng五個(gè)服務(wù)處于 running 狀態(tài)sandbox-certs是一次性證書(shū)引導(dǎo)容器以退出碼 0 結(jié)束exited 0。日常啟停與升級(jí)啟停命令腳本成功摘要中給出的形式docker compose -f n8n/compose.yml down # 停止 docker compose -f n8n/compose.yml up -d # 啟動(dòng)在已有安裝上不帶--upgrade重跑一行腳本是安全的 no-op不改動(dòng)任何文件只報(bào)告當(dāng)前狀態(tài)、啟動(dòng)地址和升級(jí)命令。升級(jí)curl -fsSL https://get.n8n.io | sh -s -- --upgrade--upgrade只修改.env中的N8N_VERSION一行可與--version x.y.z組合指定目標(biāo)版本然后拉取鏡像并重啟其他配置和密鑰一概不動(dòng)。升級(jí)時(shí)它還會(huì)比對(duì)本地compose.yml與線上棧定義的版本標(biāo)記若官方棧已更新會(huì)提示你去查看變更但不會(huì)替你改寫(xiě)文件。常見(jiàn)失敗與恢復(fù)端口被占用腳本報(bào)something is already listening on port 5678。先停掉占用進(jìn)程后重跑或者加--no-start只生成配置然后手動(dòng)調(diào)整n8n/compose.yml里的端口映射再啟動(dòng)。安裝目錄非空腳本拒絕寫(xiě)入非空目錄提示用N8N_DIR./some-dir換一個(gè)目錄。Docker Hub 拉取限流報(bào)錯(cuò)會(huì)給出恢復(fù)建議——配置文件不受影響等約一小時(shí)后用docker compose -f n8n/compose.yml up -d啟動(dòng)或者用docker login登錄 Docker Hub 賬號(hào)提高限額后重跑腳本。就緒超時(shí)180 秒內(nèi)/healthz不通按提示檢查docker compose -f n8n/compose.yml logs n8n。數(shù)據(jù)安全與這套部署的邊界實(shí)例數(shù)據(jù)存在 Docker 卷n8n-data中掛載到容器內(nèi)/home/node/.n8n工作流保存在 SQLite 數(shù)據(jù)庫(kù)里該目錄還包含 webhook URL 和憑據(jù)加密密鑰。據(jù) docker/images/n8n/README.md 說(shuō)明如果啟動(dòng)時(shí)找不到這些數(shù)據(jù)n8n 會(huì)自動(dòng)生成新密鑰已有憑據(jù)將無(wú)法再解密。安全提示腳本摘要原文語(yǔ)義只有 5678 端口應(yīng)暴露到公網(wǎng)sandbox-runner-1是特權(quán) Docker-in-Docker 容器永遠(yuǎn)不要發(fā)布它的端口runners、sandbox-api、searxng只在 compose 網(wǎng)絡(luò)內(nèi)以服務(wù)名訪問(wèn)不發(fā)布主機(jī)端口見(jiàn) docker/get-n8n-compose.yml。定位這套一行部署面向本地試用。生產(chǎn)級(jí)需求TLS、Postgres、隊(duì)列模式不在一行腳本范圍內(nèi)。卸載腳本在檢測(cè)到已有安裝時(shí)會(huì)打印卸載命令注意它會(huì)刪除全部 n8n 數(shù)據(jù)down -v連帶刪除n8n-data卷rm -rf刪除配置目錄docker compose -f n8n/compose.yml down -v rm -rf n8n可選分支不用 compose 的手動(dòng) docker run如果不想引入 runners/沙箱這套完整棧根 README.md 的 Quick Start 給出了單容器手動(dòng)方式同樣來(lái)自 docker/images/n8n/README.md數(shù)據(jù)卷名和掛載點(diǎn)與上面不同訪問(wèn)地址相同docker volume create n8n_data docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n啟動(dòng)后同樣訪問(wèn) http://localhost:5678。【免費(fèi)下載鏈接】n8nFair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400 integrations.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/n8/n8n創(chuàng)作聲明:本文部分內(nèi)容由AI輔助生成(AIGC),僅供參考