Skip to main content

AgentBuilder

學習如何在您自己的遠端伺服器上部署 AgentBuilder 並提供安全的網路存取。 本指南將引導您使用 Docker 在遠端伺服器上設定 AgentBuilder，並使用 Caddy 配置安全的網路存取。

先決條件​

  • 具有雙核心 CPU 和至少 2 GB RAM 的伺服器。 此範例使用 Hetzner cloud 進行託管。您的部署可能會有所不同。

使用 SSH 連接到您的遠端伺服器​

  1. 建立 SSH 金鑰以遠端連接到您的伺服器。 例如：


    _10
    ssh-keygen -t ed25519 -C "DANA@EXAMPLE.COM"

    將 DANA@EXAMPLE.COM 替換為您想要與 SSH 金鑰關聯的電子郵件地址。

  2. 在您的終端機中，按照指示建立您的 SSH 金鑰對。 這會建立私鑰和公鑰。 要從您的終端機複製公鑰，請輸入以下命令：


    _10
    cat ~/Downloads/host-lf.pub | pbcopy

  3. 在您的遠端伺服器中，新增您在上一步複製的 SSH 金鑰。 例如，如果您使用 Hetzner cloud 伺服器，請按一下 Server，然後選取 SSH keys 以新增 SSH 金鑰。

  4. To connect to your server with SSH, enter the following command.


    _10
    ssh -i PATH_TO_PRIVATE_KEY/PRIVATE_KEY_NAME root@SERVER_IP_ADDRESS

    替換以下內容：

    • PATH_TO_PRIVATE_KEY/PRIVATE_KEY_NAME：與您新增到伺服器的公鑰匹配的私鑰 SSH 金鑰檔案的路徑
    • SERVER_IP_ADDRESS：您的伺服器 IP 地址

  5. 當提示金鑰指紋時，輸入 yes。

終端機輸出會指示連線成功或失敗。 連接到 Hetzner cloud 伺服器後傳回以下回應：


_10
System information as of Mon May 19 04:34:44 PM UTC 2025
_10
_10
System load: 0.0 Processes: 129
_10
Usage of /: 1.5% of 74.79GB Users logged in: 0
_10
Memory usage: 5% IPv4 address for eth0: 5.161.250.132
_10
Swap usage: 0% IPv6 address for eth0: 2a01:4ff:f0:4de7::1

在您的伺服器上部署 AgentBuilder​

現在您的本機機器已使用 SSH 連接到您的遠端伺服器，您可以安裝 Docker、建立 docker-compose.yml 檔案，並使用反向代理（如 Caddy）公開服務。

  1. 在您的伺服器上安裝 Docker。

    由於此範例伺服器是 Ubuntu 伺服器，它可以安裝 snap 套件。 如果您沒有使用 Ubuntu 或偏好不同的安裝方法，請參閱官方 Docker 安裝指南 以取得您的作業系統的指示。


    _10
    snap install docker

  2. 建立名為 docker-compose.yml 的檔案，然後在文字編輯器中開啟它：


    _10
    touch docker-compose.yml && nano docker-compose.yml

  3. 將以下值新增到 docker-compose.yml，然後儲存檔案。

    以下範例從 langflow:latest 映像定義 AgentBuilder 服務，以及一個 Caddy 服務以透過反向代理公開 AgentBuilder。

    tip

    host-langflow 儲存庫提供此 docker-compose.yml 和 Caddyfile 的預建複本，如果您偏好將儲存庫分叉到您的伺服器。


    _26
    version: "3.8"
    _26
    _26
    services:
    _26
    langflow:
    _26
    image: langflowai/langflow:latest
    _26
    ports:
    _26
    - "7860:7860"
    _26
    environment:
    _26
    - LANGFLOW_HOST=0.0.0.0
    _26
    - LANGFLOW_PORT=7860
    _26
    _26
    caddy:
    _26
    image: caddy:latest
    _26
    ports:
    _26
    - "80:80"
    _26
    - "443:443"
    _26
    volumes:
    _26
    - ./Caddyfile:/etc/caddy/Caddyfile
    _26
    - caddy_data:/data
    _26
    - caddy_config:/config
    _26
    depends_on:
    _26
    - langflow
    _26
    _26
    volumes:
    _26
    caddy_data:
    _26
    caddy_config:

  4. 建立名為 Caddyfile 的檔案：


    _10
    touch Caddyfile && nano Caddyfile

  5. 將以下值新增到 Caddyfile，然後儲存檔案。

    此 Caddyfile 配置 Caddy 在連接埠 80 上監聽，並將所有傳入請求轉發到連接埠 80 到連接埠 7860 的 AgentBuilder 服務。


    _10
    :80 {
    _10
    reverse_proxy langflow:7860
    _10
    }

  6. 要部署您的伺服器，請執行 docker-compose up。

    當出現 Welcome to AgentBuilder 訊息時，AgentBuilder 正在運行，並且可以在 Docker 網路內部透過 http://0.0.0.0:7860 存取。

  7. 要透過公共網際網路存取您的 AgentBuilder 伺服器，請導航到您的伺服器公共 IP 地址，例如 http://5.161.250.132。 此地址使用 HTTP，因為 HTTPS 尚未啟用。

  8. 建議：啟用 HTTPS：

    1. 修改您的網域 A 記錄以指向您的伺服器 IP 地址。例如：


      _10
      Type: A
      _10
      Name: langflow
      _10
      Value: 5.161.250.132 # 設定為您的伺服器 IP 地址

    2. 停止您的伺服器。

    3. 修改您的 Caddyfile 以包含連接埠 443，以便 Caddy 可以將 HTTP（連接埠 80）和 HTTPS（連接埠 443）請求轉發到 AgentBuilder 服務：


      _10
      :80, :443 {
      _10
      reverse_proxy langflow:7860
      _10
      }

    4. 啟動您的伺服器。

      當使用者造訪您的網域時，Caddy 會識別傳入流量並自動使用安全加密連線將其路由到您的伺服器。

  9. 要退出您的 SSH 階段，請輸入 exit。

另請參閱​

要將您的本機FLOW打包到自訂 Docker 映像中，請參閱容器化 AgentBuilder 應用程式。

如需部署 AgentBuilder 的逐步指南，包括部署到 fly.io 和 Flightcontrol.dev，請參閱 How to Host AgentBuilder Anywhere。

Search