ShareBox 发布：把 AI 智能体做的小工具像 Google Doc 一样分享

发布并分享由 AI 智能体构建的小型 Web 工具——就像分享 Google 文档一样简单。

English · Italiano

现在任何人都可以要求 AI 智能体做一个小工具——团队休假追踪器、表单、仪表盘。把它放到网上并安全地分享才是难点：托管、域名、HTTPS、登录、数据库、权限。

ShareBox 把这些全部省去。你的智能体构建工具，用一条命令发布；你得到一个链接，可以分享给特定的人、整个公司域，或任何拿到链接的人。访客使用 Google 登录。工具免费获得他们的姓名和邮箱，将数据存储在自己的数据库中，并在自己的沙箱中运行。

“为我的团队构建一个休假追踪器并发布它。” → 智能体编写它、发布它，并回复 https://vacation-tracker-k3x9.your-tools-domain.org → 你把它分享给 @yourcompany.com → 同事们打开它，用 Google 登录，然后添加他们的休假天数。

ShareBox 是自托管的：你在一个小型 Linux 服务器上运行自己的实例，使用你的域名、你的 Google 登录和你的用户。它独立于任何其他实例。

功能

一条命令发布，可从终端（sharebox publish）或直接通过内置的 MCP 服务器从 AI 智能体发布。每个工具都有自己的 HTTPS 地址；重新发布会更新同一个工具并保留其数据。
默认私有，像文档一样分享：特定的人（邮箱）、某个域的每个 Google Workspace 账户，或任何拿到链接的人——每种都可设为可使用或可管理。撤销会在下一次请求时立即生效。
Google 登录由平台处理：工具无需实现登录，即可获得可信身份（姓名、邮箱、角色）。
内置存储：每个工具都有自己的 SQLite 数据库。静态页面使用带有服务端权限的微型 SDK（sharebox.collection("vacations").add({...})）；带有服务端代码的工具可直接访问 SQL。
强隔离：每个工具都在自己的 gVisor 沙箱中运行，使用 workerd、自己的网络、只读代码以及 CPU/内存/进程限制。只有一个独立的小进程可以与 Docker 通信。
Web 仪表盘用于分享、状态、日志、活动、暂停和删除——还有可直接复制的命令，用于连接你的电脑和你的智能体。
每日备份，可选加密复制到 Google Drive。
便宜：运行在约 4 欧元/月的 VPS 上；工具的域名可以是免费的 DuckDNS 子域名。

工作原理

Internet ─▶ Caddy (HTTPS) ─▶ platform: Google login, permissions, API, dashboard, gateway
                                 │                         │
                                 │ internal network        │ one internal network per tool
                                 ▼                         ▼
                           orchestrator              gVisor sandbox + workerd (one per tool)
                           (only one with Docker)    static files, SDK, creator's worker, SQLite

对工具的每个请求都经过网关，网关检查会话和权限，剥离浏览器可能伪造的任何内容，并注入访客的身份。工具无法访问彼此、平台、主机或互联网。设计与理由：docs/architettura.md 以及 docs/adr/ 中的决策记录（意大利语）。

快速开始

你需要：一台 Ubuntu 24.04 服务器（2 GB 内存即可开始），80/443 端口空闲，一个用于平台的域名（例如 sharebox.example.com），一个用于工具的域名——免费的 DuckDNS 子域名或 Cloudflare 上的域名——以及一个 Google OAuth 客户端。

在服务器上，以 root 身份：

git clone https://github.com/zalaso/sharebox /opt/sharebox && cd /opt/sharebox && bash deploy/install.sh

安装程序会设置 Docker 和 gVisor，询问你的域名和凭据（密钥不会回显），检查 DNS、端口和防火墙，从源代码构建所有内容，启动它并安排每晚备份。

然后，在你的电脑上（Node 20+），安装 CLI 并连接它——你的浏览器会打开以确认：

npm install -g sharebox-cli

（每个实例还会生成一份与其自身版本匹配的副本：npm install -g https://sharebox.example.com/cli/sharebox.tgz。）

sharebox login sharebox.example.com

并为你的 agent 提供工具（此处以 Claude Code 为例；在 Windows 上使用 -- cmd /c sharebox mcp）：

claude mcp add --scope user sharebox -- sharebox mcp

分步指南，包括 DNS 和 Google 设置：docs/install.md。

构建工具

通过 MCP 连接的 agent 会读取内置指南（sharebox_guide）并知道该做什么。手动操作：

sharebox init vacation-tracker --name "Vacation tracker"   # starter with an SDK example
sharebox publish vacation-tracker                           # → https://vacation-tracker-xxxx.<tools domain>/
sharebox share vacation-tracker @yourcompany.com            # or a person's email, or "chiunque" (anyone)

工具是一个包含 public/（HTML、CSS、JS）的文件夹，并可选包含用于服务端代码的 worker.ts：

<script src="/__sharebox/sdk.js"></script>
<script>
  const me = await sharebox.me();                 // { email, name, role }
  const days = sharebox.collection("vacations");
  await days.add({ from: "2026-08-01", to: "2026-08-15" });
  const all = await days.list();                  // records with owner and canEdit
</script>

拥有 can use 权限的用户只能编辑自己的记录；can manage 可编辑所有内容——在服务端强制执行。完整 CLI 参考：docs/cli.md。

完整示例：examples/ferie——演示中的团队休假追踪器，由 agent 通过 MCP 构建：团队日历、带工作日计数的即将到来的缺勤（包含意大利公共假日）、年度汇总。纯 HTML/CSS/JS，无依赖。

状态

年轻项目，运行在作者的私有实例上。目前可用：发布、分享、存储、CLI、MCP、仪表盘、备份、自托管安装程序、CI。

已知限制和后续步骤：

界面（仪表盘、页面、CLI、安装程序）为英语和意大利语，根据浏览器或系统语言选择。欢迎其他语言：词典位于 packages/platform/src/messages.ts、packages/platform/dashboard/app.js、packages/runtime/src/messages.ts 和 packages/cli/src/i18n.ts。
单服务器：约 25 个工具同时在 2 GB 内存上运行；计划停止空闲工具。
工具尚不能调用外部 API（无互联网访问、无密钥）——已计划，置于出口代理之后。
仅支持使用 Google 登录；发布仅限于 CREATOR_EMAILS 中列出的电子邮件。

文档


安装你自己的实例 · Installazione	要求、DNS、Google、安装程序
运行实例	更新、管理、检查、备份（意大利语）
从备份恢复	（意大利语）
CLI 和 MCP	（意大利语）
架构和决策	（意大利语）

贡献

欢迎提交错误报告、想法和拉取请求——请参阅 CONTRIBUTING.md。请私下报告安全问题：SECURITY.md。

许可证

GNU AGPL v3 或更高版本。你可以使用、研究、修改和重新分发 ShareBox，包括运行服务；如果你在修改后的版本上运行服务，必须向用户提供你的更改。