前两天有个读者在后台问我，说公司准备上 Cassandra，但团队里没人搞过这个，想了解安装到底难不难。我直接回了一句：装 Cassandra 比装 MySQL 还简单，但真正难的是配置和调优。今天我就把安装这关讲透，保证你照着做一遍就能跑起来。
先说说准备工作。Cassandra 是个 Java 程序，所以 JDK 是必须的。很多人栽在第一关，就是 JDK 版本选错了。目前 Cassandra 4.0 以上版本要求 JDK 8 或 JDK 11，千万别用 JDK 17。我亲眼见过有人图新鲜装了最新版，结果启动报错，折腾了三天。去 Oracle 官网或者直接用 OpenJDK 都行，装完记得设置 JAVAHOME 环境变量。测试方法很简单，在终端敲 ，能看到版本信息就算通过。另外建议使用 Linux 系统，CentOS 7 或 Ubuntu 20.04 都可以。Windows 虽然也能装，但生产环境里真的会用 Windows 跑数据库吗？别给自己找麻烦。
接下来正式下载安装。打开 Apache Cassandra 官网，找到下载页面，你会看到几个版本号。记住一个原则：选最新的稳定版，别碰 alpha 或 beta 版。比如现在最新稳定版是 4.1.3，就下载这个。用 wget 或 curl 都可以，我习惯用 ，支持断点续传，网络不好也不怕。下载完是个 tar.gz 压缩包，直接解压到 /opt 目录下就行。这里有个细节：别用 root 用户跑 Cassandra，安全规范要求新建一个用户，例如叫 cassandra，然后把解压目录的属主改给它。很多新手图省事直接用 root，后面权限问题会把你搞疯。
解压完后，先别急着启动，需要修改两个核心配置文件。第一个是 ，在 conf 目录下。需要改的关键参数有：，给你的集群起个名字，例如 Test Cluster；，设成服务器的内网 IP，别用 localhost，不然其他节点连不上；，同样设成内网 IP；，这是种子节点列表，单节点部署就填你自己的 IP。第二个文件是 ，主要调 JVM 堆内存。默认是 8 GB，如果你的服务器只有 4 GB 内存，必须改小，例如设成 2 GB，否则启动会 OOM。我见过太多人跳过这一步，结果 Java 进程直接被系统 kill 掉。
改完配置就可以启动了。切换到 cassandra 用户，进入 bin 目录，执行 。加了 参数会让日志打印在前台，方便观察启动过程。第一次启动会比较慢，因为要初始化数据目录和 commit log。看到 “Starting listening for CQL clients on /:9042” 这行日志，就说明成功了。这时候按 Ctrl+C 停掉，再用 后台启动。接着用 检查集群状态，如果看到 （代表 Up 和 Normal），恭喜你，Cassandra 已经在跑了。
但装完不等于能用。你还需要测试一下。用 连接，这是 Cassandra 自带的命令行工具。进去后先建个 keyspace，相当于 MySQL 里的数据库，语法是然后建表、插入几条数据，再查询看看。很多人装完后直接跳过这一步，结果上线后发现连不上，查半天才知道是防火墙没放行 9042 端口。对了，防火墙这块别忘了，CentOS 用 放行 9042 和 7000 端口，Ubuntu 用 。
说几个常见坑。第一是时间同步问题，Cassandra 对节点间的时间差很敏感，偏差超过几秒就会报错。建议装 NTP 服务，或者直接用 chrony 同步。第二是 swap 问题，Cassandra 性能要求高，最好把 swap 关掉，或者至少把 设成 0。第三是文件描述符限制，默认的 1024 根本不够，得改成 65535 以上，否则高并发时连接数会爆。这些细节看起来不起眼，但任何一个处理不好，都会让你的 Cassandra 跑得磕磕绊绊。
安装 Cassandra 这件事，说难不难，说简单也不简单。难在你要理解分布式系统的底层逻辑，比如一致性哈希、Gossip 协议、Hinted Handoff 等概念。但好消息是，安装本身是个机械活，只要按照步骤来，不出半小时就能跑起来。真正考验人的，是后续的配置优化和运维管理。建议装好后，花一周时间熟悉 和 这两个工具，弄清楚集群状态、节点负载、数据分布等信息。等你弄明白表是怎么分片的、数据是怎么复制到多个节点的，你才算真正走进了 Cassandra 的世界。
