跳转到内容

自部署 Web

自部署 Web 来自开源 PromptHub 项目,由你维护服务器和数据。它不是官网的 PromptHub Cloud,账号、凭据和备份也相互独立。

在 NAS、VPS 或本机部署。浏览器中可管理 Prompt、Folder、Skills、MCP、Plugins、Rules 与媒体,进行资源编辑、版本管理及完整包导入导出。浏览器不能扫描你的电脑或把资源分发到本机 Agent。

在检出的 PromptHub v0.6.2 源码中执行:

Terminal window
cd apps/web
cp .env.example .env

先编辑 .env,设置自己的 JWT_SECRET 和持久化配置,再启动服务:

Terminal window
docker compose up -d --build
  • JWT_SECRET:使用至少 32 位的随机值。
  • ALLOW_REGISTRATION=false:初始化后不要开放不需要的公开注册。
  • DATA_ROOT:确认数据根目录及容器持久化挂载,保留 data、config、logs、backups。

默认访问 http://localhost:3871,首次进入 /setup 创建管理员。公网访问使用 HTTPS。完整部署参数以该版本部署指南为准。

在桌面设置的数据页面选择 Self-Hosted PromptHub,填写地址、用户名和密码,测试连接及备份能力。服务器与桌面必须完全同版本。

手动或自动备份创建独立快照,不替换服务器在线工作区;启动和定时任务只上传。恢复需要主动确认,并先创建本地安全快照。更多内容见备份与恢复。

实验方案使用 Workers 运行 API、D1 保存数据与同步元数据、R2 保存媒体和资源。它仍有旧 live-sync API;在备份专用 /api/backups/desktop 能力补齐前,不能作为新版桌面端的安全快照备份目标。

需要评估该方案时先看对应版本指南,不要把 Node 自部署版的全部能力直接套用到 Workers。

升级前备份持久化目录,先确认目标版本和恢复步骤;不要只备份数据库而漏掉 Skill、Plugin 包及图片。密钥和私有部署配置不提交到公开仓库。