云端容器空间一键部署 nanobot：Dockerfile + OAuth

[DreamShepherd2006]

nanobot 很棒，但目前使用门槛不低：需要会终端、会 pip install、会写 config.json。这让它很难触达非技术用户——比如家人朋友、或者想在公司内部部署一个团队 bot 的场景。

我最近实践了一种方式：把 nanobot 打包成 Docker 镜像，跑在免费的云端容器空间上，用户只需打开链接、扫码就能用。

怎么做

Dockerfile 一键构建

FROM python:3.12-slim
RUN pip install git+https://github.com/HKUDS/nanobot.git@nightly
RUN pip install git+https://github.com/DreamShepherd2006/cloud-agent-gateway.git@v0.1.10
CMD python3 -m cloud_agent_gateway

把这段 Dockerfile 推到 HuggingFace Spaces 或 ModelScope Studio，平台自动构建运行，30 秒后拿到一个可访问的链接。

OAuth 登录 —— 零配置

传统方式：用户得自己配 provider + API key + model → 写 config.json。非技术人员直接劝退。

在有 OAuth 机制的平台上（HF / ModelScope），用户打开空间链接 → 用平台账号登录 → 自动完成认证，直接进入 nanobot WebUI。API key 由部署者预填在环境变量里，用户完全无感。

用户打开链接 → OAuth 登录 → nanobot WebUI

通道绑定 —— 扫码即用

登录后侧边栏有配置入口：

• 📱 WeChat：扫码绑定 → 凭证自动持久化 → 通道自动重连
• 🐧 QQ / 🕊️ Feishu / 📌 DingTalk：输入凭证即可

不需要 SSH 进去改 config.json，不需要重启容器。绑定信息存持久卷，容器重建不丢。

平台适配

nanobot 在不同云平台上会遭遇各种"魔障"——HF 的代理层、ModelScope 的 Header 剥离、SSRF 防火墙……通过一个薄适配层统一处理，不修改 nanobot 核心代码，同时补充容器环境下缺失的用户文件管理能力。

线上演示

两个空间的 nanobot 版本一致，功能相同：

平台	地址
HuggingFace	https://huggingface.co/spaces/DreamShepherd/hf-cloud-nanobot
ModelScope	https://modelscope.cn/studios/DreamShepherd/ms-nanobot-cloud-test1/summary

完整代码：cloud-agent-gateway

目前已做到什么程度

流程已经简化到了 申请空间 → 上传一个 Dockerfile → 完成：

1. 用户在 HuggingFace 或 ModelScope 创建一个空白空间
2. 上传一个 Dockerfile（就一个文件）
3. 空间自动构建，拿到链接
4. 打开链接 → OAuth 登录 → 进入 nanobot WebUI
5. 侧边栏扫码绑定微信/QQ/飞书/钉钉，就能在聊天软件里用

不需要进终端、不需要装 Python、不需要写 config.json。整个过程 5 分钟以内。

想听听大家的看法，欢迎各位大神拍砖吐槽

1. 你们给非技术用户（家人、朋友）部署过 nanobot 吗？ 踩过什么坑？终端、pip、config.json 这些门槛怎么跨过去的？还是说根本不考虑这个场景？

2. 云端（或非本地）部署遇到过哪些坑？ HF Spaces / ModelScope / Railway / 自己的 VPS……不同平台有什么奇葩问题？SSRF、Header 剥离、WebSocket 断开——有没有什么巧妙的解法？

3. 除了本地 pip install，你们还用什么方式跑 nanobot？ Docker？Podman？二进制打包？systemd？有什么推荐的最佳实践？

欢迎分享自己的部署经验，不一定非要云端——哪怕是在树莓派上跑、给爸妈用，也想听听 🙏