SQLite-Web Docker镜像文档

镜像概述

该Docker镜像用于运行基于Web的SQLite数据库浏览器，提供直观的Web界面以查看、管理SQLite数据库文件，无需本地安装依赖，实现快速部署和使用。

• 源码（GitHub）
• Dockerfile（GitHub）

核心功能与特性

• 提供Web界面浏览和管理SQLite数据库，支持表结构查看、数据查询等操作
• 容器化部署，避免本地环境依赖冲突
• 通过环境变量灵活配置目标数据库文件
• 轻量级设计，启动快速，资源占用低

使用场景

• 开发环境中快速查看和调试SQLite数据库文件
• 无需安装桌面工具，通过浏览器便捷访问本地数据库
• 临时查看SQLite数据库内容，如配置文件、应用数据等

使用方法

基本部署（docker run命令）

通过以下命令启动容器，需挂载本地数据库目录并指定数据库文件名：

docker run -it --rm \
    -p 8080:8080 \
    -v /path/containing/database:/data \
    -e SQLITE_DATABASE="db_filename.db" \
    coleifer/sqlite-web

参数说明：

• -p 8080:8080：将容器内8080端口映射到主机8080端口，用于Web访问
• -v /path/containing/database:/data：将本地包含数据库文件的目录挂载到容器/data目录，确保容器可访问数据库文件
• -e SQLITE_DATABASE="db_filename.db"：环境变量指定要打开的SQLite数据库文件名（需位于挂载的/data目录下）

启动后，通过http://localhost:8080访问Web管理界面。

辅助脚本（简化部署）

为简化使用流程，可使用以下bash脚本，自动解析数据库路径并配置容器参数：

#!/bin/bash

if [ $# -eq 0 ]; then
  echo "缺少必填参数：数据库名称。"
  exit 1
fi

default_port="8012"
port=${2:-$default_port}

db=$(realpath $1)
db_dir=$(dirname $db)
db_file=$(basename $db)
echo "启动地址：[***]"
docker run -it --rm -p "$port:8080" -v $db_dir:/data -e SQLITE_DATABASE="$db_file" coleifer/sqlite-web

脚本使用说明

1. 将上述脚本保存为sqlite-web.sh
2. 添加执行权限：chmod +x sqlite-web.sh
3. 运行脚本，格式为：./sqlite-web.sh <数据库文件路径> [端口号]（端口号可选，默认8012）

示例：

# 使用默认端口（8012）启动
./sqlite-web.sh /path/to/your/database.db

# 指定端口（如8088）启动
./sqlite-web.sh /path/to/your/database.db 8088

脚本将自动挂载数据库目录、配置端口映射，并输出访问地址，简化手动配置步骤。