环境准备
-
系统要求
- 支持主流Linux发行版(Ubuntu/CentOS/RHEL等)
- 确保已安装Java 8或11(Terracotta核心依赖):
sudo apt update && sudo apt install openjdk-11-jdk # Ubuntu/Debian sudo yum install java-11-openjdk-devel # CentOS/RHEL
- 验证Java安装:
java -version
-
创建专用用户(安全建议)
sudo useradd -m -s /bin/bash terracotta sudo passwd terracotta
下载与安装
-
获取安装包
访问Terracotta官方仓库下载最新版(例:terracotta-5.8.0.tar.gz
):wget https://github.com/Terracotta-OSS/terracotta-platform/releases/download/v5.8.0/terracotta-5.8.0.tar.gz
-
解压并安装
sudo tar -xzvf terracotta-5.8.0.tar.gz -C /opt sudo mv /opt/terracotta-5.8.0 /opt/terracotta sudo chown -R terracotta:terracotta /opt/terracotta
配置Terracotta集群
-
生成配置文件
编辑集群配置(按需替换<NODE_NAME>
和<HOST_IP>
):sudo -u terracotta vim /opt/terracotta/conf/tc-config.xml
<?xml version="1.0" encoding="UTF-8"?> <tc:tc-config xmlns:tc="http://www.terracotta.org/config"> <servers> <server name="<NODE_NAME>" host="<HOST_IP>"> <data>/opt/terracotta/data</data> <logs>/opt/terracotta/logs</logs> <port>9510</port> <!-- 客户端通信端口 --> </server> </servers> </tc:tc-config>
-
配置环境变量
添加至用户环境(~/.bashrc
):echo 'export TC_HOME=/opt/terracotta' >> ~/.bashrc echo 'export PATH=$PATH:$TC_HOME/server/bin' >> ~/.bashrc source ~/.bashrc
启动与验证
-
启动Terracotta服务器
sudo -u terracotta /opt/terracotta/server/bin/start-tc-server.sh -f /opt/terracotta/conf/tc-config.xml
-
检查运行状态
- 查看日志:
tail -f /opt/terracotta/logs/terracotta-server.log
- 验证进程:
ps aux | grep terracotta
- 查看日志:
-
客户端连接测试
使用telnet
验证端口(需先安装telnet
):telnet localhost 9510
若显示
Terracotta Server
即表示成功。
系统服务配置(可选)
创建Systemd服务实现开机自启:
sudo vim /etc/systemd/system/terracotta.service
[Unit] Description=Terracotta Server After=network.target [Service] User=terracotta WorkingDirectory=/opt/terracotta ExecStart=/opt/terracotta/server/bin/start-tc-server.sh -f /opt/terracotta/conf/tc-config.xml Restart=on-failure [Install] WantedBy=multi-user.target
启用服务:
sudo systemctl daemon-reload sudo systemctl start terracotta sudo systemctl enable terracotta
常见问题解决
- 端口冲突:修改
tc-config.xml
中的<port>
值。 - Java版本不兼容:通过
update-alternatives --config java
切换版本。 - 权限错误:确保
/opt/terracotta
目录属主为terracotta
用户。 - 集群配置:多节点部署需在
<servers>
下添加多个<server>
节点并同步配置。
安全建议
- 使用防火墙限制访问IP:
sudo ufw allow from 192.168.1.0/24 to any port 9510
- 定期备份
/opt/terracotta/data
目录。 - 生产环境建议启用TLS加密(参考官方安全文档)。
引用说明
- Terracotta官方文档:https://terracotta.org/documentation/
- GitHub仓库:https://github.com/Terracotta-OSS/terracotta-platform
- Java安装指南:https://openjdk.org/install/
基于Terracotta 5.8版本编写,适用于大多数Linux环境,具体操作请以实际版本为准。*
原创文章,发布者:酷番叔,转转请注明出处:https://cloud.kd.cn/ask/8574.html