CryptDB 项目使用教程

1. 项目目录结构及介绍

CryptDB 项目的目录结构如下：

cryptdb/
├── bins/
├── conf/
├── crypto/
├── doc/
├── eval/
├── logs/
├── main/
├── mysqlproxy/
├── parser/
├── scripts/
├── test/
├── tools/
├── udf/
├── util/
├── CryptDBdoxgen
├── GNUmakefile
├── LICENSE
├── README.md
├── demoqueries
├── mergedep.pl
├── negatives_status.txt
└── supps

目录介绍

• bins/: 包含项目的二进制文件。
• conf/: 配置文件目录。
• crypto/: 加密相关的代码和工具。
• doc/: 项目文档。
• eval/: 评估和测试相关的代码。
• logs/: 日志文件目录。
• main/: 项目的主程序代码。
• mysqlproxy/: MySQL 代理相关的代码。
• parser/: SQL 解析器代码。
• scripts/: 安装和配置脚本。
• test/: 测试代码和测试用例。
• tools/: 项目工具。
• udf/: 用户定义函数（UDF）代码。
• util/: 实用工具和辅助代码。
• CryptDBdoxgen: 文档生成工具。
• GNUmakefile: Makefile 文件。
• LICENSE: 项目许可证。
• README.md: 项目介绍和使用说明。
• demoqueries: 示例查询文件。
• mergedep.pl: 依赖合并脚本。
• negatives_status.txt: 状态文件。
• supps: 支持文件。

2. 项目启动文件介绍

启动 CryptDB 的 Shell 模式

在 Shell 模式下启动 CryptDB 的命令如下：

obj/main/cdb_test /shadow <some-database-name>

启动 CryptDB 的 Proxy 模式

在 Proxy 模式下启动 CryptDB 的命令如下：

/path/to/cryptdb/bins/proxy-bin/bin/mysql-proxy \
  --plugins=proxy \
  --event-threads=4 \
  --max-open-files=1024 \
  --proxy-lua-script=$EDBDIR/mysqlproxy/wrapper.lua \
  --proxy-address=127.0.0.1:3307 \
  --proxy-backend-addresses=localhost:3306

连接到 CryptDB

连接到 CryptDB 的命令如下：

mysql -u root -pletmein -h 127.0.0.1 -P 3307

3. 项目的配置文件介绍

配置文件路径

CryptDB 的配置文件主要位于 conf/ 目录下。

主要配置文件

• conf/config.ini: 包含 CryptDB 的主要配置选项，如数据库连接信息、加密设置等。
• conf/mysqlproxy.conf: MySQL 代理的配置文件，包含代理的监听地址、后端数据库地址等。

配置示例

[database]
host = localhost
port = 3306
user = root
password = letmein

[encryption]
enable = true
key_path = /path/to/encryption/key

通过以上配置文件，可以灵活地调整 CryptDB 的行为和加密设置。