doc (#7233)

a1bd28d0 · Archer · GitHub · 935aef74 · a1bd28d0 · a1bd28d0
Commit a1bd28d0 authored Jul 01, 2026 by Archer Committed by GitHub Jul 01, 2026
13 changed files
--- a/document/content/guide/getting-started/index.en.mdx
+++ b/document/content/guide/getting-started/index.en.mdx
@@ -8,7 +8,7 @@ import { Alert } from '@/components/docs/Alert';
 FastGPT is an AI Agent application development platform built on large language models. It combines Knowledge Base Q&A, visual Workflows, Agent orchestration, tool calling, and skill extensions so developers and business users can quickly build custom AI applications.
 <Alert icon="🤖" context="success">
-  Quick Start - International: [https://fastgpt.io](https://fastgpt.io) - China Mainland:
+  Try FastGPT now - International: [https://fastgpt.io](https://fastgpt.io) - China Mainland:
  [https://fastgpt.cn](https://fastgpt.cn)
 </Alert>

--- a/document/content/self-host/upgrading/4-15/41500.en.mdx
+++ b/document/content/self-host/upgrading/4-15/41500.en.mdx
@@ -216,6 +216,8 @@ For this upgrade, focus on:
 2. Updating OpenSandbox-related image versions.
 3. Updating related environment variables in `fastgpt-app` and `fastgpt-pro`.
+You can overwrite your deployment directly with the new OpenSandbox template.
 ### 3. Image Changes
 - Update fastgpt-app (FastGPT main service) image tag: v4.15.0

--- a/document/content/self-host/upgrading/4-15/41500.mdx
+++ b/document/content/self-host/upgrading/4-15/41500.mdx
@@ -215,6 +215,8 @@ Opensandbox 和其他沙盒提供商的配置单独移动到[沙盒配置](../..
 2. 更新 `opensandbox` 相关镜像版本。
 3. 修改 `fastgpt-app` 和 `fastgpt-pro` 里部分环境变量。
+可以直接按新的 OpenSandbox 模板进行覆盖部署即可。
 ### 3. 镜像变更
 - 更新 fastgpt-app(fastgpt 主服务) 镜像 tag: v4.15.0

--- a/document/data/doc-last-modified.json
+++ b/document/data/doc-last-modified.json
@@ -125,8 +125,8 @@
  "content/guide/dataset/websync.mdx": "2026-05-07T15:06:40+08:00",
  "content/guide/getting-started/index.en.mdx": "2026-06-24T18:16:41+08:00",
  "content/guide/getting-started/index.mdx": "2026-06-24T18:16:41+08:00",
-  "content/guide/getting-started/quick-start.en.mdx": "2026-05-07T15:06:40+08:00",
+  "content/guide/getting-started/quick-start.en.mdx": "2026-07-01T17:20:32+08:00",
-  "content/guide/getting-started/quick-start.mdx": "2026-05-07T15:06:40+08:00",
+  "content/guide/getting-started/quick-start.mdx": "2026-07-01T17:20:32+08:00",
  "content/guide/index.en.mdx": "2026-05-07T15:06:40+08:00",
  "content/guide/index.mdx": "2026-05-07T15:06:40+08:00",
  "content/guide/version/cloud/faq.en.mdx": "2026-05-25T18:16:39+08:00",
@@ -279,6 +279,8 @@
  "content/self-host/upgrading/4-14/41425.mdx": "2026-06-22T12:20:51+08:00",
  "content/self-host/upgrading/4-14/41426.en.mdx": "2026-06-24T23:05:29+08:00",
  "content/self-host/upgrading/4-14/41426.mdx": "2026-06-24T23:05:29+08:00",
+  "content/self-host/upgrading/4-14/41427.en.mdx": "2026-07-01T17:22:47+08:00",
+  "content/self-host/upgrading/4-14/41427.mdx": "2026-07-01T17:22:47+08:00",
  "content/self-host/upgrading/4-14/4143.en.mdx": "2026-04-26T21:08:47+08:00",
  "content/self-host/upgrading/4-14/4143.mdx": "2026-04-26T21:08:47+08:00",
  "content/self-host/upgrading/4-14/4144.en.mdx": "2026-04-26T21:08:47+08:00",
@@ -454,6 +456,6 @@
  "content/self-host/upgrading/outdated/499.mdx": "2026-05-07T15:06:40+08:00",
  "content/self-host/upgrading/upgrade-intruction.en.mdx": "2026-04-26T21:08:47+08:00",
  "content/self-host/upgrading/upgrade-intruction.mdx": "2026-04-26T21:08:47+08:00",
-  "content/toc.en.mdx": "2026-07-01T12:13:58+08:00",
+  "content/toc.en.mdx": "2026-07-01T17:22:47+08:00",
-  "content/toc.mdx": "2026-07-01T12:13:58+08:00"
+  "content/toc.mdx": "2026-07-01T17:22:47+08:00"
 }
\ No newline at end of file
--- a/document/public/deploy/docker/v4.15/agent-proxy.yml
+++ b/document/public/deploy/docker/v4.15/agent-proxy.yml
+# FastGPT Agent Sandbox Proxy standalone deployment.
+# After starting this file, set FastGPT AGENT_SANDBOX_PROXY_URL to ws://<host>:1006 or your wss:// domain.
+x-agent-sandbox-proxy-secret: &x-agent-sandbox-proxy-secret "default_fastgpt_agent_sandbox_proxy_secret"
+services:
+  fastgpt-agent-sandbox-proxy:
+    image: ghcr.io/labring/fastgpt-agent-sandbox-proxy:v0.2.0
+    container_name: fastgpt-agent-sandbox-proxy
+    restart: always
+    networks:
+      - app
+    ports:
+      - 3006:1006
+    environment:
+      PORT: 1006
+      # Must exactly match AGENT_SANDBOX_PROXY_SECRET in fastgpt-app / fastgpt-pro.
+      AGENT_SANDBOX_PROXY_SECRET: *x-agent-sandbox-proxy-secret
+      # FastGPT main service URL reachable from this container.
+      # If this compose file joins the FastGPT app network, you can use http://fastgpt-app:3000.
+      FASTGPT_APP_URL: http://fastgpt-app:3000
+      FASTGPT_APP_REQUEST_TIMEOUT_SECS: 60
+      RUST_LOG: info,fastgpt_agent_sandbox_proxy=debug
+networks:
+  app:
--- a/document/public/deploy/docker/v4.15/opensandbox.yml
+++ b/document/public/deploy/docker/v4.15/opensandbox.yml
+# OpenSandbox standalone deployment for FastGPT Agent/Skill Sandbox.
+# Deploy fastgpt-agent-sandbox-proxy separately, then set FastGPT.
+#
+# If these services are copied into the same docker-compose.yml as FastGPT:
+# AGENT_SANDBOX_PROVIDER=opensandbox
+# AGENT_SANDBOX_OPENSANDBOX_BASEURL=http://fastgpt-opensandbox-server:8090
+# AGENT_SANDBOX_OPENSANDBOX_API_KEY=fastgpt-opensandbox-api-key
+# AGENT_SANDBOX_OPENSANDBOX_VOLUME_MANAGER_URL=http://fastgpt-volume-manager:3000
+# AGENT_SANDBOX_OPENSANDBOX_VOLUME_MANAGER_TOKEN=vmtoken
+x-volume-manager-auth-token: &x-volume-manager-auth-token "vmtoken"
+x-no-proxy-config: &x-no-proxy-config
+  # Avoid inherited proxy settings. Some Docker runtimes inject IPv6 CIDR into NO_PROXY,
+  # and httpx may parse it as an invalid URL port during OpenSandbox startup.
+  NO_PROXY: localhost,127.0.0.1,127.0.0.0/8,host.docker.internal,host.orb.internal,docker.orb.internal,*.orb.internal,*.orb.local,proxyproxy.orb.internal,gateway.orb.internal,fastgpt-opensandbox-server,fastgpt-volume-manager,fastgpt-app
+  no_proxy: localhost,127.0.0.1,127.0.0.0/8,host.docker.internal,host.orb.internal,docker.orb.internal,*.orb.internal,*.orb.local,proxyproxy.orb.internal,gateway.orb.internal,fastgpt-opensandbox-server,fastgpt-volume-manager,fastgpt-app
+services:
+  fastgpt-opensandbox-server:
+    image: registry.cn-hangzhou.aliyuncs.com/fastgpt/opensandbox-server:v0.1.9
+    container_name: fastgpt-opensandbox-server
+    restart: always
+    networks:
+      - app
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock
+    configs:
+      - source: opensandbox-config
+        target: /etc/opensandbox/config.toml
+    environment:
+      <<: [*x-no-proxy-config]
+      SANDBOX_CONFIG_PATH: /etc/opensandbox/config.toml
+    healthcheck:
+      test:
+        [
+          "CMD",
+          "python",
+          "-c",
+          "import urllib.request,sys; sys.exit(0 if urllib.request.urlopen('http://localhost:8090/health',timeout=3).status==200 else 1)"
+        ]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+  fastgpt-volume-manager:
+    image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-agent-volume-manager:v0.2.0
+    container_name: fastgpt-volume-manager
+    restart: always
+    networks:
+      - app
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock:ro
+    environment:
+      <<: [*x-no-proxy-config]
+      PORT: 3000
+      VM_RUNTIME: docker
+      VM_AUTH_TOKEN: *x-volume-manager-auth-token
+      VM_VOLUME_NAME_PREFIX: fastgpt-session
+      VM_LOG_LEVEL: info
+    healthcheck:
+      test:
+        [
+          'CMD',
+          'node',
+          '-e',
+          "fetch('http://localhost:3000/health').then((res) => { if (!res.ok) process.exit(1); }).catch(() => process.exit(1));"
+        ]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+  # Pre-pull only: not started by `docker compose up` (uses profile `prepull`).
+  opensandbox-agent-sandbox-image:
+    image: registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt-agent-sandbox:v0.2.0
+    profiles:
+      - prepull
+  opensandbox-execd-image:
+    image: sandbox-registry.cn-zhangjiakou.cr.aliyuncs.com/opensandbox/execd:v1.0.6
+    profiles:
+      - prepull
+  opensandbox-egress-image:
+    image: sandbox-registry.cn-zhangjiakou.cr.aliyuncs.com/opensandbox/egress:v1.0.1
+    profiles:
+      - prepull
+configs:
+  opensandbox-config:
+    content: |
+      [server]
+      host = "0.0.0.0"
+      port = 8090
+      api_key = "fastgpt-opensandbox-api-key"
+      log_level = "INFO"
+      [runtime]
+      type = "docker"
+      execd_image = "sandbox-registry.cn-zhangjiakou.cr.aliyuncs.com/opensandbox/execd:v1.0.6"
+      [egress]
+      image = "sandbox-registry.cn-zhangjiakou.cr.aliyuncs.com/opensandbox/egress:v1.0.1"
+      [docker]
+      network_mode = "bridge"
+      # When server runs in a container, set host_ip to the host's IP or hostname so bridge-mode endpoints are reachable.
+      host_ip = "host.docker.internal"
+      [ingress]
+      mode = "direct"
+networks:
+  app:
--- a/document/public/imgs/create-app.png
+++ b/document/public/imgs/create-app.png
--- a/document/public/imgs/create-app2.png
+++ b/document/public/imgs/create-app2.png
--- a/document/public/imgs/create-app3.png
+++ b/document/public/imgs/create-app3.png
--- a/document/public/imgs/create-app4.png
+++ b/document/public/imgs/create-app4.png
--- a/document/public/imgs/create-rep.png
+++ b/document/public/imgs/create-rep.png
--- a/document/public/imgs/upload-data.png
+++ b/document/public/imgs/upload-data.png
--- a/document/public/imgs/upload-data2.png
+++ b/document/public/imgs/upload-data2.png