一、SQLynx介绍

1.1 SQLynx简介

SQLynx 是一款现代化的  企业级数据库管理平台，专为开发者、DBA、数据分析师和企业团队设计，提供高效、安全、协作的数据库操作体验。它支持多种主流 SQL 数据库，采用直观的界面和强大的功能，帮助用户轻松完成数据库开发、管理、审计和协作任务。

1.2 SQLynx核心特点

1.3 SQLynx 三个版本对比

注意：
各版本具体功能以官方发布为准，功能范围及权限策略可能随版本迭代调整，建议参考 SQLynx 官方文档获取最新信息。

二、本次实践规划

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为 Ubuntu 24.04.2 LTS。

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎；
2.在Docker环境下部署SQLynx数据库管理工具。

三、本地环境检查

3.1 检查Docker服务状态

检查Docker服务是否正常运行，确保Docker正常运行。

root@jeven:~# systemctl status docker● docker.service - Docker Application Container Engine
     Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: enabled)
     Active: active (running) since Thu 2025-09-18 21:50:05 CST; 3 days ago
TriggeredBy: ● docker.socket
       Docs: https://docs.docker.com
   Main PID: 858 (dockerd)
      Tasks: 30
     Memory: 5.2G (peak: 5.4G)
        CPU: 11min 54.268s
     CGroup: /system.slice/docker.service

3.2 检查Docker版本

检查Docker版本

root@jeven:~# docker -vDocker version 28.3.3, build 980b856

3.3 检查docker compose 版本

检查Docker compose版本，确保2.0以上版本。

root@jeven:~# docker -vDocker version 28.3.3, build 980b856

四、拉取SQLynx镜像

下载SQLynx容器镜像，如下所示：

docker pull registry.cn-hangzhou.aliyuncs.com/sql_studio/sqlynx:3.7.0

五、部署SQLynx服务

5.1 创建部署目录

• 创建部署目录

mkdir -p /data/sqlynx/{data,log} &&  cd  /data/sqlynx

• 设置目录权限

chmod -R 777  /data/sqlynx

5.2 编辑部署文件

使用docker-cli方式部署，可参考以下命令：

docker run -d \
   --restart always \
   --name sqlynx \
   -p 18888:18888/tcp \
   -v /data/sqlynx/log:/apps/usr/sqlstudio/linux/log \
   -v /data/sqlynx/data:/apps/usr/sqlstudio/linux/data \
   registry.cn-hangzhou.aliyuncs.com/sql_studio/sqlynx:3.7.0

在部署目录下，创建docker-compose.yaml文件，内容如下所示：

vim docker-compose.yaml

version: '3'services:
  sqlynx:
    image: registry.cn-hangzhou.aliyuncs.com/sql_studio/sqlynx:3.7.0    container_name: sqlynx    restart: always    ports:
      - "18888:18888"
    volumes:
      - /data/sqlynx/log:/apps/usr/sqlstudio/linux/log      - /data/sqlynx/data:/apps/usr/sqlstudio/linux/data

5.3 创建SQLynx容器

执行以下命令，创建SQLynx容器。

docker compose up -d

5.4 查看SQLynx容器状态

检查SQLynx容器运行状态，确保SQLynx容器正常启动。

root@jeven:/data/sqlynx# docker compose psWARN[0000] /data/sqlynx/docker-compose.yaml: the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusion
NAME      IMAGE                                                       COMMAND                   SERVICE   CREATED         STATUS         PORTS
sqlynx    registry.cn-hangzhou.aliyuncs.com/sql_studio/sqlynx:3.7.0   "/bin/bash /apps/sql…"   sqlynx    8 minutes ago   Up 8 minutes   0.0.0.0:18888->18888/tcp, [::]:18888->18888/tcp

5.5 检查SQLynx容器日志

检查容器运行日志，确保SQLynx服务正常运行。

docker compose logs

六、访问SQLynx服务

6.1 访问SQLynx登录页

浏览器地址：  http://<个人的服务器IP>:18888，访问SQLynx首页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。

6.2 登录SQLynx

默认用户名为admin，密码自行填写，后续在系统设置中修改密码即可。

七、基本操作

7.1 添加数据源

点击数据源模块，新增数据源类型为MySQL。

填写数据库服务相关信息：包括业务系统名称、数据库地址、服务端口号、账号密码登信息。

SSH设置：当数据库位于内网环境而Web服务器具有公网IP时，可通过勾选SSH隧道选项，在SQLynx与Web服务器之间建立一条加密通信通道。该通道可将Web服务器的指定端口数据转发至目标数据库端口，从而安全地实现远程数据库访问与数据传输。

7.2 查询数据

添加数据源完成后，我们刷新数据源列表，可以看到已经成功连接上数据库，可以对数据库进行查询等操作。

7.3 运维管理

在运维管理模块中，我们看到会话管理，如下所示：

八、总结

本次实践通过Docker成功部署SQLynx，验证了其在容器化环境中的高效性与稳定性，显著简化了数据库管理工具的部署流程。借助Docker Compose实现一键式编排，配置清晰、维护便捷，有效降低了多环境部署的复杂度。SQLynx的Web界面提供直观的多数据库管理能力，支持MySQL、PostgreSQL等主流数据库，操作流畅且功能完备。该方案不仅适用于开发测试场景，更能满足企业级数据治理对安全、协同与高可用性的严苛要求，具备显著的实用价值与推广潜力。