Files
DPM/backend/vendor/s2s-cloud/demo/docs/adr/0001-docker-space-with-search-proxy.md
T
Pine 7f25c8f6bb refactor(backend): 启动环境初始化与资源项目化(零跨项目依赖)
- main.py:uv run main.py 一键启动——读取 backend/.env、TORCH_HOME/NLTK_DATA 指向项目内缓存、certifi SSL + NO_PROXY 网络直连、默认开启 s2s,启动横幅
- vendor/:补丁后 s2s 云化栈移入项目(backend/vendor/s2s-cloud),pyproject sources 改相对路径
- .gitignore:忽略 .torch-cache / nltk_data 缓存
- AGENTS.md:进程管理铁律(AI 不启动/重启服务,由用户操作)
2026-08-18 01:37:57 +08:00

1.6 KiB

Convert the static Space into a Docker app with a search proxy

To give the model a web search tool, the executor (which runs in the browser of a public Space) needs a search key. A sdk: static Space serves files as-is with no runtime process, so it cannot hold a secret the browser uses without exposing it. We convert the Space from sdk: static to sdk: docker: a single container runs a small server (FastAPI + uvicorn) that both serves the existing front-end unchanged and exposes a same-origin /search proxy holding SERPER_API_KEY server-side. The whole app lives in that one container; the s2s speech-to-speech backend stays the separate load-balanced service it already is.

Considered options

  • Stay static, user-supplied key only — no owner key; search works only if each user pastes their own. Rejected as the default because it leaves the deployed demo with no working search.
  • Separate proxy service — same secrecy, but splits the app across two deploys. Rejected: the app must live in one container.
  • Key baked into client JS at build time — would be readable in the served bundle. Rejected: defeats the point.

Consequences

  • Deployment is no longer static: there is a Dockerfile and a server process; the README front-matter changes from sdk: static to sdk: docker.
  • The client calls /search same-origin; the server reads the key from env. A user may still supply their own key as a fallback, sent per-request to the proxy.
  • The front-end, audio pipeline, and s2s handshake are untouched — only the hosting shape and the new route are added.