CI PyPI Python MIT

交出一个 HTML 文件,
拿回一个真正的网站。

自部署、一条命令的 HTML 发布工具。发布、版本回滚、浏览器里直接改、 SQLite、PostgreSQL、MySQL 8.4+、Supabase 四种数据库, 加上亮暗主题管理工作台。v0.9.7,让页面和数据一起落地。

~/reports
$ pip install html-golive
$ golive publish q3-report.html --slug q3-report

🔍 扫描凭证与隐私… 干净
🎨 样式:minimal · 资源已内联(4 → 1 个文件)
📦 已发布

   短域名    q3-report
   地址      http://localhost:8787/q3-report
   大小      86 KB · 已存快照 #1

为什么会有这个工具

你手上有个 HTML 文件——一份报告、一个看板、一个内部小工具——需要挂到 一个同事能打开的地址上。常见的两条路:要么用碰不到你数据的云平台, 要么起一个只当文件服务器的裸 nginx。html-golive 走中间:自己跑起来, 数据不出内网,同时该有的便利一样不少。

🔒

数据留在你这儿

完整跑在你自己的机器或服务器上。不用注册账号,没有埋点,默认零外呼——断网环境照样能用。

🪶

零配置起步

安装后即可使用本地文件系统与 SQLite,无须先开数据库服务或对象存储。

📈

跟着你一起长大

SQLite、PostgreSQL、MySQL、Supabase 通过配置切换;HTML 另存本地、Supabase Storage 或 S3 兼容存储。

你会得到什么

下面这些都在安装包里——装一次,不用再去找插件。

🚀

发布与回滚

每次发布都会给上一版存快照,golive rollback 随时退回任意一版。

✏️

在浏览器里改

owner 和 maintainer 能在线上页面直接编辑——改个错别字不用回去动源文件。保存同样会扫描并存快照。

🗄️

给静态页面的数据库

window.TemplateAPI 提供统一 CRUD。SQLite / PG / MySQL 经服务端代理,Supabase 公开密钥通过 RLS 限定权限。

🛡️

凭证扫描

上线前用规则识别 API key、token 和个人信息,还可以选择让大模型再复核一遍。

🎨

19 套内置样式

--style 把一份没有样式的文档变得能见人。字体走公共 CDN 或你自己的镜像。

🧑‍💼

管理后台

/admin 支持亮暗主题、中英双语、全局参数修改、站点权限、数据管理和准确的数据库连接诊断。

🔑

真实的身份认证

图快用静态 token,正式环境走 OIDC——Google、Auth0、Okta、Azure AD、Keycloak、Authentik 都有一行预设。

🕸️

克隆任意页面

golive clone <url> 抓取一个公开页面,内联它的资源,再作为你自己的站点重新发布。

🐳

开箱即用的 Docker

提供 Dockerfile 和 compose 文件(含可选 MinIO profile),一条命令从零到服务跑起来。

管理工作台

亮暗主题、中英双语、可修改的全局参数,以及四种数据库的连接诊断。

管理工作台

快速开始

三步,大约一分钟。开始之前不需要写任何配置文件。

安装

需要 Python 3.9+。MySQL 安装 html-golive[mysql],PostgreSQL 安装 html-golive[postgres]。

$ pip install html-golive

发布一个页面

指向任意 HTML 文件即可。它会扫描凭证、套用样式、内联资源并登记站点。

$ golive publish report.html --style minimal

把它跑起来

本地验证请显式监听 127.0.0.1。配置可能改变默认监听地址;需要共享时再设置访问控制。

$ golive serve --host 127.0.0.1 --port 8787 🚀 http://localhost:8787/ · 管理后台:/admin

架构

三层可插拔接口。从左边这列起步,撑不住了再往右换——你的命令和你的页面 都不用改。

存储

  • local 本地文件系统(默认)
  • supabase storage bucket
  • s3 MinIO / COS / OSS / TOS

注册表

  • sqlite 单文件(默认)
  • postgres / mysql 服务端 DSN
  • supabase PostgREST 表

数据层

  • sqlite / postgres / mysql 服务端代理
  • supabase 页面直连,GRANT + RLS
  • none 可选关闭数据层

身份

  • none 仅本机访问
  • token 共享令牌
  • oidc Google、Okta、Keycloak…

在 WorkBuddy 里验证 MySQL

固定安装 v0.9.7,初始化专用测试库,再通过浏览器和 SQL 确认页面数据真实落库。

python3 -m pip install 'html-golive[mysql]==0.9.7'
golive skill install --target .codebuddy/skills

命令速查

发布、运行、数据、迁移与诊断,覆盖完整使用流程。

命令作用
publish扫描、套样式、内联资源并部署一个 HTML 文件
list列出所有已登记站点,含大小和 owner
rollback回滚到之前的某个快照
serve启动 HTTP 服务和管理后台
preview本地预览一个文件,不登记站点
clone抓取一个公开页面并重新发布
maintainer给某个站点授予或撤销编辑权限
admin打开管理后台
styles列出 19 套内置视觉样式
data / db查看和管理数据后端
migrate-check找出 HTML 里跟特定环境绑死的引用
verify真实 HTTP、页面注入与数据库读写自检
export / import / migrate备份恢复与后端迁移
skill安装并检查 AgentSkill 版本
doctor诊断配置和连通性

试一下

MIT 协议。四后端真实数据库验收,Linux / macOS 与 Python 3.9 / 3.11 / 3.12 CI。 欢迎提 issue 和 PR。