PostgreSQL

Web.Casa 通过 Docker 容器提供 PostgreSQL 的完整生命周期管理。从创建实例到配置调优，均可在面板中完成。

实例管理

每个 PostgreSQL 实例以独立的 Docker 容器运行。

创建实例

1. 进入 数据库 页面，点击 创建实例。
2. 选择 PostgreSQL 作为引擎。
3. 配置实例名称和超级用户密码。
4. 可选择 预设（开发环境 / 生产环境）。
5. 点击 创建 启动容器。

实例操作

操作	说明
启动	启动容器并接受连接
停止	优雅关闭实例
删除	移除容器及所有关联数据

删除实例是不可逆操作，请在删除前备份数据库。

连接信息

每个实例提供多种格式的连接信息，开箱即用：

• CLI 命令 — 可直接粘贴到终端的 psql 命令
• 连接 URI — postgresql://user:password@host:port/dbname，适用于应用配置
• 环境变量 — DATABASE_URL=...，适用于 .env 文件
• Docker 内部地址 — 用于同一 Docker 网络内的服务互联

数据库操作

创建数据库

1. 打开 PostgreSQL 实例。
2. 进入 数据库 选项卡，点击 创建数据库。
3. 输入数据库名称。
4. 根据需要配置 字符集 选项。
5. 点击 创建。

删除数据库

在列表中选择目标数据库，点击 删除，在弹窗中确认操作。

删除数据库会永久移除其中所有 Schema、表和数据。

用户管理

创建用户

1. 进入 用户 选项卡，点击 创建用户。
2. 设置 用户名 和 密码。
3. 点击 创建。

授权数据库访问

创建用户后，为其授予一个或多个数据库的访问权限：

1. 在列表中选择目标用户。
2. 选择要授权的数据库。
3. 点击 授权访问。

删除用户

选择用户并点击 删除，将移除该用户及其所有关联权限。

查询控制台

内置的 SQL 控制台 支持直接在浏览器中对任意 PostgreSQL 实例执行查询：

• 编写并执行 SQL 语句，结果以表格形式展示
• 通过下拉菜单切换实例和数据库
• 查看查询执行时间和返回行数

查询控制台为只读模式 — 仅允许 SELECT、SHOW、DESCRIBE 和 EXPLAIN 语句。

查询控制台适用于 Web.Casa 管理的所有 PostgreSQL 实例。

高级配置

通过 设置 选项卡调优实例性能。也可以先应用 开发环境 或 生产环境 预设作为基础。

参数	说明	默认值（开发）
Shared Buffers	用于缓存数据块的内存	64 MB
Work Mem	每个查询操作（排序、哈希）的内存	2 MB
Effective Cache Size	规划器对可用操作系统磁盘缓存的估算	192 MB
WAL 级别	预写日志详细程度（minimal、replica、logical）	replica
慢查询阈值	记录超过此时长的查询	2000 ms

生产环境预设 会增大共享缓冲区、工作内存和有效缓存大小，以提高并发场景下的吞吐量。开发环境预设 使用较低的资源限制，适合本地开发。

SQLite 浏览器

除 PostgreSQL 实例外，Web.Casa 还内置了 SQLite 浏览器，用于查看本地 .sqlite / .db 文件：

• 打开 面板数据目录内的 SQLite 文件（仅限 .db、.sqlite、.sqlite3 扩展名）
• 以 只读模式 浏览 表和数据
• 查看 表结构定义（表、列、索引）

SQLite 浏览器为只读模式，不会修改原始文件。