apecloud/wesql-server Docker 镜像 - 轩辕镜像

WeSQL Docker镜像文档

镜像概述与主要用途

WeSQL是一款采用云原生架构的MySQL数据库，基于计算-存储分离设计，将所有数据（包括binlog、 schema、存储引擎元数据、WAL及数据文件）完全存储于S3及S3兼容对象存储中。它提供跨可用区零数据丢失的灾难恢复能力，成本接近单个MySQL副本，同时支持BYOC（Bring Your Own Cloud）部署模式，避免厂商锁定。

WeSQL使用未修改的MySQL Server代码库，确保完全兼容MySQL生态，可无缝集成现有MySQL工具和应用。其核心价值在于提供易部署、可扩展、成本效益高且开发者友好的Serverless MySQL解决方案，适用于需要在自有VPC中快速部署云原生数据库的场景。

核心功能与特性

1. MySQL完全兼容性

基于未修改的MySQL Server代码构建，确保与MySQL功能、工具和应用的完全兼容，可快速同步MySQL新版本特性及 bug 修复，无需修改现有应用即可迁移。

2. Serverless与按需付费

采用计算-存储分离架构，计算节点支持自动扩缩容与自动暂停，闲置时可完全关闭以节省成本；使用S3作为存储层，按实际使用量计费，无需预配置存储容量，显著降低存储成本。

3. 可扩展存储与高效压缩

依托S3无容量限制特性，支持PB级数据存储，无需横向扩展MySQL实例；提供列存表格式，指定表可采用列存储，压缩率较行存储提升高达10倍，适合存储历史数据、归档记录等大型数据集。

4. 跨可用区灾难恢复

所有状态数据（schema、元数据等）均持久化至S3，确保跨可用区数据可靠性；最近生成的binlog（小于1秒）通过Raft协议同步至Logger节点保障 durability，异步批量刷新至S3；AZ故障时，仅需在其他AZ启动新容器，连接S3即可恢复服务，零数据丢失。

5. 低运维负担

节点可随时关闭并释放计算资源（如EBS卷），重启时从S3自动加载数据恢复服务；无需预部署专用存储服务，简化部署流程；数据天然持久化于S3，备份恢复流程简化，也可结合AWS Backup增强冗余。

6. 开发者友好特性

• Online DDL：支持无锁表结构变更，避免业务停机
• Branching：创建数据库隔离副本用于测试/开发，通过Prepare、Start、Stop命令轻松管理数据复制与同步
• Filters：定义SQL查询规则，支持FAIL、CONTINUE等动作及并发控制，实现细粒度查询管理

使用场景与适用范围

WeSQL适用于以下场景：

• 需要Serverless架构、按使用付费的MySQL用户
• 追求跨可用区高可用且零数据丢失的业务
• 希望避免云厂商锁定，需在多云或自有VPC部署数据库的组织
• 处理大规模数据（如历史归档、日志存储）并关注存储成本的场景
• 开发/测试环境需要快速启停、动态扩缩容的团队
• 需简化数据库运维（备份、恢复、灾备）的DevOps流程

使用方法与配置说明

环境变量配置

WeSQL容器通过环境变量进行配置，以下为核心环境变量说明：

通用环境变量

对象存储环境变量

用于配置S3及兼容存储连接信息，若与MYSQL_CUSTOM_CONFIG中参数冲突，环境变量优先级更高：

Docker部署示例

基本启动命令

bash
docker run -d \
  --name wesql-node \
  -p 3306:3306 \
  -e WESQL_CLUSTER_MEMBER_UUID="node1-uuid" \
  -e WESQL_OBJECTSTORE_ACCESS_KEY="your-s3-ak" \
  -e WESQL_OBJECTSTORE_SECRET_KEY="your-s3-sk" \
  -e WESQL_OBJECTSTORE_PROVIDER="s3" \
  -e WESQL_OBJECTSTORE_REGION="us-west-2" \
  -e WESQL_OBJECTSTORE_ENDPOINT="[***]" \
  -e WESQL_OBJECTSTORE_BUCKET="wesql-data-bucket" \
  -e MYSQL_ROOT_PASSWORD="SecureRootPass123" \
  wesql/wesql:latest

多节点集群部署（最小3节点，满足Raft协议）

bash
# 节点1（数据节点）
docker run -d \
  --name wesql-node1 \
  -p 3306:3306 \
  -e WESQL_CLUSTER_MEMBER_UUID="node1-uuid" \
  -e WESQL_CLUSTER_MEMBER="node1-ip:4444,node2-ip:4444,node3-ip:4444" \
  -e WESQL_OBJECTSTORE_ACCESS_KEY="your-s3-ak" \
  -e WESQL_OBJECTSTORE_SECRET_KEY="your-s3-sk" \
  -e WESQL_OBJECTSTORE_BUCKET="wesql-data-bucket" \
  -e MYSQL_ROOT_PASSWORD="SecureRootPass123" \
  wesql/wesql:latest

# 节点2（数据节点）
docker run -d \
  --name wesql-node2 \
  -p 3306:3306 \
  -e WESQL_CLUSTER_MEMBER_UUID="node2-uuid" \
  -e WESQL_CLUSTER_MEMBER="node1-ip:4444,node2-ip:4444,node3-ip:4444" \
  -e WESQL_OBJECTSTORE_ACCESS_KEY="your-s3-ak" \
  -e WESQL_OBJECTSTORE_SECRET_KEY="your-s3-sk" \
  -e WESQL_OBJECTSTORE_BUCKET="wesql-data-bucket" \
  -e MYSQL_ROOT_PASSWORD="SecureRootPass123" \
  wesql/wesql:latest

# 节点3（Logger节点）
docker run -d \
  --name wesql-logger \
  -e WESQL_CLUSTER_MEMBER_UUID="logger-uuid" \
  -e WESQL_CLUSTER_MEMBER="node1-ip:4444,node2-ip:4444,node3-ip:4444" \
  -e WESQL_LOGGER_MODE=1 \
  -e WESQL_OBJECTSTORE_ACCESS_KEY="your-s3-ak" \
  -e WESQL_OBJECTSTORE_SECRET_KEY="your-s3-sk" \
  -e WESQL_OBJECTSTORE_BUCKET="wesql-data-bucket" \
  wesql/wesql:latest

相关文档

更多详细配置与使用说明，请参考WeSQL官方文档。