lovasoa/sqlpage

SQLPage Docker镜像文档

镜像概述

SQLPage是一个开源的低代码Web应用服务器，允许用户完全使用SQL构建Web应用。通过编写简单的SQL查询与数据交互，即可快速创建功能丰富的网站，无需复杂的前端开发知识。

核心功能与特性

• SQL驱动开发：仅使用SQL查询即可构建包含表单、列表、表格、地图等元素的动态Web应用
• 多数据库支持：兼容SQLite、PostgreSQL、MySQL及Microsoft SQL Server
• 丰富组件库：内置大量预构建Web组件，加速开发流程
• 高度可定制：支持通过HTML、CSS和JavaScript进行自定义扩展
• 高性能与安全：页面加载迅速，内置SQL注入(SQLi)和跨站脚本(XSS)***防护机制

快速开始

基本运行命令

使用以下Docker命令启动SQLPage容器：

bash
docker run -it --name sqlpage -p 8080:8080 --volume "$(pwd):/var/www" --rm docker.xuanyuan.run/lovasoa/sqlpage

该命令将启动最新稳定版SQLPage容器，通过--volume参数将主机当前工作目录挂载到容器内的/var/www目录（用于存储SQL文件）。启动后，可通过浏览器访问http://localhost:8080查看应用。

挂载点说明

SQLPage使用以下关键挂载点：

• /var/www：存储SQL应用文件的目录，SQLPage将从该目录加载并执行SQL查询
• /etc/sqlpage：配置文件目录，包含sqlpage.json配置文件和templates/*.handlebars自定义组件模板

配置说明

环境变量

SQLPage可通过环境变量进行配置，主要参数包括：

• DATABASE_URL：数据库连接URL（例如：postgres://user:pass@host/db?options）
• LISTEN_ON：服务监听的IP和端口（默认值：0.0.0.0:8080）
• SQLPAGE_ENVIRONMENT：运行环境，可选值为production（生产环境）或development（开发环境）

镜像标签

SQLPage Docker镜像提供以下标签：

• latest：最新稳定版本
• main：开发版本，反映GitHub主分支的当前开发状态
• v*：特定版本标签（如v0.20.5），遵循语义化版本控制

使用方法

基本使用流程

1. 在/var/www目录中创建SQL文件
2. 在SQL文件中编写查询语句
3. SQLPage执行查询并将结果渲染为网页

使用示例

创建/var/www/index.sql文件，内容如下：

sql
SELECT 'list' as component;
SELECT product_name as title, description FROM my_products;

上述SQL代码将使用list组件渲染my_products数据库表中的内容，其中product_name字段作为标题，description字段作为描述。

示例项目

SQLPage提供多个示例项目帮助快速上手，可参考https://github.com/lovasoa/SQLpage/tree/main/examples%E3%80%82

支持与反馈

SQLPage是开源项目，欢迎贡献代码和反馈。如遇问题：

• 在GitHub上https://github.com/lovasoa/SQLpage/issues
• 参与https://github.com/lovasoa/SQLpage/discussions

许可证

SQLPage采用MIT许可证，详情参见https://github.com/lovasoa/SQLpage/blob/main/LICENSE.txt%E3%80%82