SQLPage

产品介绍

SQLPage 是一个使用 Rust 编写的 SQL 驱动动态网站构建器。页面由 .sql 文件定义，查询结果会被渲染为表单、列表、图表等界面组件。默认包使用单容器 SQLite 拓扑，不依赖外部数据库。

主要功能

使用 SQL 文件构建表单、列表、图表和动态页面
默认使用 SQLite，也支持 PostgreSQL、MySQL、SQL Server 和 ODBC 数据源
支持迁移、文件上传、自定义组件和可选 OIDC 认证
提供官方 Todo 示例用于验证完整的写入和读取流程

默认示例

安装时会在空的数据目录中写入 SQLPage 官方 Todo 示例。可通过网页新增、编辑和删除待办事项，数据保存在 SQLite 数据库中。初始化只补充缺失的示例文件，不会覆盖已有文件。

访问说明

默认通过 127.0.0.1:8080 发布，适合经 1Panel HTTPS 反向代理访问。
Todo 示例没有身份认证。公开访问前应替换示例、配置 OIDC 或应用级授权，并在反向代理层设置访问控制和请求速率限制。
sqlpage.exec、危险 Markdown HTML 和危险 URL 协议默认禁用。
容器以 UID/GID 1000:1000 运行，使用只读根文件系统、受限临时目录，并丢弃全部 Linux capabilities。

数据与定制

APP_DATA_DIR 映射到 /var/www，保存 SQL 页面文件和 sqlpage.db。
包内 /etc/sqlpage 配置以只读方式挂载，使用 sqlite:///var/www/sqlpage.db?mode=rwc。
修改数据目录中的 .sql 文件即可定制站点。升级前应备份整个数据目录。
如选择既有绝对数据目录，请先将其所有权设置为 1000:1000。

Introduction

SQLPage is a Rust-based dynamic website builder driven by SQL. Pages are defined as .sql files, and query results render as forms, lists, charts, and other interface components. The default package uses a single-container SQLite topology with no external database.

Features

Build forms, lists, charts, and dynamic pages from SQL files
Use SQLite by default, with optional PostgreSQL, MySQL, SQL Server, and ODBC data sources
Support migrations, file uploads, custom components, and optional OIDC authentication
Start with the official Todo example for a complete write and read workflow

Usage And Security

A clean install seeds SQLPage's official Todo example without overwriting existing files.
The starter is unauthenticated. Replace it or configure OIDC or application-level authorization before public exposure, and enforce access control and rate limits at the reverse proxy.
The default bind address is 127.0.0.1, intended for publication through a 1Panel HTTPS reverse proxy.
Dangerous execution and Markdown options remain disabled by default.

Persistence

APP_DATA_DIR is mounted at /var/www and stores the SQL pages plus sqlpage.db.
The container runs as UID/GID 1000:1000 with a read-only root filesystem, a constrained temporary directory, and all Linux capabilities dropped.
Back up the complete data directory before upgrades or migration.

References

Project: https://github.com/sqlpage/SQLPage
Stable release: https://github.com/sqlpage/SQLPage/releases/tag/v0.45.0
Docker documentation: https://github.com/sqlpage/SQLPage#with-docker
Configuration: https://github.com/sqlpage/SQLPage/blob/v0.45.0/configuration.md
Starter source: https://github.com/sqlpage/SQLPage/tree/v0.45.0/examples/todo%20application
License: https://github.com/sqlpage/SQLPage/blob/v0.45.0/LICENSE.txt (MIT)