Puter 的浏览器桌面:窗口、文件管理器、应用和小部件都在一个网页里

介绍

AGPL-3.0 协议,TypeScript 写的,四万四千多星。它的自我介绍挺狂:一个跑在浏览器里的"桌面操作系统",顺便给你一块自己的云。【想在自己机器上有个又能存文件、又能开应用的网页桌面,又不想把资料交给别人的话,自托管一个 Puter 是最省事的入口】

本地跑起来门槛不高,但要 Node 24 以上:clone 完 npm install、npm start,浏览器开 http://puter.localhost:4100,就出现一个带开始菜单、文件管理器、记事本、终端、图片查看器的桌面。窗口能拖能叠,右键有菜单,双击文件用对应应用打开,用起来是真的"像那么回事"。

更有意思的是自托管。官方给了行脚本:curl -fsSL https://puter.com/selfhost | sh,Windows 是 irm https://puter.com/selfhost?os=windows | iex,跑完进目录 docker compose up -d,起来的是 caddy、puter 主服务、mariadb、valkey、dynamodb-local、rustfs 存储,外加一个初始化容器,一共七个。加 --profile ai 会再拉一份 ollama 塞个 tinyllama,加 --profile smtp 才算能发注册邮件。

坑也基本都在这块:它不开在根路径,而是给每个用户分 用户名.你的域名 这种子域,所以域名必须配通配符解析,HTTPS 要通配符证书,caddy 的 auto_https 还得关掉、证书自己放进 ./puter/tls/;反代不能改写 Host 头,domain 必须等于外部域名,否则直接甩一句 "Invalid Host header"。第一次进后台的临时密码这么找:docker compose logs puter | grep "password for admin"。

默认每个账号 100MB 存储,下载量按每月 0.5 美元折算,超了前端报 insufficient_funds,自己用可以开 unlimitedMetering: true。安全上默认开了工作量证明验证码、密码至少 12 位、弱口令库比对、180 天不登录算休眠,也能直接关掉注册。

代码结构值得多看一眼:Controller–Service–Repository 三层加依赖注入,请求上下文靠 AsyncLocalStorage 传,扩展可以挂在任意一层,不是前端套个壳的那种项目。

特征

🖥️ 浏览器里的完整桌面,窗口拖动、右键菜单、任务栏齐全
📁 自带文件管理器、云端存储和公开分享链接
🧩 应用生态开放,能自己写扩展挂到任意一层
🐳 一行自托管脚本,compose 起七个容器
🤖 --profile ai 附带本地 ollama 小模型
🛡️ 工作量证明验证码、弱口令检测、休眠策略默认开启
🔐 多租户子域隔离,用户之间数据分开
📦 支持 MariaDB、Valkey、DynamoDB、S3 兼容存储
🧪 架构分 Controller–Service–Repository,AsyncLocalStorage 传上下文
🌍 官方托管版可直接先试再本地部署

开源地址