01 / 服务器
Bare metal,
交给 Hoody
来自 OVHcloud 和 Hetzner 的 Bare metal 服务器,由 Hoody 全权运营。安全更新和内核更新由 Hoody 负责,你不需要服务商账号,也不用设置服务器。
Explore the infrastructure ↗@https://hoody.com Connect to Hoody开发者模式
我们说得很直白。下面是 Hoody 的具体样子。
现在每个板块都直接展示 Hoody 到底是什么:链接、调用和限额。所有构件都收录在首页的索引里。你的 AI 能把它们组合出无数种用法。
电脑 + Kit
每个工具一个链接
选一个工具,链接随之变化
https://p7-c2-terminal-1.n12.computers.hoody.com
p7项目c2电脑terminal工具1实例n12服务器
开发者模式
https://{p}-{c}-{tool}-{n}.{node}.computers.hoody.com 项目 ID、电脑 ID、工具、实例、服务器;每一段都可以单独读取或替换docs / foundation / projects-computershttps://{p}-{c}-http-8080.{node}.computers.hoody.com 8080 端口上的网站或应用,已含 HTTPShoody computers list列:ID NAME STATUS IMAGE CREATEDGET https://api.hoody.com/api/v1/computers/{id} 返回 project_id、id 和 server_name,也就是每个链接的组成部分服务器、电脑、Kit
1Free 服务器:地域偏好,视容量而定
+下一台服务器:选择地域
地域地域偏好,视容量而定
一台共享机器的一部分
3 台电脑
地域美国东部
一台共享机器的一部分,仅限付费用户
12 台电脑
地域芬兰
一台共享机器的一部分,仅限付费用户
30 台电脑
地域新加坡
一整台机器,只属于你
服务器放得下多少台,就有多少台
展开一台电脑每台电脑都有这些
Kit
你的每台电脑内部
Debian 13 · systemd 服务 · 独立的文件、网络和进程 · 保留状态
01 / 在里面工作
02 / 构建与运行
03 / 数据与网络
04 / 链接如何到达你的应用
每个链接都经过 Hoody 代理,它与你的电脑位于同一台服务器上。它加上 HTTPS,检查谁可以进入,再把请求交给里面的工具或应用。
http-3000 是你自己的应用,在电脑内部监听 3000 端口。换成别的数字,就是另一个应用:http-5000、http-8000。
对外始终是 443 端口上的 HTTPS。代理把每次访问交给你的端口。
docs / proxy ↗它与电脑运行在同一台服务器上,没有额外的网络跳转,流量留在这台服务器内。证书会自动签发并续期。
支持 HTTP/1.1、HTTP/2 和 WebSocket(实时终端和桌面都用它),服务器支持时还有 HTTP/3。
docs / concepts / proxy ↗对于由 Hoody 代理直接路由的外部请求,你的应用看到的是每位访客的真实 IP 地址,就像中间没有代理一样。无需读取 X-Forwarded-For 请求头。
这在服务器内核中完成,所以任何程序,包括老旧软件,都能对访客记录日志、限速和封禁。无需配置。通过代理钩子转发的请求,显示的是钩子的连接地址。来自 Hoody 电脑的调用,源地址可能不同。
docs / concepts / proxy ↗用密码、登录令牌或允许的 IP 地址列表锁定任意链接,可以锁整个项目,也可以只锁一台电脑。
docs / proxy / permissions ↗脚本最先看到每个请求:检查、修改、直接应答,或放行。它只在你自己的 Exec 里运行,从不和别人的 Exec 混在一起。
docs / proxy / hooks ↗给工具或应用起一个短名称,例如 my-api.n12.computers.hoody.com,或者把你自己的域名指向它。证书会自动签发并续期。
docs / proxy / your domain ↗让笔记本电脑上运行的应用出现在电脑的公开链接上,或让你的电脑访问笔记本电脑上的服务。
笔记本电脑主动向外连接,从不接受入站连接,也没有 DNS、证书或注册步骤。
docs / kit / tunnel ↗另一个方向,与上面的代理无关:你的电脑发出的请求,可以经由你选择的上游 SOCKS5 或 HTTP 代理出去,以改变请求来源的 IP。
docs / kit / egress ↗里面还能运行
Docker、Compose 和 Buildx 随开发套件一起提供,开发套件默认开启。Kind、K3s 和 Minikube 可运行完整的 Kubernetes 集群,Podman 也可以使用。
每台服务器都有。
docs / computers / images ↗开启 KVM,就能在你的一台电脑里启动另一个操作系统或内核。
只在你租用的专用 Bare metal 服务器上提供。默认关闭,Free 方案不提供。
docs / servers / virtual machines ↗每台服务器仅限专用 Bare metal
开发者模式
https://{p}-{c}-http-3000.{node}.computers.hoody.com http-{port} 路由到该端口上的应用;对外是 443 端口的 HTTPSdocs / foundation / proxyreq.socket.remoteAddress在 Node 中是访客的 IP;在 Exec 脚本中是 metadata.clientIpdocs / concepts / proxyPOST https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/execute body {"command": "docker ps", "wait": true}docs / kit / terminalsPUT https://api.hoody.com/api/v1/computers/{id}/kvm body {"kvm": true};电脑需处于停止状态,仅限专用服务器docs / foundation / servers / virtual-machines你工作的底层基础
Hoody 运行基础设施,并提供工具让你的工作在其中持续运行。构建网站、应用和工作流,不必照看服务器。
01 / 服务器
来自 OVHcloud 和 Hetzner 的 Bare metal 服务器,由 Hoody 全权运营。安全更新和内核更新由 Hoody 负责,你不需要服务商账号,也不用设置服务器。
Explore the infrastructure ↗02 / 其上的电脑
电脑内部
终端、文件、浏览器、数据和你的 AI,都已在电脑里。打开服务的链接即可使用。各服务使用同一套权限模型。
选择“查看”即可看到示例。
每个链接同时也是 API。
你的 AI 也能使用。
{p} 项目 ·{c} 电脑 ·{node} 服务器链接格式,ID 为占位符运行命令,并分享一个持久的 shell 会话。
https://{p}-{c}-terminal-1.{node}.computers.hoody.com POST /api/v1/terminal/execute示例 运行命令
在你的电脑上运行 npm test,并返回它的输出。
在 dev-box 上运行测试,告诉我哪些失败了。
hoody terminal commands run -c {c} \
--ephemeral \
--command "npm test"import { HoodyClient } from 'hoody-sdk';
const hoody = new HoodyClient({ baseURL: 'https://api.hoody.com', token: process.env.HOODY_TOKEN });
const box = await hoody.withComputer('{c}');
const out = await box.terminal.run('npm test');
console.log(out.stdout);import requests
r = requests.post(
"https://{p}-{c}-terminal-0.{node}.computers.hoody.com/api/v1/terminal/execute?ephemeral=true",
json={"command": "npm test"},
)
print(r.json())BASE="https://{p}-{c}-terminal-0.{node}.computers.hoody.com"
curl -X POST "$BASE/api/v1/terminal/execute?ephemeral=true" \
-H "Content-Type: application/json" \
-d '{"command": "npm test"}'curl -X POST "https://{p}-{c}-terminal-0.{node}.computers.hoody.com/api/v1/terminal/execute?ephemeral=true" \
-H "Content-Type: application/json" \
-d '{"command": "npm test"}'import requests
r = requests.post(
"https://{p}-{c}-terminal-0.{node}.computers.hoody.com/api/v1/terminal/execute?ephemeral=true",
json={"command": "npm test"},
)
print(r.json())https://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/request?url=https://{p}-{c}-terminal-0.{node}.computers.hoody.com/api/v1/terminal/execute?ephemeral=true&method=POST&json={"command":"npm%20test"}&response=transparent在浏览器里打开 Linux 应用。
https://{p}-{c}-display-1.{node}.computers.hoody.com GET /api/v1/display/screenshot用 HTTP 控制 Chromium 或 Firefox。
https://{p}-{c}-browser-1.{node}.computers.hoody.com GET /api/v1/browser/snapshot在浏览器标签页里使用 VS Code。
https://{p}-{c}-code-1.{node}.computers.hoody.com https://{p}-{c}-code-1.{node}.computers.hoody.com/?folder=<path>1 export function greet() { 2 return "Hello"; 3 }
用链接浏览、编辑和下载你的文件。
https://{p}-{c}-files-1.{node}.computers.hoody.com GET /api/v1/files/{path}用 HTTP 查询 SQL 数据库和键值数据。
https://{p}-{c}-sqlite-1.{node}.computers.hoody.com POST /api/v1/sqlite/dbSELECT title FROM notes;
示例 查询数据库
从商店数据库取出前 10 笔订单。
给我看看我的商店数据库里的 10 笔订单。
hoody db transactions run -c {c} \
--db shop \
--transaction '[{"query":"SELECT * FROM orders LIMIT 10"}]'import { HoodyClient } from 'hoody-sdk';
const hoody = new HoodyClient({ baseURL: 'https://api.hoody.com', token: process.env.HOODY_TOKEN });
const box = await hoody.withComputer('{c}');
const { data } = await box.sqlite.sql.runTransaction(
{ transaction: [{ query: 'SELECT * FROM orders LIMIT 10' }] },
{ db: 'shop' },
);import requests
r = requests.post(
"https://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/db?db=shop",
json={"transaction": [{"query": "SELECT * FROM orders LIMIT 10"}]},
)
print(r.json())BASE="https://{p}-{c}-sqlite-1.{node}.computers.hoody.com"
curl -X POST "$BASE/api/v1/sqlite/db?db=shop" \
-H "Content-Type: application/json" \
-d '{"transaction": [{"query": "SELECT * FROM orders LIMIT 10"}]}'curl -X POST "https://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/db?db=shop" \
-H "Content-Type: application/json" \
-d '{"transaction": [{"query": "SELECT * FROM orders LIMIT 10"}]}'import requests
r = requests.post(
"https://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/db?db=shop",
json={"transaction": [{"query": "SELECT * FROM orders LIMIT 10"}]},
)
print(r.json())https://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/request?url=https://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/db?db=shop&method=POST&json={"transaction":[{"query":"SELECT%20*%20FROM%20orders%20LIMIT%2010"}]}&response=transparent把 JavaScript 或 TypeScript 文件变成 HTTP 端点。
https://{p}-{c}-exec-1.{node}.computers.hoody.com/{script} GET /{script}// @mode serverless
return { message: "Hello" };示例 脚本变成 URL
保存一个小脚本,它在自己的网址上响应。
帮我做一个 hello 端点,按名字问候调用它的人。
hoody exec scripts write -c {c} \
--path api/hello.js \
--content '// @mode serverless
return { hello: metadata.query.name || "World" };'
# live at https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/helloimport { HoodyClient } from 'hoody-sdk';
const hoody = new HoodyClient({ baseURL: 'https://api.hoody.com', token: process.env.HOODY_TOKEN });
const box = await hoody.withComputer('{c}');
await box.exec.scripts.write({
path: 'api/hello.js',
content: '// @mode serverless\nreturn { hello: metadata.query.name || "World" };',
});import requests
r = requests.post(
"https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/scripts/write",
json={
"path": "api/hello.js",
"content": "// @mode serverless\nreturn { hello: metadata.query.name || \"World\" };",
},
)
print(r.json())
# then call it
print(requests.get("https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/hello", params={"name": "Ada"}).json())BASE="https://{p}-{c}-exec-1.{node}.computers.hoody.com"
curl -X POST "$BASE/api/v1/exec/scripts/write" \
-H "Content-Type: application/json" \
-d '{"path": "api/hello.js", "content": "// @mode serverless\nreturn { hello: metadata.query.name || \"World\" };"}'
# then call it
curl "$BASE/api/hello?name=Ada"curl -X POST "https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/scripts/write" \
-H "Content-Type: application/json" \
-d '{"path": "api/hello.js", "content": "// @mode serverless\nreturn { hello: metadata.query.name || \"World\" };"}'
# then call it
curl "https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/hello?name=Ada"import requests
r = requests.post(
"https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/scripts/write",
json={
"path": "api/hello.js",
"content": "// @mode serverless\nreturn { hello: metadata.query.name || \"World\" };",
},
)
print(r.json())
# then call it
print(requests.get("https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/hello", params={"name": "Ada"}).json())https://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/request?url=https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/scripts/write&method=POST&json={"path":"api/hello.js","content":"//%20@mode%20serverless\nreturn%20{%20hello:%20metadata.query.name%20||%20\"World\"%20};"}&response=transparent在网页、SSH 或 CLI 中使用同一个 AI 会话。
https://{p}-{c}-agent-1.{node}.computers.hoody.com hoody agent prompt "<task>" -c <id>把 HTTP 请求做成可分享或可按计划运行的链接。
https://{p}-{c}-curl-1.{node}.computers.hoody.com POST /api/v1/curl/request让服务和 worker 持续运行,并自动重启。
https://{p}-{c}-daemon-1.{node}.computers.hoody.com POST /api/v1/daemon/programs/add示例 保持程序运行
让你的 Node 应用持续运行,重启后自动再次启动。
让 /home/user/app 里的 Node 应用保持运行,重启后也一样。
hoody daemon programs create -c {c} \
--name web \
--command "node server.js" \
--directory /home/user/app \
--user user \
--bootimport { HoodyClient } from 'hoody-sdk';
const hoody = new HoodyClient({ baseURL: 'https://api.hoody.com', token: process.env.HOODY_TOKEN });
const box = await hoody.withComputer('{c}');
await box.daemon.programs.create({
name: 'web',
command: 'node server.js',
directory: '/home/user/app',
user: 'user',
boot: true,
});import requests
r = requests.post(
"https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/add",
json={
"name": "web",
"command": "node server.js",
"directory": "/home/user/app",
"user": "user",
"boot": True,
},
)
print(r.json())BASE="https://{p}-{c}-daemon-1.{node}.computers.hoody.com"
curl -X POST "$BASE/api/v1/daemon/programs/add" \
-H "Content-Type: application/json" \
-d '{"name": "web", "command": "node server.js", "directory": "/home/user/app", "user": "user", "boot": true}'curl -X POST "https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/add" \
-H "Content-Type: application/json" \
-d '{"name": "web", "command": "node server.js", "directory": "/home/user/app", "user": "user", "boot": true}'import requests
r = requests.post(
"https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/add",
json={
"name": "web",
"command": "node server.js",
"directory": "/home/user/app",
"user": "user",
"boot": True,
},
)
print(r.json())https://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/request?url=https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/add&method=POST&json={"name":"web","command":"node%20server.js","directory":"/home/user/app","user":"user","boot":true}&response=transparent定时执行命令,可设置任务过期时间。
https://{p}-{c}-cron-1.{node}.computers.hoody.com POST /api/v1/cron/users/{user}/entries0 9 * * * /root/project/report.sh
发送桌面提醒,或转发到已打开的浏览器页面。
https://{p}-{c}-n-1.{node}.computers.hoody.com POST /api/v1/notifications/notify浏览器转发需要权限,且页面必须已打开并连接。
用命名链接在设备之间传输字节流。
https://{p}-{c}-pipe-1.{node}.computers.hoody.com/api/v1/pipe/{name} PUT /api/v1/pipe/{name} · GET to receive把你的电脑当作代理,或设置上游代理。
https://{p}-{c}-egress-1.{node}.computers.hoody.com GET /api/v1/egress/upstream开放本地 Web 应用,或访问本地 TCP 服务。
https://{p}-{c}-tunnel-1.{node}.computers.hoody.com https://{p}-{c}-http-{port}.{node}.computers.hoody.comlocalhost:3000http-3000限制守护进程:文件只读、端口和进程限制、独立防火墙。
https://{p}-{c}-daemon-1.{node}.computers.hoody.com POST /api/v1/daemon/programs/edit/{id}/data443256 MiB大多数服务在首次打开时启动。程序限制属于守护进程。另外包含:笔记、监视、运行和代理日志。
docs / kit从想法到请求
同一个操作,可以通过 HTTP、在终端里或用 TypeScript 完成。也可以直接说出需求,让你的 AI 去调用。
在你的电脑上运行命令,返回命令的输出和退出码。
POST https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/execute
Content-Type: application/json
{
"command": "ls -la /app",
"wait": true
}
在终端 1 中运行。响应包含命令输出。
docs / kit / terminals ↗把 {p}、{c} 和 {node} 替换为你的项目 ID、电脑 ID 和服务器名称。Kit 请求使用你配置的代理凭据。
Account API requests use Authorization: Bearer <token>.
Service requests use your link's proxy permissions.docs / proxy / permissions ↗或者直接问你的 AI
在我的 Hoody 电脑上运行 ls -la /app,并把输出给我看。
Hoody AI(免费)已内置。你也可以使用 ChatGPT 方案(通过 Codex 登录)或 Claude Pro 或 Max。Give your AI the Hoody Skill ↗
你的规则,在正确的层级执行
你的智能体可以通过 API 配置权限。说明谁可以访问、能使用哪些电脑、能做什么。只把 Bot 分享给你信任、能操控它们的人和应用。为每个人或应用分配一个命名的 API Key,可以暂停、设置过期时间、按 IPv4 限制或撤销。
免费开始,不需要银行卡:内置 Hoody AI,你已经在用的 AI 也能用。
npx skills add https://hoody.com/SKILLS/SKILL.mdnpx skills add HoodyNetwork/hoody-sdk第二条会把所有文档页面保存到磁盘,供离线使用。npm install -g hoody-sdkcurl -fsSL https://install.hoody.com | sh第二条适用于 Linux 和 macOS。不安装也可以:npx hoody-sdk <command>npm install hoody-sdkTypeScript。支持 Node.js 20.19 及以上版本、Bun 和 Deno。curl -H "Authorization: Bearer <token>" https://api.hoody.com/api/v1/computers/<script src="https://cdn.jsdelivr.net/npm/hoody-sdk/dist/hoody-sdk.browser.min.js"></script>提供 window.HoodySDK。生产环境中固定版本,并给页面短期、限定范围的令牌。回答来自常见问题和功能索引。任何消息都不会离开此页面。
hoody / 我们的故事
应用级 VPN、能对抗指纹识别的隔离浏览环境、SOCKS5 代理。20 人团队,融资 $3.2M。经验是:真正的隐私需要完全隔离,所以选择了隔离环境。
让模型在端到端测试的循环里工作:编写、测试、失败、修复,再来一轮。每个核心系统都是这样构建的。
跨代码仓库的验证链,以及匿名的 AI 网关,因为推理同样应该有隐私。
Hoody AI 获得 Product Hunt 本周产品 #2,50,000+ 人注册。而在底层,他们已经在使用我们的隔离环境基础设施。
我们转而专注于底层的一切。20 人的团队缩减为 3 位创始人,数百个智能体成了长期的主力。
用 HTTP 和浏览器构建的底层进入了测试版。我们的网站、文档和监控也迁到了 Hoody 上。
稳定版发布。Hoody、SDK 和 CLI 上的测试版标签已移除。