进阶 next-ai-drawio.jiang.jp 2026-11-15 12:26:06 · 10 阅读
第25章 在離線環境或內網中執行
Next AI Draw.io 可以在不能連上網際網路的網路裡執行,例如公司內網。本頁介紹如何在這種環境裡建置和執行它,以及在需要時如何使用獨立的 draw.io 伺服器。
應用程式如何離線運作
Next AI Draw.io 內建一份 draw.io。npm run build 會把 draw.io 的發行檔下載到 public/drawio,只下載一次;Docker 建置也是這樣。之後應用程式從 /drawio 提供這份副本。
使用應用程式時,瀏覽器不會連線到 embed.diagrams.net。所以只要建置時能連網,應用程式就能在離線網路或內網裡使用。
使用 Docker Compose 執行
將儲存庫 clone 到本機,並在 .env 檔案中定義您的 API Key。
執行 docker compose up -d。它會使用儲存庫裡的 docker-compose.yml。
開啟 http://localhost:3000。
您不需要獨立的 draw.io 容器。
在不能連網的機器上建置
建置時會從 draw.io 發行頁面 下載 draw.war(約 50 MB)。如果建置用的機器連不上 GitHub,請選擇下面兩種做法之一:
手動放入 draw.io。 在另一台機器上,下載 packages/mcp-server/src/drawio-version.json 裡寫明的那個版本的 draw.war。把它解壓縮到 public/drawio,然後刪掉其中的 WEB-INF 和 META-INF 資料夾。再把版本號碼(例如 v32.0.2)寫進 public/drawio/.version。建置時就會使用這份副本。
在別處建置映像。 在能連網的機器上建置映像,再把映像複製到離線網路裡。
插入其他網站的圖片
內建的 draw.io 是一組靜態檔案(伺服器原樣傳送的檔案)。其中沒有圖片代理(/drawio/proxy)。圖片代理是 draw.io 伺服器的一部分,負責替 draw.io 取得其他網站的圖片。
用網址插入的其他網站的圖片,仍然能在畫布上顯示。匯出的 PNG、SVG 圖片和版本縮圖裡不會有它,因為 draw.io 要透過這個代理去取這類圖片。
這類圖片請改用檔案插入,draw.io 會把它儲存在圖表裡。
使用獨立的 draw.io 伺服器
這一步並非必要。您仍然可以讓應用程式使用別處的 draw.io,例如 jgraph/drawio 映像。把 NEXT_PUBLIC_DRAWIO_BASE_URL 設為它的位址。這個變數在建置應用程式時讀取,所以要作為建置引數傳入:
services:
drawio:
image: jgraph/drawio:latest
ports: ["8080:8080"]
next-ai-draw-io:
build:
context: .
args:
- NEXT_PUBLIC_DRAWIO_BASE_URL=http://localhost:8080
ports: ["3000:3000"]
env_file: .env
volumes:
- ./data:/app/data
depends_on: [drawio]
volumes 這一項把您在管理面板裡儲存的設定(data/settings.json)放在容器之外,所以更換容器後,這些設定仍然保留。
使用外部 draw.io 時,應用程式改用 draw.io 自己的工具列,以下功能無法使用:
框出 AI 改過的圖形
針對選取的圖形提問
應用程式自己的畫布工具列
用 Ctrl+Z 復原 AI 的修改
瀏覽器不允許頁面控制來自其他來源(主機名稱、連接埠或通訊協定不同)的編輯器。
NEXT_PUBLIC_DRAWIO_BASE_URL 必須是使用者瀏覽器能連上的位址。
draw.io 執行在哪裡值您自己的電腦(localhost)http://localhost:8080遠端伺服器http://YOUR_SERVER_IP:8080
不要使用 Docker 內部的名稱,例如 http://drawio:8080。這些是容器之間互相連線用的名稱,瀏覽器無法透過它們找到伺服器。