Simple Host

Simple Host

打开 ChatGPT 插件。点击 添加，然后选择 添加自定义 MCP 服务。将其命名为 Simple Host，粘贴 https://simple-host.app/mcp，然后保存。在登录窗口中，使用 Google 或邮箱验证码登录，然后选择 允许。在聊天中，从 + 菜单选择 Simple Host，或者直接提问。

打开 Claude，然后依次选择 设置、连接器 和 浏览连接器。搜索 Simple Host，选择 连接，登录，然后选择 允许。它可在网页、桌面和手机上使用。Claude 还列有 Simple Host 插件（自定义 → 插件 → 发现），可一步添加连接器和技能。

让你的 AI 应用创建一个网站，它就会发布到专属地址 https://<site>.<handle>.simple-host.app/，并提供一个用于保存信息的位置（RSVP、投票、报名）。

• 试用： https://simple-host.app/
• 运行自己的实例 → https://simple-host.app/setup?product=small-box
• 功能： https://simple-host.app/features
• 架构： https://simple-host.app/architecture.html
• 面向 Agent 和开发者： llms.txt · OpenAPI 规范 · API 文档 · 在你的 AI 应用中开始使用
• 企业版： https://simple-host.app/enterprise · github.com/vineetu/simple-host-enterprise
• **在你的 Kubernetes 集群上部署企业版 → https://simple-host.app/setup?product=enterprise**（Helm 或 Kubernetes YAML；使用现有 Postgres 或集群内 Postgres）
• **企业版运行成本 → https://simple-host.app/costs**（按标价估算 AWS、Azure 和 Google Cloud 的费用，并根据你的团队人数计算）
• 法律与帮助： 条款 · 隐私 · 支持（[email protected]）

着陆页打开后会播放一段 25 秒的短片，由站点所有者旁白解说；点击即可开启声音：将 Simple Host 添加到你的 AI 中，要求它创建网站，然后分享链接。Simple Host 的应用页面采用统一的蓝色墨水主题，使用本地字体、易读的正文文本，并采用统一的系统浅色／深色设置。你发布的页面保留各自的样式。Small-box 安装将在下一版本中获得这一统一外观。

开始使用

将 Simple Host 连接到你自己的 AI 应用一次，然后让它构建并发布网站。Simple Host 会托管并管理生成的内容。

• **聊天应用：**添加连接器 https://simple-host.app/mcp，并在弹出的窗口中登录。打开对应应用的原生折叠面板（类似 #chatgpt 的哈希链接可直接打开）：入门页面。
• **编码 Agent：**使用 npx skills add vineetu/simple-host 安装技能。
• **Claude Code 插件：**运行 /plugin marketplace add vineetu/simple-host，然后运行 /plugin install simple-host@simple-host。

然后提出要求：“帮我创建一个婚礼 RSVP 页面并发布到网上。”

Simple Hack

**黑客马拉松，现在人人都能参加。**任何人都可以借助 AI 进行构建：描述你的想法，AI 就会构建团队网站。最佳创意胜出，而不是最优秀的编码者。组织者创建活动并分享一个链接。大学生、产品经理、领导者以及不会编程的人都可以参加。

开始使用 Simple Hack 介绍了如何将 https://simple-hack.app/mcp 添加到 ChatGPT、Claude、Grok、GitHub Copilot 或编码 Agent 中。在浏览器窗口中使用 Google 或邮箱验证码登录一次，然后选择 Allow。页面提供可复制的组织者、参与者和评委提示词、简短常见问题解答，以及折叠在“其他安装方式”中的现有下载文件和技能文件。

对于 Claude Code 和 Codex，请安装五个 Hack 技能（需要 Node.js），然后在你的 Agent 中添加 OAuth 连接器：

npx -y skills add https://github.com/vineetu/simple-host/tree/main/hack-toolkit --global --agent codex claude-code --yes

功能

发布与版本

• 一次调用即可发布一个文件夹（压缩包或内联文件）。每次发布都会生成一个新版本。
• 上线前先预览：发布时不立即上线，打开一个有效期为一小时的预览链接，然后再正式上线。
• 回滚到任何保留的版本。重命名站点后，旧链接仍然有效。
• 让站点下线，然后重新上线。不会删除任何内容。
• 删除后 7 天内可在「最近删除」中恢复。
• 下载任意站点的副本。公开站点或未列出的站点均可下载；未列出的站点不会显示在你的个人页面上，也不会出现在搜索引擎中，除非该站点拥有自己的域名或名称。
• 每个站点的访客分析数据来自服务器日志，包含热门页面和引荐域名。无需跟踪脚本。

地址与自定义域名

• 每个站点都有自己的地址和浏览器来源：<site>.<handle>.simple-host.app。
• 你的个人地址会打开公开展示页，或你选择的自有站点。
• 使用纯文本简介、置顶项目和手动排序来整理展示页；实时 JSON 订阅源会列出相同的可见项目。你的主页介绍了控制面板、连接器和小型设备安装方式。
• 免费的 <name>.simple-host.app，立即上线。
• 可使用你自己的域名、子域名或裸域名。添加一条 TXT 记录即可证明所有权；证书会自动签发。
• www 和裸域名会一起配置，其中一个会重定向到另一个。

保存的数据与列表

• 每个站点都有独立的保存数据：一个 JSON 文档，支持原子操作（设置、递增、追加、移除）。
• 访客可添加内容的列表：评论、RSVP、投票、报名。
• 每条保存的数据都有类型：共享（默认，公开）、页面信息（所有者可写，所有人可读）、提交内容（访客提交；默认仅所有者可见；每位访客只能查看、更改和撤回自己的内容；可选邮件摘要）、个人（每位访客一条私有记录）以及共享白板（群组成员可逐项编辑的列表）。
• 私有提交内容：只有已登录的访客才能添加；所有者可查看全部内容，每位访客只能查看自己的内容。
• 所有者可以删除任意列表中的条目、编辑私有列表中的条目、清空列表，并将列表下载为 CSV。保存数据的每项更改都可以在 30 天内撤销（历史记录、最近删除）。

访客登录

• 访客可在站点自己的地址上使用 Google 或通过邮件收到的验证码登录。
• 保存的内容会以该访客的身份提交。一次登录仅适用于一个站点。
• 页面可通过小型 auth.js 客户端处理登录。

你的账户、密钥与数据

• 通过邮件收到的验证码或 Google 登录。
• 命名 API 密钥：可逐个列出、创建和撤销。用于 CI 的仅部署密钥；密钥闲置 180 天后会停止工作。只需一步即可在所有位置退出登录。
• 更改登录邮箱，需通过新旧两个邮箱确认，并提供 7 天撤销期。
• 每次有新的登录或应用连接后都会收到邮件通知。可关闭此功能。
• 将所有数据下载为一个压缩包。永久删除你的账户。

面向 AI Agent

• 提供带登录功能的连接器（MCP），地址为 https://simple-host.app/mcp，可供聊天应用和 Agent 使用。
• 技能：website-deploy、website-deploy-builder、connect-domain。
• 提供 Claude 和 ChatGPT 插件，以及供编码 Agent 使用的 npx skills add vineetu/simple-host。
• llms.txt 和完整的 OpenAPI 规范。

运营工具

• 管理控制台：磁盘使用情况、运行中的发布版本、所有账户和站点、API 流量。
• 下架站点或暂停账户，而不删除任何内容；之后可恢复。
• 签发参与者账户。下载所有条目。

自托管、小型服务器、黑客马拉松

• 一个 Go 二进制文件、一个 Postgres 数据库、磁盘上的一个文件夹。可在 1 个 CPU 和 1 GB RAM 上运行。
• 为全新服务器提供 Docker Compose 安装方式（deploy/install/install.sh）。再次运行即可升级。
• Simple Hack：在 https://simple-hack.app/ 创建线上黑客马拉松，或在自己的服务器上运行同一活动平台。参与者通过向 AI 描述想法来构建团队网站，无需编写代码。
• 设置助手 https://simple-host.app/setup?product=small-box 会生成安装命令和设置；docs/advanced/ 介绍每项设置。

工作原理

1. 单个 Go 二进制文件为每个网站提供文件和 REST API。
2. Postgres 保存账户、网站、版本和已保存的数据。
3. 磁盘上的文件夹保存带版本的网站文件。

无需对象存储、CDN 或构建集群。详情请见：ARCHITECTURE.md 和架构页面。

运行自己的实例

在公司的 Kubernetes 集群上，请改用 Simple Host Enterprise；https://simple-host.app/costs 可估算在该集群上（AWS、Azure、Google Cloud）的费用。

docker run -d --name simple-host-postgres -p 5432:5432 -e POSTGRES_USER=simplehost -e POSTGRES_PASSWORD=simplehost -e POSTGRES_DB=simplehost postgres:16-alpine
docker exec -i simple-host-postgres psql -U simplehost -d simplehost < db/schema.sql
DB_DSN='postgres://simplehost:simplehost@localhost:5432/simplehost?sslmode=disable' DATA_DIR=./data/sites SITE_DOMAIN=localhost:8090 PUBLIC_BASE_URL=http://localhost:8090 ADMIN_API_KEY=$(openssl rand -hex 32) go run ./cmd/server

打开 http://localhost:8090，并使用 ADMIN_API_KEY（管理员密钥）登录。生产环境构建：

GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o ./simple-host ./cmd/server

配置和高级设置

必须设置 DB_DSN 和 ADMIN_API_KEY；其他所有设置都有默认值。https://simple-host.app/setup?product=small-box 上的设置助手会为小型服务器生成安装命令和 .env 文件。其问题、客户端验证、生成的设置和安装命令都在浏览器中运行。它不会询问密码或密钥，也不会将你的任何选择发送给模型。按类别列出的每项设置及其配置示例（更严格的登录、更短的保留期限、小型黑客马拉松服务器）：docs/advanced/。完整参考：docs/configuration.md。

API

需要身份验证的路由接受 X-API-Key: <key>。输入和输出均为 JSON。完整契约见 openapi.yaml；易读版见 docs.html。

端点	方法	描述
/v1/auth、/v1/auth/verify	POST	通过电子邮件验证码登录，并返回 API 密钥
/v1/sites	GET	列出你的网站
/v1/sites/{name}/files	POST / PUT	从 JSON 发布：{"files": {"index.html": "<h1>hi</h1>"}}
/v1/sites/{name}	POST / PUT / PATCH / DELETE	发布归档 / 新版本 / 重命名或下线 / 删除
/v1/sites/{name}/state	GET / PUT / PATCH	使用原子操作保存数据
/v1/sites/{name}/collections/{coll}	GET / POST	列表
/v1/sites/{name}/data/{name}	GET / POST / PUT / PATCH	按类型保存数据（页面信息、提交内容、个人数据、共享看板）；.../kind 用于声明类型
/v1/me/keys	GET / POST / DELETE	命名 API 密钥、仅供 CI 部署使用的密钥
/v1/sites/{name}/domain	POST / GET / DELETE	你自己的域名

参与此代码库的开发

• CLAUDE.md：工作规范、构建、测试和部署。
• INTENT.md：用途以及带日期的决策。
• FEATURES.md：每项功能及其涉及的所有部分。
• ARCHITECTURE.md：组件、请求流程、数据模型。
• CHANGELOG.md：变更记录，最新的列在最前。
• make check：格式检查、构建、静态检查、测试和文档同步检查。
• 技能源文件：simple-host-website/skills/。plugins/simple-host/ 中的 Claude 插件是生成的副本（bash scripts/sync-claude-plugin.sh）。

许可证

MIT。详见 LICENSE。