
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
DB Browser for SQLite 是一个高质量的可视化开源工具,用于创建、设计和编辑与SQLite兼容的数据库文件。本镜像由LinuxServer.io团队提供,具备定期应用更新、简单用户映射(PGID、PUID)、自定义基础镜像及每周系统更新等特性。
!https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/sqlitebrowser-banner.png
该镜像利用Docker manifest实现多平台支持,拉取 lscr.io/linuxserver/sqlitebrowser:latest 即可自动获取对应架构的镜像,也可通过标签指定特定架构:
| 架构 | 支持情况 | 标签 |
|---|---|---|
| x86-64 | ✅ | amd64-<版本标签> |
| arm64 | ✅ | arm64v8-<版本标签> |
| armhf | ❌ |
应用可通过以下地址访问:
本容器基于 https://github.com/linuxserver/docker-baseimage-kasmvnc%EF%BC%8C%E6%94%AF%E6%8C%81%E4%BB%A5%E4%B8%8B%E9%A2%9D%E5%A4%96%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E5%92%8C%E8%BF%90%E8%A1%8C%E9%85%8D%E7%BD%AE%EF%BC%9A
可选环境变量
| 变量 | 描述 |
|---|---|
| CUSTOM_PORT | 容器内部HTTP监听端口,默认3000,如需修改可指定 |
| CUSTOM_HTTPS_PORT | 容器内部HTTPS监听端口,默认3001,如需修改可指定 |
| CUSTOM_USER | HTTP基本认证用户名,默认"abc" |
| PASSWORD | HTTP基本认证密码,默认"abc";若不设置则无需认证 |
| SUBFOLDER | 反向代理子目录,需包含首尾斜杠,如"/subfolder/" |
| TITLE | 网页标题,默认"KasmVNC Client" |
| FM_HOME | 文件管理器起始目录,默认"/config" |
| START_DOCKER | 设为"false"时,特权容器不会自动启动DinD Docker环境 |
| DRINODE | 挂载/dev/dri实现https://www.kasmweb.com/kasmvnc/docs/master/gpu_acceleration.html%E6%97%B6%EF%BC%8C%E6%8C%87%E5%AE%9A%E8%AE%BE%E5%A4%87%E8%B7%AF%E5%BE%84%EF%BC%8C%E5%A6%82%22/dev/dri/renderD128" |
可选运行配置
| 配置 | 描述 |
|---|---|
--privileged | 启动Docker-in-Docker(DinD)环境,可挂载主机Docker目录(如-v /home/user/docker-data:/var/lib/docker)提升性能 |
-v /var/run/docker.sock:/var/run/docker.sock | 挂载主机Docker socket,用于通过CLI交互或运行Docker应用 |
--device /dev/dri:/dev/dri | 挂载GPU设备,结合DRINODE环境变量可利用主机显卡实现GPU加速(仅支持开源驱动:Intel、AMDGPU、Radeon、ATI、Nouveau) |
通过将"Stream Quality"预设改为"Lossless",容器可向浏览器传输真无损图像(高帧率),详情见https://www.kasmweb.com/docs/latest/how_to/lossless.html#technical-background%E3%80%82%E9%9D%9E%E6%9C%AC%E5%9C%B0%E8%AE%BF%E9%97%AE%E9%9C%80%E4%BD%BF%E7%94%A83001 HTTPS端口;若通过反向代理访问3000端口,需配置特定 headers,详见https://github.com/linuxserver/docker-baseimage-kasmvnc#lossless%E3%80%82
可通过docker-compose或docker cli创建容器:
yaml--- version: "2.1" services: sqlitebrowser: image: docker.xuanyuan.run/linuxserver/sqlitebrowser:latest container_name: sqlitebrowser security_opt: - seccomp:unconfined #可选 environment: - PUID=1000 - PGID=1000 - TZ=Etc/UTC volumes: - /path/to/config:/config ports: - 3000:3000 - 3001:3001 restart: unless-stopped
bashdocker run -d \ --name=sqlitebrowser \ --security-opt seccomp=unconfined `#可选` \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Etc/UTC \ -p 3000:3000 \ -p 3001:3001 \ -v /path/to/config:/config \ --restart unless-stopped \ lscr.io/linuxserver/sqlitebrowser:latest
运行时参数格式为<外部>:<内部>,例如-p 8080:80表示将容器内80端口映射到主机8080端口。
| 参数 | 功能 |
|---|---|
-p 3000 | SQLiteBrowser桌面GUI的HTTP端口 |
-p 3001 | SQLiteBrowser桌面GUI的HTTPS端口 |
-e PUID=1000 | 用户ID,详见下方说明 |
-e PGID=1000 | 组ID,详见下方说明 |
-e TZ=Etc/UTC | 时区设置,参考时区列表 |
-v /config | 容器内用户主目录,存储程序设置和可能的数据库文件 |
--security-opt seccomp=unconfined | 仅Docker Engine需要,许多现代GUI应用在旧主机上运行时需此配置 |
可通过FILE__前缀从文件读取环境变量,例如:
bash-e FILE__MYVAR=/run/secrets/mysecretvariable
将根据/run/secrets/mysecretvariable文件内容设置MYVAR变量。
所有镜像支持通过-e UMASK=022覆盖默认umask设置。注意umask是权限减法而非加法,详见说明。
使用卷(-v)时,主机与容器可能存在权限问题。通过指定PUID(用户ID)和PGID(组ID)可避免此问题。确保主机卷目录所有者与指定ID一致。
获取当前用户的ID:
bashid your_user
示例输出:
textuid=1000(your_user) gid=1000(your_user) groups=1000(your_user)
https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=sqlitebrowser&query=%24.mods%5B%27sqlitebrowser%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml](https://mods.linuxserver.io/?mod=sqlitebrowser "查看此容器可用的mods") https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=universal&query=%24.mods%5B%27universal%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml](https://mods.linuxserver.io/?mod=universal "查看通用mods")
LinuxServer.io提供多种https://github.com/linuxserver/docker-mods%E4%BB%A5%E6%89%A9%E5%B1%95%E5%AE%B9%E5%99%A8%E5%8A%9F%E8%83%BD%EF%BC%8C%E4%B8%8A%E8%BF%B0%E5%BE%BD%E7%AB%A0%E9%93%BE%E6%8E%A5%E5%8F%AF%E6%9F%A5%E7%9C%8B%E6%9C%AC%E9%95%9C%E5%83%8F%E5%8F%8A%E9%80%9A%E7%94%A8mods%E3%80%82
容器运行时进入shell:
bashdocker exec -it sqlitebrowser /bin/bash
实时查看容器日志:
bashdocker logs -f sqlitebrowser
查看容器版本:
bashdocker inspect -f '{{ index .Config.Labels "build_version" }}' sqlitebrowser
查看镜像版本:
bashdocker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/sqlitebrowser:latest
多数镜像为静态版本,需更新镜像并重建容器以升级应用(部分例外如nextcloud、plex)。以下是更新容器的方法:
更新镜像:
bashdocker-compose pull
bashdocker-compose pull sqlitebrowser
更新容器:
bashdocker-compose up -d
bashdocker-compose up -d sqlitebrowser
清理旧镜像:
bashdocker image prune
更新镜像:
bashdocker pull docker.xuanyuan.run/linuxserver/sqlitebrowser:latest
停止运行中的容器:
bashdocker stop sqlitebrowser
删除容器:
bashdocker rm sqlitebrowser
使用相同参数重建容器(卷映射正确的话,/config目录及设置会保留)
清理旧镜像:
bashdocker image prune
bashdocker run --rm \ -v /var/run/docker.sock:/var/run/docker.sock \ docker.xuanyuan.run/containrrr/watchtower \ --run-once sqlitebrowser
清理旧镜像:docker image prune
警告:不建议使用Watchtower作为自动更新容器的方案,长期推荐使用https://docs.linuxserver.io/general/docker-compose%E3%80%82
提示:推荐使用https://crazymax.dev/diun/%E6%8E%A5%E6%94%B6%E6%9B%B4%E6%96%B0%E9%80%9A%E7%9F%A5%E3%80%82%E4%B8%8D%E5%BB%BA%E8%AE%AE%E4%BD%BF%E7%94%A8%E8%87%AA%E5%8A%A8%E6%9B%B4%E6%96%B0%E5%AE%B9%E5%99%A8%E7%9A%84%E5%B7%A5%E5%85%B7%E3%80%82
如需本地修改或自定义镜像:
bashgit clone https://github.com/linuxserver/docker-sqlitebrowser.git cd docker-sqlitebrowser docker build \ --no-cache \ --pull \ -t lscr.io/linuxserver/sqlitebrowser:latest .
在x86_64硬件上构建ARM变体,需使用multiarch/qemu-user-static:
bashdocker run --rm --privileged docker.xuanyuan.run/multiarch/qemu-user-static:register --reset
然后使用-f Dockerfile.aarch64指定架构Dockerfile。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务